Yahoo Finance MCP server
io.github.narumiruna/yfinance-mcp·v0.14.0·207 starsAccess Yahoo Finance stock data, news, screeners, options, financials, and charts through MCP.
207 stars675 downloads/wk
Reviews
Write oneNobody has reviewed Yahoo Finance yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Yahoo Finance tools (15, 2 write)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
yfinance_get_analyst_estimatesFetch consensus estimates, EPS/revenue trends, revisions, recommendations, and earnings history.
yfinance_get_analyst_price_targetsFetch the current price and analyst consensus price targets for a stock.
yfinance_get_financialsFetch financial statements (income statement, balance sheet, and cash flow) with historical data.
yfinance_get_fund_dataFetch ETF or mutual-fund composition, holdings, exposures, ratings, and operating details.
yfinance_get_holdersFetch major holders, institutional holders, mutual fund holders, and insider data.
yfinance_get_option_chainFetch option chain data (calls and puts) for a stock with available strike prices.
yfinance_get_option_datesFetch available option expiration dates for a stock.
yfinance_get_price_historyFetch historical price data and optionally generate technical analysis charts.
yfinance_get_ticker_infoRetrieve comprehensive stock data including company information, financials, trading metrics and governance.
yfinance_get_ticker_newsFetch recent news articles and press releases for a specific stock.
yfinance_get_topGet top-ranked financial entities within a sector.
yfinance_get_upgrades_downgradesFetch analyst upgrades, downgrades, initiations, and price target changes.
yfinance_screenwrite actionRun a Yahoo Finance screener query.
yfinance_screen_gapperswrite actionRun a custom equity screener tuned for opening-session stock gappers.
yfinance_searchSearch Yahoo Finance for stocks, ETFs, and news articles.
Public scan report
scanner v0.1.10 · 2026-11-03 · same rubric, same numbers if you re-run it
- Code scan6 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 2 days ago15/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
How Yahoo Finance compares
Against every graded Finance MCP server, from our own scans and uptime checks. Updated after each scan run.
- Safety score
- 92/100
- higher than 95% of 1,765 Finance servers
- Tools
- 15
- the typical Finance server has 9
- Tools that change things
- 13%
- typical: 0%. Fewer write tools means less an agent can break
- GitHub stars
- 207
- more than 95% of 957 Finance servers
- Downloads a week
- 675
- more than 93% of 505 Finance servers with a package
What its tools let an agent do: 13 read · 2 change
Install Yahoo Finance in Claude Code, Cursor or VS Code
claude mcp add yfinance-mcp -- uvx yfmcp
What the publisher says
From the Yahoo Finance repository's README, as published. We do not edit it. Read it on GitHub
Yahoo Finance MCP Server
<!-- mcp-name: io.github.narumiruna/yfinance-mcp -->
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.
Features
- Stock Data — Company info, financials, valuation metrics, dividends, and trading data
- Analyst Data — Consensus targets, estimate/revision trends, recommendation history, and firm-level actions
- Financial Statements — Income statement and balance sheet with historical data (EBIT, Invested Capital, etc.)
- Financial News — Recent news 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, and top performers by sector
- Price History — Historical OHLCV data as markdown tables or professional charts
- Chart Generation — Candlestick, VWAP, and volume profile charts returned as WebP images
- Options Data — Option chains with calls, puts, strike prices, IV, and expiration dates
- Ownership Data — Major holders, institutional investors, mutual fund holders, and insider transactions
- Fund Look-Through — ETF and mutual-fund holdings, asset classes, sectors, ratings, and operating details
- Screeners — Predefined, equity, mutual-fund, and ETF query trees
Tools
yfinancegetticker_info
Retrieve comprehensive stock data including company info, financials, trading metrics, and governance data.
Returns: JSON object with company details, price data, valuation metrics, trading info, dividends, financials, and performance indicators.
yfinancegetanalystpricetargets
Fetch the current price and analyst consensus price targets for a stock.
Returns: JSON object with current, low, high, mean, and median price fields. Analyst coverage and available fields vary by symbol.
yfinancegetanalyst_estimates
Fetch analyst consensus estimates, revision momentum, recommendations, growth estimates, and earnings history.
Returns: Named arrays for available sections plus _metadata containing per-section row counts, truncation status, unavailable sections, and failed sections. A failure in one section does not discard successfully fetched sections.
yfinancegetupgrades_downgrades
Fetch analyst upgrades, downgrades, initiations, reiterations, and price-target changes, newest first.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Yahoo Finance: common questions
- Is Yahoo Finance MCP server safe?
- Yes, by our scan: it is graded A (92/100). Read the Yahoo Finance safety report
- How do I install Yahoo Finance?
- It runs on your machine. Copy the Claude Code, Cursor, VS Code or Claude Desktop config from the install section.
- Does Yahoo Finance need an API key?
- Not as far as the registry entry and our scan can tell: no credentials are declared or required.
- Is Yahoo Finance maintained?
- The last commit was 14 days ago (2026-11-01). The latest release is v0.14.0.
- What can I use instead of Yahoo Finance?
- Servers from other publishers that do the same job: Tapetide - Indian Stock Market MCP server, HPSILab Quant Finance MCP server and Finance Toolkit MCP server. Compare all Yahoo Finance alternatives.
- How does Yahoo Finance compare with other Finance MCP servers?
- safety score 92/100 (higher than 95% of 1,765 Finance servers); tools 15 (the typical Finance server has 9); tools that change things 13% (typical: 0%. Fewer write tools means less an agent can break). Full comparison.
Alternatives to Yahoo Finance
Same job from other publishers: the closest match first, then the best rated.
- Tapetide - Indian Stock Market MCP48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, optionsnot reviewedEstablishedA
- HPSILab Quant FinanceStock & options risk analytics for AI agents: pre-trade risk scan, IV, gamma walls, Monte Carlo.not reviewedGrowingA
- Finance Toolkit500+ transparent financial methods calculated from raw statements, not third-party endpoints.not reviewedWidely usedA
- Zwldarren Akshare OneProvide access to Chinese stock market data including historical prices, real-time data, news, and…not reviewedGrowingA
- ApexChartsGenerates and validates configs for ApexCharts charts, grid, gantt, tree, sankey, stock and maps.not reviewedGrowingA