Polygon-io MCP Server

Important

:test_tube: This project is experimental and could be subject to breaking changes.

Polygon.io MCP Server

A Model Context Protocol (MCP) server that provides access to Polygon.io financial market data API through an LLM-friendly interface.

Overview

This server exposes all Polygon.io API endpoints as MCP tools, providing access to comprehensive financial market data including:

Stock, options, forex, and crypto aggregates and bars
Real-time and historical trades and quotes
Market snapshots
Ticker details and reference data
Dividends and splits data
Financial fundamentals
Market status and holidays

Installation

Prerequisites

Python 3.10+
A Polygon.io API key
Astral UV
- For existing installs, check that you have a version that supports the uvx command.

Claude Code

First, install Claude Code

npm install -g @anthropic-ai/claude-code

Use the following command to add the Polygon MCP server to your local environment. This assumes uvx is in your $PATH; if not, then you need to provide the full path to uvx.

# Claude CLI
claude mcp add polygon -e POLYGON_API_KEY=your_api_key_here -- uvx --from git+https://github.com/polygon-io/mcp_polygon@v0.1.0 mcp_polygon

This command will install the MCP server in your current project. If you want to install it globally, you can run the command with -s <scope> flag. See claude mcp add --help for more options.

To start Claude Code, run claude in your terminal.

If this is your first time using, follow the setup prompts to authenticate

You can also run claude mcp add-from-claude-desktop if the MCP server is installed already for Claude Desktop.

Claude Desktop

Follow the Claude Desktop MCP installation instructions to complete the initial installation and find your configuration file.
Use the following example as reference to add Polygon's MCP server. Make sure you complete the various fields.
1. Path find your path to uvx, run which uvx in your terminal.
2. Replace <your_api_key_here> with your actual Polygon.io API key.
3. Replace <your_home_directory> with your home directory path, e.g., /home/username (Mac/Linux) or C:\Users\username (Windows).

{
    "mcpServers": {
        "polygon": {
            "command": "<path_to_your_uvx_install>/uvx",
            "args": [
                "--from",
                "git+https://github.com/polygon-io/mcp_polygon@v0.1.0",
                "mcp_polygon"
            ],
            "env": {
                "POLYGON_API_KEY": "<your_api_key_here>",
                "HOME": "<your_home_directory>"
            }
        }
    }
}

Usage Examples

Once integrated, you can prompt Claude to access Polygon.io data:

Get the latest price for AAPL stock
Show me yesterday's trading volume for MSFT
What were the biggest stock market gainers today?
Get me the latest crypto market data for BTC-USD

Available Tools

This MCP server implements all Polygon.io API endpoints as tools, including:

get_aggs - Stock aggregates (OHLC) data for a specific ticker
list_trades - Historical trade data
get_last_trade - Latest trade for a symbol
list_ticker_news - Recent news articles for tickers
get_snapshot_ticker - Current market snapshot for a ticker
get_market_status - Current market status and trading hours
list_stock_financials - Fundamental financial data
And many more...

Each tool follows the Polygon.io SDK parameter structure while converting responses to standard JSON that LLMs can easily process.

Development

Running Locally

Check to ensure you have the Prerequisites installed.

# Sync dependencies
uv sync

# Run the server
POLYGON_API_KEY=your_api_key_here uv run mcp_polygon

  "mcpServers": {
    "polygon": {
      "command": "/your/path/.cargo/bin/uv",
      "args": [
        "run",
        "--with",
        "/your/path/mcp_polygon",
        "mcp_polygon"
      ],
      "env": {
        "POLYGON_API_KEY": "your_api_key_here",
        "HOME": "/Users/danny"
      }
    }
  }

Debugging

For debugging and testing, we recommend using the MCP Inspector:

npx @modelcontextprotocol/inspector uv --directory /path/to/mcp_polygon run mcp_polygon

This will launch a browser interface where you can interact with your MCP server directly and see input/output for each tool.

Contributing

If you found a bug or have an idea for a new feature, please first discuss it with us by submitting a new issue. We will respond to issues within at most 3 weeks. We're also open to volunteers if you want to submit a PR for any open issues but please discuss it with us beforehand. PRs that aren't linked to an existing issue or discussed with us ahead of time will generally be declined.

Polygon-io MCP Server