$ timeahead.in
/ servers/pypi/yfmcp
89good
▣ Overview
PyPI versionPythonCILicense: MIT

What it does

An MCP server that bridges Claude to Yahoo Finance market data. Provides tools to fetch company fundamentals, financial statements (income, balance sheet, cash flow), recent news, sector rankings, and historical price data with adjustable time periods and granularity. Can generate technical analysis charts (candlestick with volume, VWAP, volume profile) as WebP images, perform searches across quotes and news, and retrieve options chains and insider ownership information. All data returns as structured JSON or markdown tables.

Who it's for

Finance analysts, equity researchers, investment advisors, and professionals building financial research workflows. Useful for anyone who wants to pull real-time and historical market data into Claude conversations without context switching or manual lookups.

Common use cases

  • Query company fundamentals and valuation metrics for a stock ticker
  • Generate candlestick or technical analysis charts over custom time periods
  • Search Yahoo Finance for stocks, ETFs, and news by keyword
  • Fetch quarterly and annual financial statements for due diligence
  • Rank sectors and identify top performers or growth companies

Setup pitfalls

  • yfinance dependency — ensure the package is installed alongside the MCP server
  • Intraday data requests (e.g., interval="1m") may hit rate limits; batch requests when querying many tickers
  • Chart generation returns base64-encoded WebP images for token efficiency — requires a client capable of decoding them
▣ 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"
      ]
    }
  }
}
⚙ 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 updated10h ago
install verified✓ pass · 20d 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