yfinance-mcp

An MCP server that exposes Yahoo Finance market data to LLM agents.

Tools

history

Returns OHLCV price bars for a given symbol and date range.

Response columns: t (timestamps), o, h, l, c, v, and ac (adjusted close, when adjust=true).

oscillator

Returns daily momentum oscillators for a given symbol and date range. Warmup data is fetched automatically so indicators are valid from the first returned date.

Response columns: t, rsi, stoch_k, stoch_d.

trend

Returns daily trend-following indicators for a given symbol and date range. Warmup data is fetched automatically so indicators are valid from the first returned date.

Response columns: t, sma_20, sma_50, sma_200, ema_20, ema_50, ema_200, macd, macd_signal, macd_hist, plus_di, minus_di, adx.

volume

Returns daily volume moving averages for a given symbol and date range. Warmup data is fetched automatically so indicators are valid from the first returned date.

Response columns: t, volume, vol_sma_5, vol_sma_10, vol_sma_20, vol_sma_50.

Related MCP server: yahoo-finance-mcp

Setup

Requires Python 3.13+.

uv sync

Usage

Claude Code

Add to ~/.claude/settings.json:

{
  "mcpServers": {
    "yfinance": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/yfinance-mcp", "python", "server.py"]
    }
  }
}

Claude Desktop

Add to your Claude Desktop config:

{
  "mcpServers": {
    "yfinance": {
      "command": "uv",
      "args": ["run", "--directory", "/path/to/yfinance-mcp", "python", "server.py"]
    }
  }
}

License

MIT