Stocks MCP Server
Access financial market data including quotes, history, and technical indicators
The Stocks MCP server provides real-time and historical financial market data. It supports two data providers: Polygon.io (recommended) and Finnhub.
Provider Comparison
| Feature | Polygon.io | Finnhub |
|---|---|---|
| Daily quotes and history | Yes | Yes |
| Technical indicators | Yes | Yes |
| Market movers | Yes | Yes |
| News | Yes | Yes |
| Intraday bars | Yes (Starter+ plan) | No |
| Real-time snapshots | Yes (Starter+ plan) | No |
| Intraday VWAP | Yes (Starter+ plan) | No |
| Intraday indicators | Yes (Starter+ plan) | No |
Polygon.io's Starter plan or higher is required for real-time and intraday data.
Setup
- Get an API key from Polygon.io or Finnhub.
- Go to Settings > MCP Servers > Add Server.
- Select Stocks.
- Choose your Provider (Polygon or Finnhub).
- Paste your API Key.
- Click Save.
Configure only one provider. If you need to switch providers, update the existing configuration.
Daily Data Tools
These tools work with both Polygon.io and Finnhub.
get_stock_quotes
Get current stock prices.
| Parameter | Type | Required | Description |
|---|---|---|---|
symbols | array | Yes | Array of ticker symbols (e.g., ["AAPL", "TSLA"]) |
get_stock_history
Get historical daily OHLCV (Open, High, Low, Close, Volume) data.
| Parameter | Type | Required | Description |
|---|---|---|---|
symbol | string | Yes | Ticker symbol |
from | string | Yes | Start date (YYYY-MM-DD) |
to | string | Yes | End date (YYYY-MM-DD) |
get_technical_indicators
Calculate technical indicators (RSI, SMA, EMA) on daily data.
| Parameter | Type | Required | Description |
|---|---|---|---|
symbols | array | Yes | Array of ticker symbols |
get_market_summary
Get prices for major indices (SPY, QQQ, DIA). No required parameters.
get_top_gainers
Get today's top gaining stocks. No required parameters.
get_top_losers
Get today's top losing stocks. No required parameters.
get_market_movers
Get combined top gainers and losers. No required parameters.
get_stock_news
Get recent news articles for stocks.
| Parameter | Type | Required | Description |
|---|---|---|---|
symbols | array | Yes | Array of ticker symbols |
get_ticker_details
Get company information, market cap, and sector.
| Parameter | Type | Required | Description |
|---|---|---|---|
symbol | string | Yes | Ticker symbol |
get_stock_fundamentals
Get fundamental data including P/E ratio, sector, and company description.
| Parameter | Type | Required | Description |
|---|---|---|---|
symbol | string | Yes | Ticker symbol |
Intraday Data Tools (Polygon.io Only)
These tools require a Polygon.io Starter plan or higher.
get_intraday_bars
Get OHLCV candle data at various intervals.
| Parameter | Type | Required | Description |
|---|---|---|---|
symbols | array | Yes | Array of ticker symbols |
interval | string | No | Candle interval: 1min, 5min, 15min, 30min, 1hour |
get_realtime_snapshot
Get real-time price data including pre-market and after-hours pricing.
| Parameter | Type | Required | Description |
|---|---|---|---|
symbols | array | Yes | Array of ticker symbols |
get_intraday_vwap
Get today's Volume Weighted Average Price with analysis.
| Parameter | Type | Required | Description |
|---|---|---|---|
symbols | array | Yes | Array of ticker symbols |
get_intraday_indicators
Calculate RSI and EMA on intraday data (5-minute or 15-minute intervals).
| Parameter | Type | Required | Description |
|---|---|---|---|
symbols | array | Yes | Array of ticker symbols |
Example Workflow
A stock monitoring workflow:
- Trigger -- Cron schedule (every hour during market hours)
- Agent -- Check prices and indicators, tools:
stocks:get_stock_quotes,stocks:get_technical_indicators - Logic -- If RSI > 70 or RSI < 30 (overbought/oversold signal)
- Agent -- Generate alert message, tools:
telegram:send_message