yfinance-mcp MCP server

What yfinance-mcp does

Summarised from the project README; check the repository for the latest details.

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

Tools exposed (20+)

• yfinance_get_ticker_info
• Parameter – Type
• symbol – string
• yfinance_get_analyst_price_targets
• yfinance_get_analyst_estimates
• sections – array
• max_rows – number
• yfinance_get_upgrades_downgrades
• GradeDate – Date and time of the analyst action
• Firm – Analyst firm name
• ToGrade – and `FromGrade`: New and previous ratings
• Action – Rating action
• priceTargetAction – Price-target action such as `Raises`, `Lowers`, or `Maintains`
• currentPriceTarget – and `priorPriceTarget`: New and previous price targets
• yfinance_get_ticker_news
• yfinance_search
• query – string
• search_type – string
• yfinance_get_top
• sector – string

Requirements

• Python ≥ 3.12
• uv package manager
• Python with uv (runs with uvx/uv)

How to install yfinance-mcp MCP in Claude Desktop, Cursor and VS Code

claude mcp add --transport stdio yfmcp -- uvx yfmcp@latest

{
  "mcpServers": {
    "yfmcp": {
      "command": "uvx",
      "args": [
        "yfmcp@latest"
      ]
    }
  }
}

{
  "mcpServers": {
    "yfmcp": {
      "command": "uvx",
      "args": [
        "yfmcp@latest"
      ]
    }
  }
}

{
  "servers": {
    "yfmcp": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "yfmcp@latest"
      ]
    }
  }
}

Add to config generator – combine it with other servers, or get the Windsurf format.

Listed on Socketlist – add this badge to your README:

Badge markdown[](https://socketlist.pages.dev/s/narumiruna-yfinance-mcp/)

Maintain this project? Get it featured for free during launch →

Compare with FinanceToolkit →

Related Finance & Crypto MCP servers