Yahoo Finance MCP Server

What is Yahoo Finance MCP Server?

A Model Context Protocol (MCP) server that gives AI assistants access to Yahoo Finance data via the yfinance library. It provides stock information, financial news, sector rankings, historical price data, professional financial charts, options chains, and ownership data—all from within an AI chat.

How to use Yahoo Finance MCP Server?

Install uv, then add the following mcpServers entry to your MCP client configuration: {"command": "uvx", "args": ["yfmcp"]}. The server exposes tools such as yfinance_get_ticker_info, yfinance_get_ticker_news, yfinance_search, yfinance_get_top, yfinance_screen, yfinance_screen_gappers, yfinance_get_price_history, yfinance_get_financials, yfinance_get_holders, yfinance_get_option_dates, and yfinance_get_option_chain.

Key features of Yahoo Finance MCP Server

• Stock data: company info, financials, valuation, dividends, trading metrics
• Financial statements: income statement, balance sheet, cash flow (annual, quarterly, TTM)
• Financial news: recent articles and press releases for any ticker
• Search: find stocks, ETFs, and news across Yahoo Finance
• Sector rankings: top ETFs, mutual funds, companies, growth leaders, top performers
• Price history: OHLCV data as markdown tables or candlestick/VWAP/volume profile charts (WebP)
• Options data: chains with calls, puts, strike prices, implied volatility, expiration dates
• Ownership data: major holders, institutional and mutual fund holders, insider transactions

Use cases of Yahoo Finance MCP Server

• Ask an AI assistant for real-time stock quotes, financial overviews, and valuation ratios
• Generate technical analysis charts (candlestick, VWAP, volume profile) for any ticker
• Screen for bullish gappers, top sector performers, or custom equity/fund criteria
• Retrieve recent news, options chains, and insider trading activity during a conversation
• Analyze historical financial statements (EBIT, invested capital, free cash flow) without leaving the chat

FAQ from Yahoo Finance MCP Server

What data does Yahoo Finance MCP Server provide?

It provides stock info, financial statements, news, search results, sector rankings, OHLCV price history, candlestick/VWAP/volume profile charts, options chains, and ownership data (major holders, institutional holders, mutual fund holders, insider transactions).

What are the runtime requirements?

Python 3.8+ and the uv package manager (or pip). No API key or authentication is needed—data is fetched from Yahoo Finance via the yfinance library.

How do I configure the server?

Add the following to your MCP client configuration: "mcpServers": { "yfmcp": { "command": "uvx", "args": ["yfmcp"] } }. Then restart your client.

Are there any limits on data retrieval?

Yes. For holders, the default maximum rows returned per section is 10 (use max_rows: 0 for full data). For screeners and the yfinance_get_top tool, the maximum number of results is 250 and 100 respectively.