yfinance-mcp

Overview

The yfinance-mcp server provides AI assistants with comprehensive access to Yahoo Finance data through the Model Context Protocol. It leverages the popular yfinance library to retrieve stock information, financial statements, historical data, news articles, and options data. The server offers multiple tools for different financial data needs, including ticker info retrieval, financial statement analysis, price history with chart generation, and options data access.

Try asking AI

After installing, here are 5 things you can ask your AI assistant:

• yfinance_get_ticker_infosymbol: string

  Retrieve comprehensive stock data including company info, financials, trading metrics, and governance data.

  Try:Show me information about AAPL stockTry:Get details on Tesla's trading metrics and financials
• yfinance_get_ticker_newssymbol: string

  Fetch recent news articles and press releases for a specific stock.

  Try:What's the latest news about Microsoft?Try:Find recent press releases for Google
• yfinance_searchquery: string, search_type: string

  Search Yahoo Finance for stocks, ETFs, and news articles.

  Try:Search for Apple Inc.Try:Find news articles about electric vehicles
• yfinance_get_topsector: string, top_type: string, top_n?: number

  Get top-ranked financial entities within a market sector.

  Try:Show top technology companiesTry:Get top performing companies in healthcare
• yfinance_get_price_historysymbol: string, period?: string, interval?: string, chart_type?: string, prepost?: boolean

  Fetch historical price data and optionally generate technical analysis charts.

  Try:Get Apple's stock price history for the last 6 monthsTry:Show a candlestick chart for Microsoft stock
• yfinance_get_financialssymbol: string, frequency?: string

  Fetch financial statements (income statement, balance sheet, and cash flow) with historical data.

  Try:Show Amazon's annual financial statementsTry:Get quarterly financial data for Netflix
• yfinance_get_holderssymbol: string, max_rows?: number

  Fetch major holders, institutional holders, mutual fund holders, and insider data.

  Try:Show major holders of Tesla stockTry:Get institutional investor data for Apple
• yfinance_get_option_datessymbol: string

  Fetch available option expiration dates for a stock.

  Try:When are the next option expiration dates for Amazon?Try:Get option dates for Microsoft
• yfinance_get_option_chainsymbol: string, expiration_date?: string, option_type?: string

  Fetch option chain data (calls and puts) for a stock with available strike prices.

  Try:Show option chain data for GoogleTry:Get Tesla put options with June 2023 expiration

Comparable tools

Installation

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

{
  "mcpServers": {
    "yfmcp": {
      "command": "docker",
      "args": ["run", "-i", "--rm", "narumi/yfinance-mcp"]
    }
  }
}

git clone https://github.com/narumiruna/yfinance-mcp.git
cd yfinance-mcp
uv sync

{
  "mcpServers": {
    "yfmcp": {
      "command": "uv",
      "args": [
        "run",
        "--directory",
        "/path/to/yfinance-mcp",
        "yfmcp"
      ]
    }
  }
}

FAQ

What financial data can be accessed through this MCP server?

The server provides comprehensive financial data including stock information, financial statements (income, balance sheet, cash flow), company details, price history with technical charts, financial news, sector rankings, options data, and ownership information.

Can I generate charts with this MCP server?

Yes, the server can generate professional financial charts including candlestick charts with volume bars, VWAP overlays, and volume distribution charts. Charts are returned as Base64-encoded WebP images for efficient token usage.

Compare yfinance-mcp with