Yahoo Finance MCP Server

A comprehensive financial data analysis server built with the Model Context Protocol (MCP), providing extensive Yahoo Finance data through a clean and efficient interface. This server offers real-time market data, portfolio management, and economic indicators.

🚀 Features

Stock & Crypto Information

• Real-time price data

• Historical prices with customizable intervals

• Market capitalization

• Trading volume

• 52-week highs and lows

• Sector and industry classification (stocks)

• Cryptocurrency support (BTC-USD, ETH-USD, etc.)

Market Data

• Stock news and updates

• Analyst recommendations

• Options data and chains

• Stock actions (dividends, splits)

Economic Indicators

• Major Indices

  • S&P 500

  • Dow Jones

  • NASDAQ

  • Russell 2000

• Market Metrics

  • Treasury Yields (2Y, 5Y, 10Y, 30Y)

  • Volatility Indices (VIX, VXN)

  • Commodities (Gold, Oil, Silver)

  • Forex Rates (EUR/USD, GBP/USD, USD/JPY)

Related MCP server: YFinance Trader MCP Tool

🛠️ Installation

1. Ensure you have Python 3.11.5 or later installed

2. Clone the repository:

git clone https://github.com/leo-ye0/yahoo-finance-mcp.git
cd yahoo-finance-mcp

3. Create and activate a virtual environment:

python -m venv .venv
source .venv/bin/activate  # On Windows, use: .venv\Scripts\activate

4. Install the package and dependencies:

pip install -e .

🚀 Usage

Starting the Server

python src/yahoo_finance_mcp/server.py

Example Usage

# Get stock/crypto information
await get_stock_info("AAPL")  # For stocks
await get_stock_info("BTC-USD")  # For cryptocurrencies

# Portfolio Analysis
await analyze_portfolio(
    symbols=["AAPL", "MSFT", "GOOGL"],
    weights=[0.4, 0.3, 0.3]
)

# Get economic indicators
await get_economic_indicators()  # Get comprehensive market data

# Get market summary
await get_market_summary()  # Quick overview of major indices

📊 Available Tools

🔧 Dependencies

• Python >=3.11.5

• yfinance >=0.2.18

• pandas >=1.5.0

• numpy >=1.21.0

• pydantic >=2.0.0

• fastmcp >=2.10.5

• mcp >=0.1.0

🤖 Claude Integration

Setup with Claude Desktop

1. Open Claude's config:

# On MacOS
code ~/Library/Application\ Support/Claude/claude_desktop_config.json

2. Add this to your config:

{
  "mcpServers": {
    "yfinance": {
      "command": "uv path like /Users/xxxxx/anaconda3/bin/uv",
      "args": [
        "--directory",
        "PATH/TO/FOLDER/yahoo-finance-mcp",
        "run",
        "server.py"
      ]
    }
  }
}

Example Prompts

Once connected, you can ask Claude things like:

• "What's the current price and info for AAPL?"

• "Get historical prices for MSFT over the last 6 months"

• "Show me the latest financial statements for GOOGL"

• "What's the latest news about NVDA?"

• "Get analyst recommendations for AMZN"

• "Show me options data for TSLA"

• "Compare the market cap and PE ratios of AAPL, MSFT, and GOOGL"

• "What's the current market summary for major indices?"

• "Who are the major institutional holders of AAPL?"

• "Show me recent insider transactions for MSFT"

• "When is the next earnings date for AAPL?"

• "What's the dividend history and yield for MSFT?"

• "Analyze AAPL's balance sheet metrics and trends"

• "Show me GOOGL's cash flow analysis"

• "What are the key financial ratios for NVDA?"

Example Outputs

Ask for permission:
What Claude returns: