yfinance-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@yfinance-mcpShow me the historical prices for AAPL for the last 5 days"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
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 |
| string | yes | Ticker symbol (e.g. |
| string | yes | Bar granularity ( |
| string | yes | Start date ( |
| string | yes | End date ( |
| 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 |
| string | yes | Ticker symbol (e.g. |
| string | yes | Start date ( |
| string | yes | End 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.
Parameter | Type | Required | Description |
| string | yes | Ticker symbol (e.g. |
| string | yes | Start date ( |
| string | yes | End 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.
Parameter | Type | Required | Description |
| string | yes | Ticker symbol (e.g. |
| string | yes | Start date ( |
| string | yes | End date ( |
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 syncUsage
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
This server cannot be deployed
Maintenance
Related MCP Connectors
Scrape stock quotes, historical prices, and financial statements from Yahoo Finance.
Live market data, financial analysis, and portfolio research tools across 10,000+ tickers.
9,900+ US equities, 64 years of prices, financials, technicals, and earnings. Ask in plain English.
Real-time market data, screeners, technical analysis & backtesting for stocks, crypto and forex.
Related MCP Servers
- AlicenseAqualityDmaintenanceEnables retrieval of comprehensive financial data from Yahoo Finance, including stock prices, company info, financial statements, options, and news, for stock analysis and market research.9351MIT
- AlicenseAqualityDmaintenanceProvides comprehensive financial data and analysis tools using Yahoo Finance, including real-time stock data, historical data with technical indicators, options chains, and financial statements.3MIT
- AlicenseNot gradedqualityBmaintenanceProvides TradingView-style market analysis with OHLCV candles, 19 technical indicators, a screener, and a backtester using public Yahoo Finance data without API keys.MIT
- FlicenseNot gradedqualityCmaintenanceEnables financial analysis by fetching real market data from Yahoo Finance, computing moving averages, returns, and volatility, and generating price charts.-