MCP.Market

Yahoo Finance MCP server

by narumiruna·io.github.narumiruna/yfinance-mcp·v0.14.0·207 stars

Access Yahoo Finance stock data, news, screeners, options, financials, and charts through MCP.

A92/100grade A
What users say
No reviews yet
Be the first
Safety scan
A92/100

full report

Adoption
Established

207 stars675 downloads/wk

Reviews

Write one

Nobody 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 posts

Read from the package source without running it. The installed server may list more.

  • yfinance_get_analyst_estimates

    Fetch consensus estimates, EPS/revenue trends, revisions, recommendations, and earnings history.

  • yfinance_get_analyst_price_targets

    Fetch the current price and analyst consensus price targets for a stock.

  • yfinance_get_financials

    Fetch financial statements (income statement, balance sheet, and cash flow) with historical data.

  • yfinance_get_fund_data

    Fetch ETF or mutual-fund composition, holdings, exposures, ratings, and operating details.

  • yfinance_get_holders

    Fetch major holders, institutional holders, mutual fund holders, and insider data.

  • yfinance_get_option_chain

    Fetch option chain data (calls and puts) for a stock with available strike prices.

  • yfinance_get_option_dates

    Fetch available option expiration dates for a stock.

  • yfinance_get_price_history

    Fetch historical price data and optionally generate technical analysis charts.

  • yfinance_get_ticker_info

    Retrieve comprehensive stock data including company information, financials, trading metrics and governance.

  • yfinance_get_ticker_news

    Fetch recent news articles and press releases for a specific stock.

  • yfinance_get_top

    Get top-ranked financial entities within a sector.

  • yfinance_get_upgrades_downgrades

    Fetch analyst upgrades, downgrades, initiations, and price target changes.

  • yfinance_screenwrite action

    Run a Yahoo Finance screener query.

  • yfinance_screen_gapperswrite action

    Run a custom equity screener tuned for opening-session stock gappers.

  • yfinance_search

    Search 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

no findings
  • 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
Overall 92/100. Components that don't apply are left out of the denominator. Any critical finding is an F.RubricAppeal a findingJSON

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
Add to Cursor

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.

All Yahoo Finance alternatives →
  • Tapetide - Indian Stock Market MCP
    48 tools for ~8,000 NSE & BSE stocks: quotes, screener, financials, filings, FII/DII, options
    A
  • HPSILab Quant Finance
    Stock & options risk analytics for AI agents: pre-trade risk scan, IV, gamma walls, Monte Carlo.
    A
  • Finance Toolkit
    500+ transparent financial methods calculated from raw statements, not third-party endpoints.
    A
  • Zwldarren Akshare One
    Provide access to Chinese stock market data including historical prices, real-time data, news, and…
    A
  • ApexCharts
    Generates and validates configs for ApexCharts charts, grid, gantt, tree, sankey, stock and maps.
    A