Yahoo Finance MCP server
A maintained MCP server that gives agents Yahoo Finance data — prices, fundamentals, financial statements, options, holders, and news.
Yahoo Finance MCP is an actively maintained community server that exposes comprehensive market data from Yahoo Finance to an AI agent. It covers the day-to-day questions an analyst or investor asks: pull historical OHLCV prices over a chosen period and interval, get a full stock-info snapshot of price, valuation metrics, and company details, read the latest news for a ticker, and review dividend and split history. On the fundamentals side it returns income statements, balance sheets, and cash-flow statements (annual or quarterly) and breaks down major, institutional, mutual-fund, and insider holders, so the agent can ground a thesis in actual financials rather than guesswork.
It also handles derivatives and the sell-side view: list an option's available expiration dates, retrieve the calls or puts chain for a given expiration, and read analyst recommendations along with upgrade and downgrade history. The server is built on the popular yfinance Python library, runs locally over stdio via uv/uvx, and requires no API key or account because it reads Yahoo Finance's public endpoints. It is MIT-licensed. Note that it is an unofficial wrapper around Yahoo Finance data, so coverage and availability follow that upstream source.
Quick install
Copy-paste configs are provided for all 8 supported clients. Pick your client below.
Available tools
| Tool | Description |
|---|---|
| get_historical_stock_prices | Returns historical OHLCV price data for a ticker over a chosen period and interval. |
| get_stock_info | Returns a comprehensive snapshot of a stock: price, valuation metrics, and company details. |
| get_yahoo_finance_news | Fetches the latest news articles for a given ticker. |
| get_stock_actions | Returns a ticker's dividend and stock-split history. |
| get_financial_statement | Returns the income statement, balance sheet, or cash-flow statement (annual or quarterly). |
| get_holder_info | Returns major holders, institutional holders, mutual funds, or insider transactions for a ticker. |
| get_option_expiration_dates | Lists the available options expiration dates for a ticker. |
| get_option_chain | Returns the calls or puts options chain for a specific expiration date. |
| get_recommendations | Returns analyst recommendations or upgrade/downgrade history for a ticker. |
What you can do with it
Analyze a stock on demand
The agent pulls a price history, the stock-info snapshot, and the latest financial statements to produce a grounded read on how a company is trading and what its fundamentals look like.
Inspect options and the sell-side view
List expiration dates, fetch the relevant calls or puts chain, and read analyst recommendations so the agent can summarize positioning and Street sentiment for a ticker.
FAQ
- Is it free?
- Yes. The server is open source under the MIT license and free to run. It reads Yahoo Finance's public endpoints via the yfinance library and needs no API key or paid plan, though it is subject to Yahoo's rate limits and availability.
- Does it support remote/OAuth?
- No. It runs locally over stdio via uv/uvx and requires no authentication. There is no hosted OAuth endpoint, since the underlying Yahoo Finance data is public.
- Is this an official Yahoo server?
- No. It is an actively maintained community project built on the yfinance library, not an official Yahoo offering. Data coverage, freshness, and availability follow Yahoo Finance as the upstream source.