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 |
| Commodities & forex | Yes | 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 |
Commodities & Forex Tools (Polygon.io Only)
These tools use Polygon's forex ticker format: C:XAUUSD (gold), C:XAGUSD (silver), C:CLUSD (crude oil WTI), C:BRUSD (Brent oil), C:NGUSD (natural gas), C:EURUSD (EUR/USD forex).
get_commodity_quotes
Get current prices for commodities, forex pairs, and precious metals.
| Parameter | Type | Required | Description |
|---|---|---|---|
symbols | array | Yes | Array of commodity/forex tickers (e.g., ["C:XAUUSD", "C:BRUSD"]) |
get_commodity_history
Get historical daily price data for commodities, forex pairs, and precious metals.
| Parameter | Type | Required | Description |
|---|---|---|---|
symbol | string | Yes | Commodity/forex ticker (e.g., C:XAUUSD) |
days | number | No | Number of days of history (default: 30, max: 365) |
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