README.md
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
npm install
Development
npm run dev
Server runs at http://localhost:5173
Deploy
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):
{
"mcpServers": {
"yahoo-finance": {
"command": "npx",
"args": ["mcp-remote", "https://your-worker.workers.dev/sse"]
}
}
}
MCP Inspector
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
Tools 9
get_historical_stock_pricesGet OHLCV data for a tickerget_stock_infoGet comprehensive stock informationget_yahoo_finance_newsGet latest news for a tickerget_stock_actionsGet dividends and stock splitsget_financial_statementGet income statement, balance sheet, or cashflowget_holder_infoGet institutional, insider, and major holdersget_option_expiration_datesGet available option expiration datesget_option_chainGet calls/puts option chainget_recommendationsGet analyst recommendationsTry it
→Get the latest stock information and analyst recommendations for AAPL.
→Show me the income statement for Microsoft (MSFT) for the last fiscal year.
→What are the upcoming option expiration dates for TSLA?
→Fetch the latest news headlines for NVIDIA.
→Get the historical OHLCV data for GOOGL for the past month.