Yahoo Finance
Yahoo Finance is an MCP server that accesses Yahoo Finance stock data, news, screeners, options, financials, and charts through MCP. It has 210 GitHub stars, is released under the MIT license and runs locally with uvx yfmcp. It works with Claude Desktop, Claude Code, Cursor and VS Code.
github.com/narumiruna/yfinance-mcp (opens in a new tab)
Data as of from the GitHub API and the official MCP registry; description from the project's repository. Report an error
Install Yahoo Finance
Generated from the server's MCP registry entry. Replace your-value with your own values.
Claude Desktop
{
"mcpServers": {
"yahoo-finance": {
"command": "uvx",
"args": [
"yfmcp"
]
}
}
}Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.
Claude Code
claude mcp add --transport stdio yahoo-finance -- uvx yfmcpCursor
{
"mcpServers": {
"yahoo-finance": {
"type": "stdio",
"command": "uvx",
"args": [
"yfmcp"
]
}
}
}Project file; use ~/.cursor/mcp.json to enable it in every project.
VS Code
{
"servers": {
"yahoo-finance": {
"type": "stdio",
"command": "uvx",
"args": [
"yfmcp"
]
}
}
}Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).
Tools (40)
Parsed from the Tools section of the README; check the repository for the current list.
yfinance_get_ticker_infoRetrieve comprehensive stock data including company info, financials, trading metrics, and governance data.
symbolstring
yfinance_get_analyst_price_targetsFetch the current price and analyst consensus price targets for a stock.
yfinance_get_analyst_estimatesFetch analyst consensus estimates, revision momentum, recommendations, growth estimates, and earnings history.
sectionsarray
max_rowsnumber
yfinance_get_upgrades_downgradesFetch analyst upgrades, downgrades, initiations, reiterations, and price-target changes, newest first.
yfinance_get_ticker_newsFetch recent news articles and press releases for a specific stock.
yfinance_searchSearch Yahoo Finance for stocks, ETFs, and news articles.
querystring
search_typestring
yfinance_get_topGet top-ranked financial entities within a market sector.
sectorstring
top_typestring
top_nnumber
yfinance_screenRun Yahoo Finance screeners using either predefined screener keys or custom query trees.
query_typestring
offsetnumber
sizenumber
countnumber
sort_fieldstring
sort_ascboolean
user_idstring
user_id_typestring
yfinance_screen_gappersRun a purpose-built custom screener for opening-session bullish gappers.
min_percent_changenumber
min_pricenumber
min_volumenumber
min_market_capnumber
regionstring
yfinance_get_price_historyFetch historical price data and optionally generate technical analysis charts.
periodstring
intervalstring
chart_typestring
prepostboolean
yfinance_get_financialsFetch financial statements (income statement, balance sheet, and cash flow) with historical data.
frequencystring
yfinance_get_holdersFetch major holders, institutional holders, mutual fund holders, and insider data.
major_holdersAggregated breakdown where each row has an index label (e.g. insidersPercentHeld, institutionsPercentHeld,…
institutional_holdersInstitutional investors; records typically include fields such as Date Reported, Holder, Shares, Value, pctChange,…
About Yahoo Finance
A Model Context Protocol (MCP) server that provides AI assistants with access to Yahoo Finance data via yfinance. Query stock information, financial news, sector rankings, and generate professional financial charts — all from your AI chat.
- finance
- mcp
- mcp-server
- python
- yahoo-finance
Similar MCP servers
More finance MCP servers
Financial Modeling Prep (fmpsdk)
daxm/fmpsdk
Financial Modeling Prep API as MCP tools — quotes, statements, prices, and ~240 endpoints.
Maintained · last commit Aug 29, 2026
FinancePythonPolymarket Toolkit
runesleo/polymarket-toolkit
Read-only Polymarket data tools for AI agents: profiles, PnL, market scans.
Active · last commit Nov 15, 2026
FinanceTypeScriptBind Erp
codespar/mcp-dev-latam
Open-source MCP servers for Latin American commerce — Pix, NF-e, banking, fiscal, logistics, and messaging across Brazil, Mexico, Argentina, Colombia, Chile, and Peru.
Maintained · last commit Sep 27, 2026
FinanceTypeScriptRisk-Aware Trading Agents
jackson-cmd/risk-aware-trading-agents
AI trading agents for US stocks: point-in-time news backtests, a frozen 2026 market, paper trading.
Too new to judge · created Nov 12, 2026
FinancePythonpump.fun Solana Data
nirholas/three.ws
Free, read-only pump.fun + Solana MCP: token discovery, on-chain analysis, SNS, 3D snapshots.
Active · last commit Nov 15, 2026
FinanceJavaScriptru-marketplace-mcp
Vladimir-Human/ru-marketplace-mcp
Read-only MCP servers for Russian marketplaces: prices, stock, ratings, reviews, seller identity.
Active · last commit Nov 16, 2026
FinancePython
How do I install the Yahoo Finance MCP server?
Add the command uvx yfmcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.
Is Yahoo Finance free?
The server is open source under the MIT license, so running it is free. It does not declare any required API key.
Is Yahoo Finance actively maintained?
The most recent commit was on Nov 15, 2026. The latest release is v0.14.0, published Aug 5, 2026. appsgit only lists MCP servers with a commit in the last six months.