<p align="center">
  <img src="assets/image.png" alt="Yahoo Finance MCP Server" width="400">
</p>

# Yahoo Finance MCP Server

A remote MCP (Model Context Protocol) server for Yahoo Finance data, deployed on Cloudflare Workers.

## Features

- **9 tools** for accessing Yahoo Finance data
- **Cookie + Crumb authentication** for reliable API access
- **SSE and Streamable HTTP** transport support
- **Cloudflare Workers** deployment with Durable Objects

## Tools

| Tool | Description |
|------|-------------|
| `get_historical_stock_prices` | Get OHLCV data for a ticker |
| `get_stock_info` | Get comprehensive stock information |
| `get_yahoo_finance_news` | Get latest news for a ticker |
| `get_stock_actions` | Get dividends and stock splits |
| `get_financial_statement` | Get income statement, balance sheet, or cashflow |
| `get_holder_info` | Get institutional, insider, and major holders |
| `get_option_expiration_dates` | Get available option expiration dates |
| `get_option_chain` | Get calls/puts option chain |
| `get_recommendations` | Get analyst recommendations |

## Setup

```bash
npm install
```

## Development

```bash
npm run dev
```

Server runs at `http://localhost:5173`

## Deploy

```bash
npm run deploy
```

## Endpoints

| Endpoint | Description |
|----------|-------------|
| `/` | JSON documentation |
| `/sse` | MCP SSE transport |
| `/mcp` | MCP Streamable HTTP transport |

## Usage

### Claude Desktop

Add to your Claude Desktop config (`~/Library/Application Support/Claude/claude_desktop_config.json`):

```json
{
  "mcpServers": {
    "yahoo-finance": {
      "command": "npx",
      "args": ["mcp-remote", "https://your-worker.workers.dev/sse"]
    }
  }
}
```

### MCP Inspector

```bash
npx @modelcontextprotocol/inspector@latest
```

Connect to `http://localhost:5173/sse` (local) or `https://your-worker.workers.dev/sse` (deployed).

## Project Structure

```
src/
├── server.ts           # Worker entry point
├── mcp.ts              # MCP server with tool definitions
└── yahoo-finance-api.ts # Yahoo Finance API client
```

## License

MIT