Best for
- Users who need Yahoo Finance data in AI conversations
- Analysts and developers researching stocks, funds, and ETFs
- MCP client users who need structured financial data and charts
Y
66FMRS · C
Based on the repository README and server.json, this is an MIT-licensed stdio MCP server at version 0.14.0, distributed as the PyPI package yfmcp, covering Yahoo Finance stock, fund, news, screener, financial, options, and chart data. The supplied source does not establish that it is maintained by Yahoo.
Yahoo Finance MCP Server gives AI assistants access to Yahoo Finance data through yfinance, including stock information, analyst data, financial statements, news, search, sector rankings, screeners, price history, charts, options, ownership, and fund data. It runs over stdio and can be installed with uvx, Docker, or from source.
Tools
yfinance_get_ticker_info
Retrieve company information, financial data, trading metrics, valuation, dividends, and governance data.
yfinance_get_analyst_price_targets
Retrieve the current price and analyst consensus price targets.
yfinance_get_analyst_estimates
Retrieve analyst estimates, revision trends, recommendations, growth estimates, and earnings history.
yfinance_get_upgrades_downgrades
Retrieve analyst rating actions, price-target changes, initiations, and reiterations.
yfinance_get_ticker_news
Retrieve recent news articles and press releases for a ticker.
yfinance_search
Search Yahoo Finance for stocks, ETFs, and news.
yfinance_get_top
Retrieve top-ranked ETFs, mutual funds, or companies within a sector.
yfinance_screen
Run predefined or custom equity, fund, and ETF screeners.
yfinance_screen_gappers
Run a custom screener for opening-session bullish gappers.
yfinance_get_price_history
Retrieve historical prices and optionally generate candlestick, VWAP, or volume-profile charts.
yfinance_get_financials
Retrieve annual, quarterly, or TTM income-statement, balance-sheet, and cash-flow data.
yfinance_get_holders
Retrieve major holders, institutional holders, mutual-fund holders, and insider data.
yfinance_get_fund_data
Retrieve ETF or mutual-fund portfolio composition, asset classes, holdings, ratings, and operating details.
yfinance_get_option_dates
Retrieve available option expiration dates for a stock.
yfinance_get_option_chain
Retrieve calls, puts, and strike-price data for available option expirations.
Setup
Install uv, then add the JSON in install_config to an MCP client configuration. Docker is also supported, or clone the repository and run uv sync; source development requires Python 3.12 or later.
claude_desktop_config.json
{"mcpServers":{"yfmcp":{"command":"uvx","args":["yfmcp@latest"]}}}
Fit and risk
Not for
- Production financial systems requiring guaranteed real-time, complete, or stable data
- Users treating market data as investment advice or a trading decision by itself
- Users requiring authentication, data sources, or client integrations not documented in the source
Required permissions
- A network connection to access Yahoo Finance data
- The source does not document a user login or API key requirement
- Docker requires a locally available Docker runtime when using the Docker method
Risks and side effects
- Yahoo Finance fields and availability may vary by symbol, fund, data version, and coverage
- Analyst, holder, and fund datasets may be incomplete or partially unavailable
- Screener results are subject to Yahoo Finance query limits, commonly up to 250 rows per request
- Financial data and charts should not be treated as investment advice
Troubleshooting
- Confirm that uv is installed and that source installation uses Python 3.12 or later
- Check the MCP client command, arguments, and JSON configuration syntax
- Verify the ticker or fund symbol and whether the requested dataset is available
- For custom screeners, check query_type, the query tree, sort field, and Yahoo row limits
- Use the YYYY-MM-DD format for option expiration_date
- Set supported max_rows values to 0 when complete tabular results are needed
Use cases
Query stock fundamentals, valuation, trading data, and dividends
Retrieve price history and generate technical-analysis charts
Search financial news, stocks, and ETFs
Screen equities, funds, ETFs, or opening-session gappers
Inspect financial statements, analyst views, ownership, and options data
Supported clients
Codex CLIPartial support