Skip to content
appsgit

Yahoo Finance

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.

github.com/narumiruna/yfinance-mcp (opens in a new tab)

Install Yahoo Finance

Generated from the server's MCP registry entry. Replace your-value with your own values.

Claude Desktop

claude_desktop_config.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

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

Cursor

.cursor/mcp.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
{
  "servers": {
    "yahoo-finance": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "yfmcp"
      ]
    }
  }
}

Config formats checked against the official docs on Oct 7, 2026: modelcontextprotocol.io (opens in a new tab), code.claude.com (opens in a new tab), cursor.com (opens in a new tab), code.visualstudio.com (opens in a new tab).

Tools (40)

Parsed from the Tools section of the README; check the repository for the current list.

  • 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,…

About Yahoo Finance

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.

  • finance
  • mcp
  • mcp-server
  • python
  • yahoo-finance

FAQ

Yahoo Finance FAQ

Still curious? Email info@appsgit.com.

What is Yahoo Finance?

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. The source code is at github.com/narumiruna/yfinance-mcp.

How do I install the Yahoo Finance MCP server?

Add the command uvx yfmcp to your MCP client: put it in claude_desktop_config.json for Claude Desktop, run claude mcp add for Claude Code, or add it to .cursor/mcp.json (Cursor) or .vscode/mcp.json (VS Code). The snippets on this page are ready to paste.

Is Yahoo Finance free?

The server is open source under the MIT license, so running it is free. It does not declare any required API key.

Is Yahoo Finance actively maintained?

The most recent commit was on Oct 5, 2026. The latest release is v0.14.0, published Aug 5, 2026. appsgit only lists MCP servers with a commit in the last six months and re-checks every server daily.