yahoo-finance2 MCP
An unofficial Yahoo Finance client with an MCP server, a CLI and an agent skill: quotes, price history, financial statements and options for an agent
- 816 ★ on the repository
- Last commit
- MIT
Broad access
Why this level
- The data feeds financial decisions and is not investment advice
- An unofficial source, with no guaranteed accuracy or availability
- It reaches the external Yahoo Finance service
Install
- Works in
In your terminal, with SkillFoxx CLI
npx skillfoxx add mcp/yahoo-finance2Detects the agents on your machine, shows the access level and pins the version.
Other ways to install
Access and checks
How we reviewBroad accessThe tool can change data, run commands or handle secrets.
- The data feeds financial decisions and is not investment advice
- An unofficial source, with no guaranteed accuracy or availability
- It reaches the external Yahoo Finance service
This is third-party code. Review the repository files before installing.
What it does
The package exposes Yahoo Finance data three ways: as a library for server-side JavaScript and TypeScript, as a CLI and as an MCP server. The MCP server offers a read-only toolset: quote, search, quoteSummary, chart, historical, options, screener, trendingSymbols, recommendationsBySymbol, insights and fundamentalsTimeSeries. Through them an agent gets quotes, price history with dividends and splits, a company profile and summary, option chains and screener picks. Transports include stdio and streamable HTTP. Deprecated modules are intentionally left out of the MCP surface.
Who it is for. For analysts and developers who need Yahoo Finance market data in an agent or in server-side code.
Good fit when
- You need quotes and price history for a ticker for analysis
- You want to give an agent read-only Yahoo Finance data
- You need option chains, screeners or a company summary
Not a fit when
- You need an official and guaranteed data source
- You expect an investment recommendation rather than raw data
- You try to call the API directly from the browser, which is not supported
Example request
Find the Apple ticker and show the latest quote and currencyMCP
- Transport
- stdio, http
- Authentication
- not required
Limitations
It is an unofficial client; Yahoo provides no public API and does not guarantee availability or data consistency, and the authors disclaim liability for possible losses. Data can change or disappear, for example history for delisted securities is removed. It runs in server-side environments and cannot be called directly from the browser. The data is informational and not investment advice.
How to disable. Remove the yahoo-finance2 entry from the MCP client config or remove the skill. A globally installed package is removed with npm.
FAQ
Is this Yahoo's official API?
No. The project is unofficial, Yahoo publishes no open API and does not guarantee data availability, so use it at your own risk.
Can it trade?
No. The package returns read-only data and has no trading or account access.
Discussion
No questions or reviews yet.
Related
MCP serversMCP server that gives an agent Yahoo Finance data by ticker: price history, financial statements and option chains
The yfmcp MCP server with Yahoo Finance data: quotes, statements, news, options, holders and charts as images
An MCP server for market data and technical analysis: quotes, indicators, screeners and backtesting for stocks, crypto, forex and futures
A financial analysis MCP server: 500+ methods from company statements, ratios, indicators, risk metrics and macro data
Financial data MCP server: stocks, funds, bonds, macro indicators, news and crypto via Tushare and Binance
An MCP server for personal stock analysis: market data, technical indicators, screening and portfolio tracking, no keys for the core
README in short
The README covers the v4 package, supported runtimes (Bun, Cloudflare, Deno, Node) and warns that it is an unofficial client with no guarantees. It shows a CLI quick start and library import and lists the available data modules. Separate docs describe the MCP server with a read-only toolset and an npx launch, plus an agent skill installed with npx skills add. It notes that browser calls are not supported and that data for delisted securities disappears.