MCP Polygon Server

Financial market data, technical indicators, and SEC filings service powered by the Polygon.io API. Provides OHLCV candles, real-time snapshots, SMA/EMA/RSI/MACD indicators, SEC filing search and AI-parsed text, and market movers.

View on mpak registry | Built by NimbleBrain

Tools

• get_candles — OHLCV price candles for a ticker over a date range
• get_snapshot — Current price snapshot and day stats
• get_technical_indicator — SMA, EMA, RSI, or MACD for a ticker
• get_sec_filing — Search SEC filings by ticker and type
• get_sec_filing_section — Read AI-parsed text from a specific filing section
• get_ticker_details — Company reference data (name, SIC, market cap, employees)
• get_top_movers — Top gaining or losing stocks

Configuration

Required Environment Variables

• POLYGON_API_KEY — Your Polygon.io API key from polygon.io/dashboard

Development

Requirements

• Python 3.13+
• FastMCP 2.14.1+
• uv (for dependency management)
• Polygon.io API key (Starter tier recommended, $29/mo)

Setup

# Install dependencies
uv sync

# Set your API key
export POLYGON_API_KEY="your_api_key_here"

# Run tests
make test

# Run all checks (format, lint, test)
make check

# Run server locally
make run

Available Make Targets

make help          # Show all targets
make check         # Format check + lint + test
make test          # Run unit tests
make test-e2e      # Run e2e MCPB container tests
make run           # Run in stdio mode
make run-http      # Run HTTP server with uvicorn
make bump VERSION=0.2.0  # Bump version across all files

Polygon.io API

This server uses the Polygon.io API (now Massive.com). The Stocks Starter tier ($29/mo) provides:

• 5 years of OHLCV history (minute to yearly resolution)
• Unlimited API calls
• Real-time snapshots and technical indicators
• SEC filings with AI-parsed text sections
• Market movers (top gainers/losers)

License

MIT