Yahoo Finance Scraper MCP Server

An MCP server that provides real-time Yahoo Finance data — stock quotes, historical prices, financial statements, earnings, analyst recommendations, options chains, and news — for use with Claude, Cursor, and other MCP-compatible AI tools.

Features

• Get Quote — Get real-time stock quote including price, change, volume, and market cap
• Get Historical — Get historical price data for a stock with configurable range and interval
• Get Financials — Get company financial statements including income, balance sheet, and cash flow
• Get Earnings — Get company earnings data including EPS history and estimates
• Get Analyst — Get analyst recommendations and price targets for a stock
• Get Options — Get options chain data for a stock
• Get News — Get latest news articles related to a stock

Tools

get_quote

Get real-time stock quote including price, change, volume, and market cap

Parameters:

| Name | Type | Required | Description | |------|------|----------|-------------| | symbol | string | Yes | Stock ticker symbol (e.g. 'AAPL', 'MSFT') |

get_historical

Get historical price data for a stock with configurable range and interval

Parameters:

| Name | Type | Required | Description | |------|------|----------|-------------| | symbol | string | Yes | Stock ticker symbol | | range | string | No | Time range (default: 1mo) — one of: 1d, 5d, 1mo, 3mo, 6mo, 1y, 2y, 5y, 10y, ytd, max | | interval | string | No | Data interval (default: 1d) — one of: 1m, 5m, 15m, 1h, 1d, 1wk, 1mo |

get_financials

Get company financial statements including income, balance sheet, and cash flow

Parameters:

| Name | Type | Required | Description | |------|------|----------|-------------| | symbol | string | Yes | Stock ticker symbol |

get_earnings

Get company earnings data including EPS history and estimates

Parameters:

| Name | Type | Required | Description | |------|------|----------|-------------| | symbol | string | Yes | Stock ticker symbol |

get_analyst

Get analyst recommendations and price targets for a stock

Parameters:

| Name | Type | Required | Description | |------|------|----------|-------------| | symbol | string | Yes | Stock ticker symbol |

get_options

Get options chain data for a stock

Parameters:

| Name | Type | Required | Description | |------|------|----------|-------------| | symbol | string | Yes | Stock ticker symbol | | expiration | string | No | Options expiration date (YYYY-MM-DD) |

get_news

Get latest news articles related to a stock

Parameters:

| Name | Type | Required | Description | |------|------|----------|-------------| | symbol | string | Yes | Stock ticker symbol |

Configuration

Get your API key from RapidAPI.

Usage with Claude Desktop

Add to your claude_desktop_config.json:

{
  "mcpServers": {
    "yahoo-finance": {
      "command": "npx",
      "args": ["-y", "@pullapi/yahoo-finance-scraper-mcp"],
      "env": {
        "RAPIDAPI_KEY": "your-rapidapi-key"
      }
    }
  }
}

Usage with Cursor

Add to your Cursor MCP settings (.cursor/mcp.json):

{
  "mcpServers": {
    "yahoo-finance": {
      "command": "npx",
      "args": ["-y", "@pullapi/yahoo-finance-scraper-mcp"],
      "env": {
        "RAPIDAPI_KEY": "your-rapidapi-key"
      }
    }
  }
}

License

MIT