npm package: @pullapi/yahoo-finance-scraper-mcp
Description: Yahoo Finance MCP server — stock quotes, historical data, financials, earnings, options & news. For Claude, Cursor & AI agents.
Latest version: 1.0.0

# 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](https://rapidapi.com/pullapi/api).

## Usage with Claude Desktop

Add to your `claude_desktop_config.json`:

```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`):

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

## License

MIT