Yahoo Finance MCP Server: Setup, Limits and Alternatives (2026)
Yahoo Finance has no official API. Every Yahoo Finance MCP server you install is reading an unofficial one.
A Yahoo Finance MCP server is a small program that lets an AI agent like Claude, Cursor or Codex pull stock prices, company info and news from Yahoo Finance as tools. The popular ones are free and run locally through the open-source yfinance library. They work well for prices, but Yahoo blocks script-like requests and limits some data, so they're best for personal projects, not products.
What is a Yahoo Finance MCP server?
A Yahoo Finance MCP server is an open-source tool that exposes Yahoo Finance data to AI agents through the Model Context Protocol. You install it on your own machine, point Claude, Cursor or Codex at it, and the agent can call tools like get_stock_info or get_historical_stock_prices. Most wrap yfinance, an unofficial Python library, so no API key is needed.
MCP is the plug that lets an agent call outside tools. The server lists what it can do, and the agent picks a tool when your question needs one.
Ask "what did Apple close at yesterday?" and the agent calls the price tool instead of guessing from training data.
The appeal is obvious. It's free, it takes two minutes to set up, and Yahoo has prices for nearly every ticker.
The catch is the word "unofficial." That shapes everything below.
Which Yahoo Finance MCP servers are there?
There are dozens. A GitHub search for "yahoo finance mcp" returned 174 repositories on November 16, 2026. The most-starred are gadicc/yahoo-finance2 (816 stars), a Node library with its own MCP server, wshobson/maverick-mcp (728 stars), which adds technical analysis, and Alex2Yang97/yahoo-finance-mcp (370 stars), a Python server built on yfinance.
Here are the ones you'll most likely land on:
| Server | Stars (Nov 17, 2026) | Built on | Install |
|---|---|---|---|
| gadicc/yahoo-finance2 | 816 | Its own unofficial Node client | npm |
| wshobson/maverick-mcp | 728 | Yahoo data plus technical analysis | Python |
| Alex2Yang97/yahoo-finance-mcp | 370 | yfinance 1.6 or later | uvx, from GitHub |
| narumiruna/yfinance-mcp | Not in the top 12 by stars | yfinance 1.8 or later | uvx yfmcp |
| danishashko/yahoo-finance-mcp | 26 | yfinance 1.8 or later, 18 tools | Python |
They differ in tool count and polish, not in where the data comes from. Every one of them reads the same Yahoo endpoints.
So if Yahoo changes something, they tend to break together. Picking the most popular one doesn't protect you from that.
Alex2Yang97's server is a good example of the typical toolset. It offers stock info, historical prices, financial statements, holders, option chains, recommendations and news.
How do you add a Yahoo Finance MCP server to Claude?
To add a Yahoo Finance MCP server to Claude Desktop, open its config file, add the server under mcpServers with the command its README gives, and restart Claude. For Alex2Yang97/yahoo-finance-mcp, that command is uvx with the GitHub repository as the source. You need uv installed. Cursor and Codex take the same server through their own MCP settings.
Here's the block from that server's README on GitHub:
{
"mcpServers": {
"yfinance": {
"command": "uvx",
"args": [
"--from",
"git+https://github.com/Alex2Yang97/yahoo-finance-mcp",
"yahoo-finance-mcp"
]
}
}
}
narumiruna's server is shorter, because it's published as a package:
{
"mcpServers": {
"yfmcp": {
"command": "uvx",
"args": ["yfmcp@latest"]
}
}
}
Both run as a local process on your computer. That matters more than it looks.
Every request to Yahoo comes from your machine and your IP address. When Yahoo decides that traffic looks automated, it's your connection that gets throttled.
Does Yahoo Finance have an official API?
No. Yahoo Finance doesn't offer a public developer API or API keys for its finance data. Tools like yfinance call the same internal endpoints Yahoo's own website uses. yfinance's README says the data is intended for research and educational purposes and for personal use only, and tells users to check Yahoo's terms of use.
That's the honest framing. yfinance, now at version 1.8.0 (released November 3, 2026), is well maintained, but it's a client for an API Yahoo never promised to keep stable.
People search for a "Yahoo Finance API key" all the time. There isn't one to get.
Sites selling a "Yahoo Finance API" are third parties that scrape or resell the same data. Read their terms as carefully as Yahoo's.
Why do Yahoo Finance MCP servers break?
Yahoo Finance MCP servers break because Yahoo actively filters automated traffic. In my tests on November 16, 2026, the price endpoint answered a browser-like request with 200, but returned 429 Too Many Requests on the very first request when the User-Agent was a Python default or missing. Company data endpoints returned 401 "Invalid Crumb" without Yahoo's session cookie.
I sent one request per case, two seconds apart, to the endpoints yfinance uses:
| Request | Result |
|---|---|
| Price chart, browser User-Agent | 200, Apple at $356.27, 5 daily bars |
| Price chart, python-requests User-Agent | 429 Too Many Requests |
| Price chart, no User-Agent | 429 Too Many Requests |
| quoteSummary company data, no crumb | 401, "Invalid Crumb" |
| v7 quote, no crumb | 401, "User is unable to access this feature" |
| Fundamentals time series | 200, annual revenue for 2023 to 2026 |
| Symbol search | 200, 7 matches |
The 429 is the sneaky one. It says "too many requests," but it came back on the first request. It's a block on how the request looks, not on how often you call.
The crumb is the other moving part. Yahoo hands out a session cookie and a matching token, and company data endpoints want both.
yfinance handles that dance for you, which is most of why these servers depend on it. It goes further, too: yfinance 1.8.0 requires curl_cffi, a library whose PyPI summary advertises "impersonation support," so its requests can look like a browser's. When Yahoo changes the dance, yfinance needs an update, and every server built on it waits for that release.
If your agent suddenly says it can't fetch data, update yfinance first. Then check the server's GitHub issues, where breakages usually show up within hours.
curl -H "X-API-Key: edgr_your_key" "https://api.edgrapi.com/v1/fundamentals/AAPL?limit=20"Get a free API key 50 free credits, no card.Is yfinance deprecated?
No. yfinance isn't deprecated: version 1.8.0 shipped on November 3, 2026, and Yahoo Finance MCP servers still require it, with narumiruna/yfinance-mcp pinning 1.8 or later. What changes is Yahoo's side. Because the API is unofficial, endpoints can stop working without notice, and yfinance releases fixes after the fact.
That's the pattern behind most "is yfinance dead?" threads. Something breaks, a fix ships, things work again.
For a personal dashboard, that's fine. For anything a customer relies on, a data source that can vanish for a day without warning is a real risk.
What Yahoo Finance data is missing for AI agents?
Yahoo Finance is strongest on prices and weakest on deep fundamentals. In my test, its fundamentals time series returned Apple's annual revenue for only four fiscal years, 2023 through 2026. The SEC's own XBRL data has Apple's annual net income from fiscal 2009, and Edgrapi's fundamentals endpoint returned 20 years of Apple statements in one call.
That gap matters for the questions people actually ask agents. "How has Apple's margin changed over 15 years?" needs more than four data points.
The other gap is provenance. Yahoo's numbers are a summary. When an agent cites a figure, you can't trace it back to the filing it came from.
For SEC-sourced data, every number maps to a 10-K or 10-Q. That's useful when the agent's answer ends up in a report someone else reads.
And remember the 2025 Stack Overflow Developer Survey: more developers distrust AI accuracy than trust it, 46% to 33%. Agents that cite the source get checked, and the source should hold up.
Which finance MCP server should you use instead?
Use a Yahoo Finance MCP server for personal projects and quick price checks. For anything you ship, pick a server backed by an official or licensed source. Alpha Vantage, sec-api.io, EODHD and Edgrapi offer MCP servers, and Financial Datasets lets agents pay per call. Choose by data type: prices need a market data license, while filings and fundamentals come from the SEC.
My picks by job:
- Stock prices for a personal tool: a Yahoo Finance MCP server is fine
- Licensed stock prices in a product: Alpha Vantage's MCP server, or a paid market data API
- SEC filings, fundamentals and insider trades: an SEC-sourced server such as Edgrapi or sec-api.io
- Both prices and fundamentals: run two servers side by side, one for each
Running two MCP servers is normal. The agent sees both tool lists and calls whichever fits the question.
I compared the paid options, with prices and free tiers checked live, in my best financial data APIs post. My roundup of MCP servers for financial data covers more servers.
To be upfront about Edgrapi, since I run it: it has no stock prices. It's built from SEC filings and federal data: financial statements, filings, insider trades, 13F holdings, contracts and lobbying records, as 23 MCP tools.
Connecting it takes one URL, https://api.edgrapi.com/mcp, and you sign in with your Edgrapi account, no key to paste. The free tier gives 50 credits.
How do you run Yahoo Finance and an SEC server together?
Add both servers to your agent's MCP config, one entry each, and restart the agent. The agent loads both tool lists and picks per question: Yahoo's tools for a price, the SEC-sourced tools for a filing or a 10-year revenue trend. In Codex, both go in config.toml, a local command for the Yahoo server and a URL for a hosted one.
Here's what that looks like in Codex, using the formats each project documents:
# ~/.codex/config.toml
[mcp_servers.yfinance]
command = "uvx"
args = ["yfmcp@latest"]
[mcp_servers.edgrapi]
url = "https://api.edgrapi.com/mcp"
Then run codex mcp login edgrapi once to sign in to the hosted server. The Yahoo one needs no login.
Now a question like "compare Apple's share price this week with its revenue growth since 2010" gets split. The price comes from Yahoo, and the revenue history comes from the filings.
You can see which server answered by watching the tool calls. Codex and Claude both show the tool name before the result.
A word of caution on names. If two servers both offer a tool with the same name, the agent may pick the wrong one. Some servers prefix their tools, like narumiruna's yfinance_get_price_history, while others don't, like Alex2Yang97's get_stock_info. Check the tool list after setup.
Can you use Yahoo Finance data commercially?
Not safely. yfinance's own README says the Yahoo Finance data it fetches is intended for personal use only and points users to Yahoo's terms of use. Since Yahoo offers no commercial API or license for this data, showing it to paying customers rests on terms you haven't agreed to. For a product, license the data from a provider that sells commercial use.
This is the question most people skip until a customer asks where the numbers come from.
Market prices are licensed by the exchanges. That's why legitimate price APIs charge for real-time data and label their plans personal or commercial.
SEC filings are different. They're public records, so data built from them carries no exchange license fee.
Start with prices from Yahoo, then add a sourced server
Install a Yahoo Finance MCP server if you want stock prices in Claude or Cursor today, and expect to update yfinance when it breaks. Before you build anything other people rely on, add an MCP server backed by an official source for fundamentals and filings. Ask your agent the same question through both and compare the answers.
Frequently asked questions
Is there a Yahoo Finance MCP server?
Yes, many. A GitHub search on November 16, 2026 returned 174 repositories for "yahoo finance mcp." The most popular include gadicc/yahoo-finance2 with 816 stars and Alex2Yang97/yahoo-finance-mcp with 370. They're free, open source, and run locally, usually through the unofficial yfinance library. None is made or supported by Yahoo.
How do I add Yahoo Finance to Claude?
Add a Yahoo Finance MCP server to Claude Desktop's config file under mcpServers, using the command from the server's README, then restart Claude. For Alex2Yang97/yahoo-finance-mcp the command is uvx with the GitHub repository as the source, and you need uv installed. Claude then lists the Yahoo tools and calls them when you ask about a stock.
Does Yahoo Finance have an API key?
No. Yahoo Finance doesn't offer a public API or API keys for its finance data. Libraries like yfinance and the MCP servers built on them call Yahoo's internal endpoints without a key. Services advertising a "Yahoo Finance API key" are third parties reselling or scraping Yahoo data, with their own terms and pricing.
Is yfinance deprecated?
No. yfinance is actively maintained, and version 1.8.0 was released on November 3, 2026. It does break from time to time because it relies on Yahoo's unofficial endpoints, which can change without notice. When that happens, a yfinance update usually fixes it, so updating the package is the first thing to try.
Why does yfinance return 429 Too Many Requests?
Yahoo returns 429 to requests that look automated, not only to requests that are too frequent. In my November 2026 test, Yahoo's price endpoint answered the first request with 429 when the User-Agent was a Python default or missing, and with 200 for a browser-like one. Update yfinance, which handles Yahoo's session, and slow down your requests.
What is the best MCP server for financial data?
It depends on the data. For stock prices in personal projects, a Yahoo Finance MCP server works. For licensed prices, Alpha Vantage offers an official MCP server. For SEC filings, fundamentals and insider trades, use an SEC-sourced server like Edgrapi or sec-api.io. Many builders run one server for prices and another for fundamentals.