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.

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

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

Using npm (Coming Soon)

Once published to npm, you'll be able to run the server directly with:

npx @elektrothing/server-yahoofinance

From Source

To run from source:

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

# Install dependencies
npm install

# Build the project
npm run build

# Run the server
npm start

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"
      ]
    }
  }
}

NPM Option (Once Published)

{
  "mcpServers": {
    "yahoofinance": {
      "command": "npx",
      "args": [
        "-y",
        "@elektrothing/server-yahoofinance"
      ]
    }
  }
}

From Source Option

{
  "mcpServers": {
    "yahoofinance": {
      "command": "node",
      "args": [
        "/absolute/path/to/yahoofinance-mcp/dist/index.js"
      ]
    }
  }
}

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
Avg. Volume: 55,486,332
Market Cap: $3,026,858,790,912
P/E Ratio: 32.44
EPS: $6.05
Dividend Yield: 0.51%

yahoo_market_data

Gets current market data from Yahoo Finance for major indices.

Parameters:

• indices (optional): List of index symbols to fetch (default: ["^GSPC", "^DJI", "^IXIC"])

Example output:

S&P 500
Price: 5,069.76
Change: -75.62 (-1.47%)
Previous Close: 5,145.37
Day Range: 5,062.68 - 5,143.25

Dow Jones Industrial Average
Price: 38,150.30
Change: -532.43 (-1.38%)
Previous Close: 38,682.73
Day Range: 38,113.08 - 38,672.04

NASDAQ Composite
Price: 16,180.21
Change: -240.32 (-1.46%)
Previous Close: 16,420.52
Day Range: 16,111.78 - 16,405.25

yahoo_stock_history

Gets historical stock data from Yahoo Finance.

Parameters:

• symbol: Stock ticker symbol
• period (optional): Time period ("1d", "5d", "1mo", "3mo", "6mo", "1y", "2y", "5y", "10y", "ytd", "max")
• interval (optional): Data interval ("1m", "2m", "5m", "15m", "30m", "60m", "90m", "1h", "1d", "5d", "1wk", "1mo", "3mo")

Example output:

Historical data for AAPL (1mo, 1d intervals)
Currency: USD
Trading Period: 8/24/2023 to 9/25/2023

Date       | Open     | High     | Low      | Close    | Volume
-----------|----------|----------|----------|----------|------------
8/25/2023  | $181.21  | $181.82  | $180.3   | $181.72  | 38,324,242
8/30/2023  | $185.3   | $187.85  | $184.94  | $187.65  | 60,295,151
9/5/2023   | $188.28  | $189.98  | $187.61  | $189.7   | 45,768,330
9/11/2023  | $174.79  | $175.1   | $173.73  | $174.75  | 63,746,501
9/15/2023  | $175.83  | $176.1   | $173.82  | $175.01  | 93,033,436
9/21/2023  | $174.26  | $177.08  | $174.22  | $176.97  | 66,097,991
9/25/2023  | $175.03  | $176.97  | $173.35  | $176.08  | 63,523,374

Price Change: $-5.13 (-2.83%)

Example Prompts

Once the server is connected to Claude, you can ask questions like:

• "What's the current price of AAPL stock?"
• "How has Tesla stock performed over the past month?"
• "Show me the current values of major market indices."
• "What's the stock price history for MSFT over the last year?"
• "Compare the performance of GOOGL and AMZN over the past 3 months."
• "What's the 52-week range for NVDA?"
• "How has the S&P 500 performed today?"

Troubleshooting

If you encounter issues:

1. Claude Desktop Logs:

   • Check for errors: tail -n 20 -f ~/Library/Logs/Claude/mcp*.log

2. Server Connectivity:

   • Make sure Docker is running if using Docker
   • Verify your command paths if running from source
   • Ensure you have an active internet connection

3. Tool Execution Issues:

   • Verify ticker symbols are correct
   • Check if Yahoo Finance API might be rate-limiting requests
   • Wait a few minutes and try again if you see timeout errors

4. Config File Issues:

   • Make sure your claude_desktop_config.json is formatted correctly
   • Double-check all paths and commands
   • Restart Claude Desktop after making changes

Publishing (For Maintainers)

To publish the package to npm under the @elektrothing organization:

# Login to npm
npm login

# Make sure you're a member of the elektrothing organization
# If not, create it: npm org create elektrothing

# Add yourself to the organization (if needed)
# npm org add elektrothing your-npm-username owner

# Publish as a public package
npm publish --access public

Alternatively, if you want to publish without an organization scope, you can:

# Change the name in package.json to "server-yahoofinance" (without scope)
# Then publish
npm publish

License

This project is licensed under the MIT License - see the LICENSE file for details.