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)

🛠️ 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: