$ timeahead.in
/servers/blog/about
/ servers/pypi/yfmcp
pypi

yfmcp

★ 151 stars↓ 10k/wkupdated 4d agogithub ↗
☆ Watch this server📋 Install guide⚡ Compare⚑ Claim listing
89good
▣ Overview
PyPI versionPythonCILicense: MIT

What it does

A MCP server that bridges Claude with Yahoo Finance market data via the yfinance Python library. Exposes nine tools for retrieving stock fundamentals (price, valuation metrics, dividends), financial statements (income statement, balance sheet, cash flow with annual, quarterly, and TTM perspectives), market research (news, sector rankings, company search), and technical analysis (historical OHLCV data as markdown tables or rendered as WebP charts). Queries return structured JSON and images, making it straightforward for Claude to synthesize data across multiple securities and time periods.

Who it's for

Financial analysts, equity researchers, and traders who want stock research integrated into Claude conversations. Also suitable for developers building financial dashboards, portfolio applications, or market analysis tools that leverage Claude's reasoning.

Common use cases

  • Look up fundamental metrics (P/E ratio, dividend yield, market cap) for any stock ticker
  • Generate candlestick, VWAP, or volume profile charts for technical analysis
  • Search for top-performing companies or ETFs within a market sector
  • Fetch recent news articles to contextualize market moves for a stock
  • Compare historical price trends or analyze options chains for trading decisions

Setup pitfalls

  • Network connectivity to Yahoo Finance is required — the server cannot function offline, and queries will fail if the Yahoo Finance API is unreachable
  • Rate limiting may occur on high-volume requests — yfinance may throttle during peak market hours or with many concurrent queries
  • No API keys required, but ensure your network policy allows outbound HTTPS to Yahoo Finance
▣ Score BreakdownMCPScore = Σ(raw × weight)
DimensionRawWeighted
Security
35%
100
35.0
Freshness
25%
100
25.0
Adoption
20%
70
13.9
Quality
10%
100
10.0
Trust
10%
50
5.0
Total
88.9
⚿ Capabilities & Risk Explainer
secrets
◆ Risk level: low· 9 tools · auth: API key
secrets — requires access to credentials or environment secrets.
Tool nameDescriptionDestructive?
yfinance_get_ticker_info✓ no
yfinance_get_ticker_news✓ no
yfinance_search✓ no
yfinance_get_top✓ no
yfinance_get_price_history✓ no
+4 more tools
yfinance_get_financials✓ no
yfinance_get_option_chain✓ no
yfinance_get_option_dates✓ no
yfinance_get_holders✓ no
⚙ Install config
Claude Desktop · Cursor · Windsurf · VS Code (Copilot) · Claude Code
add to your MCP client config:
{
  "mcpServers": {
    "yfmcp": {
      "command": "uvx",
      "args": [
        "yfmcp"
      ]
    }
  }
}
📈 Score historylast 27 snapshots
5/10/20266/6/2026 · 27 snapshots
⚙ Maintenance health
52/ 100 · is this project alive?
contributors (1y)8
top contributor share75%
releases (1y)2
last release20d ago
ci✓ passing
⛁ Raw data
weekly downloads10k
github stars151
forks55
open issues1
license✓ present
readme length11422 chars
last publish0d ago
last commit4d ago
last updated7h ago
install verified✓ pass · 19d ago
owner of this server? claim your listing to get a verified badgeclaim →
🔔 Score drop alerts
get notified by email when this server's score drops 5+ points