# Yahoo Finance (MCP server)

> Yahoo Finance is an MCP server that accesses Yahoo Finance stock data, news, screeners, options, financials, and charts through MCP. It has 197 GitHub stars, is released under the MIT license and runs locally with uvx yfmcp. It works with Claude Desktop, Claude Code, Cursor and VS Code.

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.

## Key facts

| Fact | Value |
|---|---|
| Repository | https://github.com/narumiruna/yfinance-mcp |
| GitHub stars | 197 |
| License | MIT |
| Language | Python |
| Transport | stdio |
| Packages | pypi: yfmcp |
| Remote URL | none |
| Needs API key | no |
| Official | no |
| Works with | Claude Desktop, Claude Code, Cursor, VS Code |
| Category | Finance |
| Latest release | v0.14.0 (Aug 5, 2026) |
| Last commit | Oct 5, 2026 |
| MCP registry name | io.github.narumiruna/yfinance-mcp |

## Install

### Claude Desktop (claude_desktop_config.json)

```json
{
  "mcpServers": {
    "yahoo-finance": {
      "command": "uvx",
      "args": [
        "yfmcp"
      ]
    }
  }
}
```

Settings > Developer > Edit Config. macOS: ~/Library/Application Support/Claude/, Windows: %APPDATA%\Claude\. Restart Claude Desktop afterwards.

### Claude Code

```sh
claude mcp add --transport stdio yahoo-finance -- uvx yfmcp
```

### Cursor (.cursor/mcp.json)

```json
{
  "mcpServers": {
    "yahoo-finance": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "yfmcp"
      ]
    }
  }
}
```

Project file; use ~/.cursor/mcp.json to enable it in every project.

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "yahoo-finance": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "yfmcp"
      ]
    }
  }
}
```

Config formats checked against the official docs on 2026-10-07.

## Tools

- `yfinance_get_ticker_info`: Retrieve comprehensive stock data including company info, financials, trading metrics, and governance data.
- `symbol`: string
- `yfinance_get_analyst_price_targets`: Fetch the current price and analyst consensus price targets for a stock.
- `yfinance_get_analyst_estimates`: Fetch analyst consensus estimates, revision momentum, recommendations, growth estimates, and earnings history.
- `sections`: array
- `max_rows`: number
- `yfinance_get_upgrades_downgrades`: Fetch analyst upgrades, downgrades, initiations, reiterations, and price-target changes, newest first.
- `yfinance_get_ticker_news`: Fetch recent news articles and press releases for a specific stock.
- `yfinance_search`: Search Yahoo Finance for stocks, ETFs, and news articles.
- `query`: string
- `search_type`: string
- `yfinance_get_top`: Get top-ranked financial entities within a market sector.
- `sector`: string
- `top_type`: string
- `top_n`: number
- `yfinance_screen`: Run Yahoo Finance screeners using either predefined screener keys or custom query trees.
- `query_type`: string
- `offset`: number
- `size`: number
- `count`: number
- `sort_field`: string
- `sort_asc`: boolean
- `user_id`: string
- `user_id_type`: string
- `yfinance_screen_gappers`: Run a purpose-built custom screener for opening-session bullish gappers.
- `min_percent_change`: number
- `min_price`: number
- `min_volume`: number
- `min_market_cap`: number
- `region`: string
- `yfinance_get_price_history`: Fetch historical price data and optionally generate technical analysis charts.
- `period`: string
- `interval`: string
- `chart_type`: string
- `prepost`: boolean
- `yfinance_get_financials`: Fetch financial statements (income statement, balance sheet, and cash flow) with historical data.
- `frequency`: string
- `yfinance_get_holders`: Fetch major holders, institutional holders, mutual fund holders, and insider data.
- `major_holders`: Aggregated breakdown where each row has an index label (e.g. insidersPercentHeld, institutionsPercentHeld,…
- `institutional_holders`: Institutional investors; records typically include fields such as Date Reported, Holder, Shares, Value, pctChange,…

## Similar MCP servers

- [CCXT](https://appsgit.com/mcp-servers/ccxt): Official CCXT MCP server - Market data and trading across 100+ exchanges and prediction markets. (44,271 stars, MIT, official)
- [Finance Toolkit](https://appsgit.com/mcp-servers/finance-toolkit): 200+ transparent financial metrics calculated from raw statements, not third-party endpoints. (5,402 stars, MIT, needs API key)
- [Tradingview MCP](https://appsgit.com/mcp-servers/tradingview-mcp): Real-time market data, screeners, technical analysis & backtesting for stocks, crypto and forex. (4,948 stars, MIT)
- [EdgarTools](https://appsgit.com/mcp-servers/edgartools): Open-source SEC EDGAR toolkit — 13 tools, 7 prompts, every filing type. (2,776 stars, MIT)
- [AI](https://appsgit.com/mcp-servers/ai): MCP server integrating with Stripe - tools for customers, products, payments, and more. (1,859 stars, MIT, official)
- [Tradememory Protocol](https://appsgit.com/mcp-servers/tradememory-protocol): Tamper-evident decision audit trail and outcome-weighted memory for AI trading agents. (1,425 stars, MIT)

---

Canonical page: https://appsgit.com/mcp-servers/yahoo-finance
Source: appsgit (https://appsgit.com), the app store for github. Data from the GitHub API, refreshed nightly.
Machine access: JSON API https://appsgit.com/api/v1/apps (OpenAPI: https://appsgit.com/openapi.json), MCP server https://mcp.appsgit.com/mcp, full index https://appsgit.com/llms-full.txt.