Polygon.io MCP Server

MCP server wrapping the Polygon.io Python SDK for stocks, options, forex, and crypto market data.

Installation

cd polygon_mcp
uv pip install -e .

Configuration

Set your Polygon.io API key as an environment variable:

export POLYGON_API_KEY="your_api_key_here"

Usage

Run directly

uv run polygon-mcp

MCP Configuration

Add to your MCP config (e.g., ~/.kiro/settings/mcp.json):

{
  "mcpServers": {
    "polygon": {
      "command": "uv",
      "args": ["--directory", "/path/to/polygon_mcp", "run", "polygon-mcp"],
      "env": {
        "POLYGON_API_KEY": "your_api_key_here"
      }
    }
  }
}

Available Tools

Stocks

• stocks_get_sma - Simple Moving Average

• stocks_get_ema - Exponential Moving Average

• stocks_get_rsi - Relative Strength Index

• stocks_get_macd - MACD

• stocks_get_trades - Trades for a date

• stocks_get_trades_v3 - Trades v3 API

• stocks_get_quotes - Quotes for a date

• stocks_get_quotes_v3 - NBBO quotes v3

• stocks_get_last_trade - Most recent trade

• stocks_get_last_quote - Most recent quote

• stocks_get_daily_open_close - Daily OHLCV

• stocks_get_aggregate_bars - Candles/bars

• stocks_get_grouped_daily_bars - Market-wide daily bars

• stocks_get_previous_close - Previous day OHLCV

• stocks_get_snapshot - Current snapshot

• stocks_get_snapshot_all - All snapshots

• stocks_get_current_price - Current price

• stocks_get_gainers_and_losers - Top movers

Options

• options_get_sma/ema/rsi/macd - Technical indicators

• options_get_trades - Option trades

• options_get_quotes - Option quotes

• options_get_last_trade - Most recent trade

• options_get_daily_open_close - Daily OHLCV

• options_get_aggregate_bars - Candles/bars

• options_get_previous_close - Previous day OHLC

• options_get_snapshot - Option snapshot

• options_build_symbol - Build option symbol

• options_parse_symbol - Parse option symbol

Forex

• forex_get_sma/ema/rsi/macd - Technical indicators

• forex_real_time_conversion - Currency conversion

• forex_get_historic_ticks - Historic ticks

• forex_get_quotes - NBBO quotes

• forex_get_last_quote - Last quote

• forex_get_aggregate_bars - Candles/bars

• forex_get_grouped_daily_bars - Market-wide daily

• forex_get_previous_close - Previous day OHLC

• forex_get_gainers_and_losers - Top movers

Crypto

• crypto_get_sma/ema/rsi/macd - Technical indicators

• crypto_get_historic_trades - Historic trades

• crypto_get_trades - Trades in time range

• crypto_get_last_trade - Last trade

• crypto_get_daily_open_close - Daily open/close

• crypto_get_aggregate_bars - Candles/bars

• crypto_get_grouped_daily_bars - Market-wide daily

• crypto_get_previous_close - Previous day OHLC

• crypto_get_snapshot_all - All snapshots

• crypto_get_snapshot - Single snapshot

• crypto_get_gainers_and_losers - Top movers

• crypto_get_level2_book - Order book

Reference

• reference_get_tickers - Query tickers

• reference_get_ticker_types - Ticker type mappings

• reference_get_ticker_details - Ticker details

• reference_get_option_contract - Option contract info

• reference_get_option_contracts - List option contracts

• reference_get_ticker_news - News articles

• reference_get_stock_dividends - Dividend history

• reference_get_stock_financials - SEC financials

• reference_get_stock_splits - Split history

• reference_get_market_holidays - Market holidays

• reference_get_market_status - Market status

• reference_get_conditions - Polygon conditions

• reference_get_exchanges - Exchange list