Yahoo Finance MCP Server


A Model Context Protocol (MCP) server that provides access to Yahoo Finance data including stock quotes, historical prices, financial statements, company information, symbol search, and news.

Installation

$3

``bash
claude mcp add yfinance-mcp -- npx yfinance-mcp
`

$3

Add to your claude_desktop_config.json:

`json
{
"mcpServers": {
"yfinance-mcp": {
"command": "npx",
"args": ["yfinance-mcp"]
}
}
}
`

Available Tools

$3

Get real-time stock quote data including price, change, volume, and key metrics.

Parameters:
- symbol (string, required): Stock ticker symbol (e.g., "AAPL", "GOOGL")

Example response:
`json
{
"symbol": "AAPL",
"name": "Apple Inc.",
"price": 273.08,
"change": -0.68,
"changePercent": -0.25,
"volume": 20667651,
"marketCap": 4052613332992,
"peRatio": 36.56
}
`

$3

Get historical OHLCV (Open, High, Low, Close, Volume) price data.

Parameters:
- symbol (string, required): Stock ticker symbol
- period (string, optional): Time period - "1d", "5d", "1mo", "3mo", "6mo", "1y", "2y", "5y", "max" (default: "1mo")
- interval (string, optional): Data interval - "1d", "1wk", "1mo" (default: "1d")

$3

Get company financial statements (income statement, balance sheet, or cash flow).

Parameters:
- symbol (string, required): Stock ticker symbol
- statement (string, required): Type of statement - "income", "balance", "cashflow"
- quarterly (boolean, optional): Get quarterly data instead of annual (default: false)

$3

Get company profile including sector, industry, description, and key statistics.

Parameters:
- symbol (string, required): Stock ticker symbol

$3

Search for stock symbols by company name or keywords.

Parameters:
- query (string, required): Search query (company name or keywords)

$3

Get latest news for a stock symbol.

Parameters:
- symbol (string, required): Stock ticker symbol

Development

$3

`bash
pnpm dev
`

$3

`bash
pnpm test # Run tests in watch mode
pnpm test -- --run # Run tests once
`

$3

`bash
pnpm test:coverage
`

$3

`bash
pnpm lint # Check for linting errors
pnpm lint:fix # Fix linting errors
pnpm format # Format code with Prettier
`

$3

`bash
pnpm build
`

Tech Stack

- TypeScript
- MCP SDK (@modelcontextprotocol/sdk`)
- yahoo-finance2
- Zod for input validation
- Vitest for testing
- ESLint + Prettier for code quality

License

MIT