Overview

The Polygon.io MCP Server provides AI assistants with institutional-grade market data through Polygon's powerful API. As one of the leading providers of stock market data, Polygon.io offers real-time and historical trades, quotes, and aggregates for stocks, options, forex, and crypto — with coverage across US and international markets.

Official MCP Server:

Maintained by the Polygon.io team — the official MCP server for the Polygon market data platform

Key Features

⚡

Real-Time Trades & Quotes

Stream real-time trade data and NBBO quotes for stocks and options with sub-second latency

📊

OHLCV Aggregates

Get open, high, low, close, and volume bars for any time window from 1 minute to 1 month

📋

Company Financials

Access detailed financial data including income statements, balance sheets, and cash flow reports

🔲

Options Data

Track options contracts, chains, and pricing data for equity and index options

📈

Market Snapshot

Get a comprehensive snapshot of market movers, gainers, losers, and most active stocks

🔍

Ticker Search

Search and discover ticker symbols with company details, types, and market identifiers

Available Tools

Quick Reference

Tool	Purpose
`get_stock_aggregates`	Get OHLCV aggregate bars for any ticker and time window
`get_trades`	Get real-time trade data for stock and options
`get_quotes`	Get NBBO quotes for equities and options
`get_financials`	Access company financial reports and metrics
`get_options_chain`	Get options contract data and pricing
`get_market_snapshot`	Get market movers, gainers, losers, and most active

Detailed Usage

get_stock_aggregates▶

Get OHLCV aggregate bars for any ticker and time window. Supports multiple timespans and multipliers.

{
  "symbol": "AAPL",
  "multiplier": 1,
  "timespan": "day",
  "from": "2025-01-01",
  "to": "2025-04-01"
}

get_financials▶

Access company financial reports including income statement, balance sheet, and cash flow data.

{
  "symbol": "MSFT",
  "statement_type": "income_statement",
  "filing_period": "annual"
}

get_options_chain▶

Get option contract data including strike prices, expiration dates, and contract details.

{
  "symbol": "SPY",
  "expiration_date": "2025-05-16"
}

get_market_snapshot▶

Get a comprehensive market snapshot including top gainers, losers, and most active stocks.

{}

Installation

{
  "mcpServers": {
    "polygon": {
      "command": "uvx",
      "args": ["mcp-polygon"],
      "env": {
        "POLYGON_API_KEY": "your_polygon_api_key"
      }
    }
  }
}

API Key Required:

Use Cases

Technical Charting

Ask AI to pull aggregate price data and identify chart patterns, support/resistance levels, and trends.

Options Analysis

Have AI analyze options chains, calculate implied volatility, and identify unusual options activity.

Earnings Analysis

Pull company financials and have AI summarize earnings trends, margins, and growth metrics.

Market Scanning

Scan for market movers, identify sector rotation, and surface unusual trading activity.

Polygon.io MCP Server