Yahoo Finance MCP Server

A Model Context Protocol (MCP) server that provides financial market data from Yahoo Finance. Integrate real-time stock quotes, market data, and historical stock information with Claude and other MCP-compatible assistants, without requiring API keys.

Visualization and Analysis Capabilities

This MCP server enables powerful financial data visualization and analysis through Claude:

Market Sentiment Analysis Dashboard showing real-time index performance, fear/greed indicators, and historical trends

Track your tech portfolio performance with detailed metrics and visualizations

Deep dive technical analysis with price trends, moving averages, and performance insights

Features

• Stock Quotes: Get current stock price, change, range, volume, and other key metrics
• Market Indices: Retrieve data for major market indices like S&P 500, Dow Jones, NASDAQ
• Historical Data: Fetch and analyze historical stock data with customizable time periods and intervals
• Rate limiting: Built-in rate limiting to ensure reliable access to Yahoo Finance
• Sentiment Analysis: Visualize market sentiment with fear/greed indicators and trend analysis
• Portfolio Tracking: Monitor your investment portfolio performance over time
• Technical Analysis: Access moving averages, price trends, and performance metrics
• Visual Dashboards: Generate comprehensive financial dashboards for better insights

Installation

Using Docker (Recommended)

The most reliable way to run the server is using Docker:

# Clone the repository
git clone https://github.com/jasontoo/yahoofinance-mcp.git
cd yahoofinance-mcp

# Build the Docker image
docker build -t yahoofinance-mcp .

# Run the container
docker run -i --rm yahoofinance-mcp

Integration with Claude Desktop

1. Download and install Claude Desktop
2. Create or edit the Claude Desktop configuration file:

• Mac: ~/Library/Application Support/Claude/claude_desktop_config.json
• Windows: %APPDATA%\Claude\claude_desktop_config.json

3. Add the Yahoo Finance server configuration using your preferred method:

Docker Option (Recommended)

{
  "mcpServers": {
   "yahoofinance": {
    "command": "docker",
    "args": [
      "run",
      "-i",
      "--rm",
      "yahoofinance-mcp"
    ]
   }
  }
}

4. Save the file and restart Claude Desktop

Available Tools

yahoo_stock_quote

Gets current stock quote information from Yahoo Finance.

Parameters:

• symbol: Stock ticker symbol (e.g., AAPL, MSFT, TSLA)

Example output:

Symbol: AAPL
Name: Apple Inc.
Price: $196.34
Change: $1.67 (0.86%)
Previous Close: $194.67
Open: $195.01
Day Range: $194.14 - $197.21
52 Week Range: $124.17 - $197.21
Volume: 54,364,985