Skip to main content
Glama
keisku

yfinance-mcp

by keisku

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.

Parameter

Type

Required

Description

symbol

string

yes

Ticker symbol (e.g. AAPL, 7203.T)

interval

string

yes

Bar granularity (1m3mo)

start

string

yes

Start date (YYYY-MM-DD)

end

string

yes

End date (YYYY-MM-DD)

adjust

bool

no

Return split/dividend-adjusted prices

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.

Parameter

Type

Required

Description

symbol

string

yes

Ticker symbol (e.g. AAPL, 7203.T)

start

string

yes

Start date (YYYY-MM-DD)

end

string

yes

End date (YYYY-MM-DD)

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.

Parameter

Type

Required

Description

symbol

string

yes

Ticker symbol (e.g. AAPL, 7203.T)

start

string

yes

Start date (YYYY-MM-DD)

end

string

yes

End date (YYYY-MM-DD)

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.

Parameter

Type

Required

Description

symbol

string

yes

Ticker symbol (e.g. AAPL, 7203.T)

start

string

yes

Start date (YYYY-MM-DD)

end

string

yes

End date (YYYY-MM-DD)

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

Related MCP server: Stockflow MCP Server

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

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Enables retrieval of comprehensive financial data from Yahoo Finance, including stock prices, company info, financial statements, options, and news, for stock analysis and market research.
    9
    351
    MIT
  • A
    license
    A
    quality
    D
    maintenance
    Provides comprehensive financial data and analysis tools using Yahoo Finance, including real-time stock data, historical data with technical indicators, options chains, and financial statements.
    3
    MIT
  • A
    license
    Not graded
    quality
    B
    maintenance
    Provides TradingView-style market analysis with OHLCV candles, 19 technical indicators, a screener, and a backtester using public Yahoo Finance data without API keys.
    MIT
  • F
    license
    Not graded
    quality
    C
    maintenance
    Enables financial analysis by fetching real market data from Yahoo Finance, computing moving averages, returns, and volatility, and generating price charts.
    -