The Polygon.io MCP Server provides an LLM-friendly interface to access comprehensive financial market data through Polygon.io API endpoints as MCP tools. Key capabilities include:
• Market Data & Trading: OHLC aggregates/bars for stocks, options, forex, and crypto; real-time and historical trades and quotes; daily open/close data with customizable time windows • Market Snapshots: Current snapshots for individual tickers, option contracts, crypto order books, entire markets, and gainers/losers across all asset types • Reference Data: Ticker details, supported symbols and types, company information, exchanges, and market conditions • Corporate Actions & Fundamentals: Historical dividends, stock splits, earnings data, financial statements, and fundamental company metrics • Economic & Alternative Data: Treasury yields, inflation data, economic indicators, short interest, and short volume metrics • Benzinga Integration: Analyst ratings, insights, earnings estimates, consensus data, firm details, guidance, and market commentary • Futures Markets: Contracts, quotes, trades, products, trading schedules, market status, and snapshots for futures • News & Research: Ticker-specific news articles, market research, and IPO information (upcoming and historical) • Market Operations: Trading hours, market holidays, and current exchange operating status
The server supports filtering by date ranges, tickers, market types, and various parameters, making it suitable for both real-time market monitoring and historical financial analysis.
Provides access to comprehensive financial market data from Polygon.io, including stock/options/forex/crypto aggregates, real-time and historical trades, market snapshots, ticker details, dividends data, and financial fundamentals.
: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
For existing installs, check that you have a version that supports the
uvx
command.
Claude Code
First, install 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
.
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.
Path find your path to
uvx
, runwhich uvx
in your terminal.Replace
<your_api_key_here>
with your actual Polygon.io API key.Replace
<your_home_directory>
with your home directory path, e.g.,/home/username
(Mac/Linux) orC:\Users\username
(Windows).
Usage Examples
Once integrated, you can prompt Claude to access Polygon.io data:
Available Tools
This MCP server implements all Polygon.io API endpoints as tools, including:
get_aggs
- Stock aggregates (OHLC) data for a specific tickerlist_trades
- Historical trade dataget_last_trade
- Latest trade for a symbollist_ticker_news
- Recent news articles for tickersget_snapshot_ticker
- Current market snapshot for a tickerget_market_status
- Current market status and trading hourslist_stock_financials
- Fundamental financial dataAnd 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.
Debugging
For debugging and testing, we recommend using the MCP Inspector:
This will launch a browser interface where you can interact with your MCP server directly and see input/output for each tool.
Links
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.
remote-capable server
The server can be hosted and run remotely because it primarily relies on remote services or has no dependency on the local environment.
Tools
Polygon-io MCP Server
Related MCP Servers
- Apache 2.0
- MIT License
- MIT License