$ timeahead.in
/ servers/pypi/yahoo-finance-mcp
pypi

yahoo-finance-mcp

This is a Model Context Protocol (MCP) server that provides comprehensive financial data from Yahoo Finance. It allows you to retrieve detailed information about stocks, including historical prices, c

308 stars829/wkupdated 80d agogithub ↗
88good
▣ Overview

What it does

The server exposes Yahoo Finance data through the Model Context Protocol, letting Claude retrieve stock prices, company fundamentals, financial statements, options data, analyst recommendations, and market news. It provides tools for historical OHLCV prices with configurable periods and intervals, comprehensive stock metrics and company details, income statements and balance sheets in annual or quarterly formats, dividend and split history, options chains by expiration date, institutional and insider holder information, and analyst recommendation trends.

Who it's for

Financial analysts, investment researchers, and portfolio managers building Claude-powered research tools. Developers integrating Yahoo Finance data into fintech applications without maintaining direct API connections.

Common use cases

  • Retrieve historical stock prices over custom time periods to analyze price trends and volatility patterns
  • Pull quarterly and annual financial statements for multiple companies to compare profitability and capital structure
  • Fetch options chains for specific expiration dates to evaluate call and put premiums
  • Access institutional holder and insider transaction data to track ownership concentration and executive confidence
  • Get recent analyst recommendations and upgrades/downgrades to contextualize peer and sector research

Setup pitfalls

  • Requires Python 3.11 or higher; installation on older versions will fail with import errors
  • Setup uses uv for dependency management; install it first or use the alternative pip installation path if preferred
  • Claude for Desktop requires manual config file editing and application restart; Windows users must specify the full path to the uv executable
  • yfinance has rate limits and occasional data unavailability for certain symbols; cache results or implement exponential backoff for reliability
▣ Score BreakdownMCPScore = Σ(raw × weight)
DimensionRawWeighted
Security
35%
100
35.0
Freshness
25%
100
25.0
Adoption
20%
63
12.6
Quality
10%
100
10.0
Trust
10%
50
5.0
Total
87.6
⚿ Capabilities & Risk Explainer
no elevated permissions
◆ Risk level: low
No elevated permissions requested — safe to connect.
⚙ Install config
Claude Desktop · Cursor · Windsurf · VS Code (Copilot) · Claude Code
add to your MCP client config:
{
  "mcpServers": {
    "yahoo-finance": {
      "command": "uvx",
      "args": [
        "yahoo-finance-mcp"
      ]
    }
  }
}
📈 Score historylast 30 snapshots
5/10/20266/11/2026 · 30 snapshots
⚙ Maintenance health
12/ 100 · is this project alive?
contributors (1y)1
top contributor share100%
releases (1y)0
ci✗ none
⛁ Raw data
weekly downloads829
github stars308
forks141
open issues7
license✓ present
readme length5450 chars
last publish0d ago
last commit80d ago
last updated1d ago
install verified✓ pass · 25d 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
yahoo-finance-mcp — MCP Score: 88/100 | MCPScore | Timeahead