Polygon-io MCP Server
OfficialThe 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.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@Polygon-io MCP Server get the latest price for AAPL stock"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
:test_tube: This project is experimental and could be subject to breaking changes.
Massive.com MCP Server
A Model Context Protocol (MCP) server that provides access to the full Massive.com financial data API through an LLM-friendly interface.
Rather than exposing one tool per endpoint, this server gives the LLM three composable tools — search, call, and query — that cover the entire Massive.com API surface. Data can be stored in an in-memory SQLite database, and enriched with built-in financial functions.
Don't want to install anything? Massive hosts this server athttps://mcp.massive.com.
See the AI Tools quickstart for setup in each client.
Tools
Tool | Description |
| Search for API endpoints and built-in functions by natural language query. Returns titles, path patterns, and descriptions. Set |
| Call any Massive.com REST API endpoint. Supports storing results as an in-memory database table ( |
| Run SQL against stored SQLite DB. Supports |
Built-in Functions
Functions can be applied to API results or query output via the apply parameter on call_api and query_data. Use search_endpoints with scope="functions" to discover them.
Category | Functions |
Greeks |
|
Returns |
|
Technical |
|
Data Coverage
The server dynamically indexes all Massive.com API endpoints at startup from llms.txt, so it automatically stays in sync with the API. Coverage includes:
Stock, options, forex, crypto, and futures aggregates
Real-time and historical trades and quotes
Market snapshots, gainers/losers
Ticker details and reference data
Dividends, splits, IPOs
Financial fundamentals
Analyst ratings and news (Benzinga)
Treasury yields, inflation data
Market status and holidays
Related MCP server: market-data-mcp
Installation
Prerequisites
Python 3.12+
A Massive.com API key
Astral UV (v0.4.0+)
Claude Code
First, install Claude Code
npm install -g @anthropic-ai/claude-codeInstall the MCP server, then register it with Claude Code:
# Install the server (one-time — downloads dependencies ahead of time)
uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.10.0"
# Register with Claude Code
claude mcp add massive -e MASSIVE_API_KEY=your_api_key_here -- mcp_massiveTo upgrade to a new version later:
uv tool upgrade mcp_massiveUpgrading from uvx or uv run --with? Previous versions recommended uvx --from ... mcp_massive or uv run --with. These commands download dependencies on every cold start, which can cause the server to exceed Claude's 30-second connection timeout. Switch to uv tool install as shown above — it downloads dependencies once and starts instantly after that.
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.
Install the server:
uv tool install "mcp_massive @ git+https://github.com/massive-com/mcp_massive@v0.10.0"Find the installed binary path:
# Mac/Linux
which mcp_massive
# Windows
where mcp_massiveAdd the server to your Claude Desktop config. Replace
<path_to_mcp_massive>with the output from the previous step, and fill in the remaining fields.
{
"mcpServers": {
"massive": {
"command": "<path_to_mcp_massive>",
"env": {
"MASSIVE_API_KEY": "<your_api_key_here>",
"HOME": "<your_home_directory>"
}
}
}
}Configuration
Environment Variables
Variable | Required | Default | Description |
| Yes | — | Your Massive.com API key |
| No | — | Deprecated alias for |
| No |
| Transport protocol: |
| No |
| Base URL for API requests |
| No |
| URL for the endpoint index |
| No |
| Maximum number of in-memory tables |
| No |
| Maximum rows per stored tables |
Transport
By default, STDIO transport is used. The transport can be set via the --transport CLI argument or the MCP_TRANSPORT environment variable (CLI argument takes precedence).
# CLI argument
MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massive --transport streamable-http
# Environment variable
MCP_TRANSPORT=streamable-http MASSIVE_API_KEY=<your_api_key_here> uv run mcp_massiveUsage Examples
Once integrated, you can prompt Claude to access Massive.com 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
Calculate the 20-day SMA for AAPL closing prices over the last 3 months
Compute Black-Scholes delta for these option contractsDevelopment
Running Locally
Check to ensure you have the Prerequisites installed.
# Sync dependencies
uv sync
# Run the server
MASSIVE_API_KEY=your_api_key_here uv run mcp_massiveInstall from your local checkout, then reference the binary directly:
uv tool install --force /path/to/mcp_massive{
"mcpServers": {
"massive": {
"command": "mcp_massive",
"env": {
"MASSIVE_API_KEY": "your_api_key_here"
}
}
}
}Debugging
For debugging and testing, we recommend using the MCP Inspector:
npx @modelcontextprotocol/inspector uv --directory /path/to/mcp_massive run mcp_massiveThis will launch a browser interface where you can interact with your MCP server directly and see input/output for each tool.
Select the STDIO transport type in the browser UI with the command uv and run mcp_massive as the arguments.
Code Linting
This project uses just for common development tasks. To lint your code before submitting a PR:
just lintThis will run ruff format and ruff check --fix to automatically format your code and fix linting issues.
Links
Privacy Policy
This MCP server interacts with Massive.com's API to fetch market data. All data requests are subject to Massive.com's privacy policy and terms of service.
Massive.com Privacy Policy: https://massive.com/legal/privacy
Data Handling: This server does not store or cache any user data. All requests are proxied directly to Massive.com's API.
API Key: Your Massive.com API key is used only for authenticating requests to their API.
User-Agent: API requests include a User-Agent string containing the MCP server version (e.g.,
MCP-Massive/0.x.y). No personally identifiable information is included.
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.
Available Tools
53 toolsget_aggsC
List aggregate bars for a ticker over a given date range in custom time window sizes.
Inputs: from_ (required), multiplier (required), ticker (required), timespan (required), +5 more.
get_daily_open_close_aggC
Get daily open, close, high, and low for a specific ticker and date.
Inputs: date (required), ticker (required), adjusted, params.
get_exchangesC
List exchanges known by Polygon.io.
Inputs: asset_class, locale, params.
get_futures_contract_detailsC
Get details for a single futures contract at a specified point in time.
Inputs: ticker (required), as_of, params.
get_futures_product_detailsC
Get details for a single futures product as it was at a specific day.
Inputs: product_code (required), as_of, params, type.
get_futures_snapshotD
Get snapshots for futures contracts.
Inputs: limit, params, product_code, product_code_any_of, +11 more.
get_grouped_daily_aggsC
Get grouped daily bars for entire market for a specific date.
Inputs: date (required), adjusted, include_otc, locale, +2 more.
get_last_crypto_tradeC
Get the most recent trade for a crypto pair.
Inputs: from_ (required), to (required), params.
get_last_forex_quoteC
Get the most recent forex quote.
Inputs: from_ (required), to (required), params.
get_last_quoteC
Get the most recent quote for a ticker symbol.
Inputs: ticker (required), params.
get_last_tradeC
Get the most recent trade for a ticker symbol.
Inputs: ticker (required), params.
get_market_holidaysC
Get upcoming market holidays and their open/close times.
Inputs: params.
get_market_statusC
Get current trading status of exchanges and financial markets.
Inputs: params.
get_previous_close_aggC
Get previous day's open, close, high, and low for a specific ticker.
Inputs: ticker (required), adjusted, params.
get_real_time_currency_conversionC
Get real-time currency conversion.
Inputs: from_ (required), to (required), amount, params, +1 more.
get_snapshot_allC
Get a snapshot of all tickers in a market.
Inputs: market_type (required), include_otc, params, tickers.
get_snapshot_crypto_bookC
Get snapshot for a crypto ticker's order book.
Inputs: ticker (required), params.
get_snapshot_directionD
Get gainers or losers for a market.
Inputs: direction (required), market_type (required), include_otc, params.
get_snapshot_optionC
Get snapshot for a specific option contract.
Inputs: option_contract (required), underlying_asset (required), params.
get_snapshot_tickerC
Get snapshot for a specific ticker.
Inputs: market_type (required), ticker (required), params.
get_ticker_detailsC
Get detailed information about a specific ticker.
Inputs: ticker (required), date, params.
get_ticker_typesC
List all ticker types supported by Polygon.io.
Inputs: asset_class, locale, params.
list_aggsC
Iterate through aggregate bars for a ticker over a given date range.
Inputs: from_ (required), multiplier (required), ticker (required), timespan (required), +5 more.
list_benzinga_analyst_insightsD
List Benzinga analyst insights.
Inputs: benzinga_firm_id, benzinga_firm_id_any_of, benzinga_firm_id_gt, benzinga_firm_id_gte, +41 more.
list_benzinga_analystsD
List Benzinga analysts.
Inputs: benzinga_firm_id, benzinga_firm_id_any_of, benzinga_firm_id_gt, benzinga_firm_id_gte, +23 more.
list_benzinga_consensus_ratingsC
List Benzinga consensus ratings for a ticker.
Inputs: ticker (required), date, date_gt, date_gte, +4 more.
list_benzinga_earningsD
List Benzinga earnings.
Inputs: date, date_any_of, date_gt, date_gte, +53 more.
list_benzinga_firmsD
List Benzinga firms.
Inputs: benzinga_id, benzinga_id_any_of, benzinga_id_gt, benzinga_id_gte, +5 more.
list_benzinga_guidanceD
List Benzinga guidance.
Inputs: date, date_any_of, date_gt, date_gte, +41 more.
list_benzinga_newsD
List Benzinga news.
Inputs: author, author_any_of, author_gt, author_gte, +26 more.
list_benzinga_ratingsD
List Benzinga ratings.
Inputs: benzinga_analyst_id, benzinga_analyst_id_any_of, benzinga_analyst_id_gt, benzinga_analyst_id_gte, +53 more.
list_conditionsD
List conditions used by Polygon.io.
Inputs: asset_class, data_type, id, params, +1 more.
list_dividendsC
Get historical cash dividends.
Inputs: dividend_type, ex_dividend_date, frequency, limit, +2 more.
list_futures_aggregatesC
Get aggregates for a futures contract in a given time range.
Inputs: resolution (required), ticker (required), limit, params, +6 more.
list_futures_contractsC
Get a paginated list of futures contracts.
Inputs: active, as_of, first_trade_date, last_trade_date, +5 more.
list_futures_market_statusesC
Get market statuses for futures products.
Inputs: limit, params, product_code, product_code_any_of, +1 more.
list_futures_productsC
Get a list of futures products (including combos).
Inputs: as_of, asset_class, asset_sub_class, limit, +8 more.
list_futures_quotesC
Get quotes for a futures contract in a given time range.
Inputs: ticker (required), limit, params, session_end_date, +10 more.
list_futures_schedulesC
Get trading schedules for multiple futures products on a specific date.
Inputs: limit, params, session_end_date, sort, +1 more.
list_futures_schedules_by_product_codeC
Get schedule data for a single futures product across many trading dates.
Inputs: product_code (required), limit, params, session_end_date, +5 more.
list_futures_tradesC
Get trades for a futures contract in a given time range.
Inputs: ticker (required), limit, params, session_end_date, +10 more.
list_inflationC
Get inflation data from the Federal Reserve.
Inputs: date, date_any_of, date_gt, date_gte, +5 more.
list_iposC
Retrieve upcoming or historical IPOs.
Inputs: ipo_status, limit, listing_date, listing_date_gt, +7 more.
list_quotesC
Get quotes for a ticker symbol.
Inputs: ticker (required), limit, order, params, +6 more.
list_short_interestC
Retrieve short interest data for stocks.
Inputs: limit, order, params, settlement_date, +6 more.
list_short_volumeC
Retrieve short volume data for stocks.
Inputs: date, date_gt, date_gte, date_lt, +6 more.
list_splitsC
Get historical stock splits.
Inputs: execution_date, limit, params, reverse_split, +1 more.
list_stock_financialsC
Get fundamental financial data for companies.
Inputs: cik, company_name, company_name_search, filing_date, +17 more.
list_ticker_newsC
Get recent news articles for a stock ticker.
Inputs: limit, order, params, published_utc, +2 more.
list_tickersC
Query supported ticker symbols across stocks, indices, forex, and crypto.
Inputs: active, cik, cusip, date, +9 more.
list_tradesC
Get trades for a ticker symbol.
Inputs: ticker (required), limit, order, params, +6 more.
list_treasury_yieldsD
Retrieve treasury yield data.
Inputs: date, date_any_of, date_gt, date_gte, +6 more.
list_universal_snapshotsC
Get universal snapshots for multiple assets of a specific type.
Inputs: type (required), limit, order, params, +2 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 53 tools
Most tools have distinct purposes targeting specific asset classes (e.g., stocks, crypto, futures) or data types (e.g., aggregates, snapshots, lists), with clear boundaries. However, some overlap exists between similar 'list' and 'get' functions (e.g., list_aggs vs get_aggs) that could cause minor confusion, though descriptions help differentiate them.
Tool names follow a highly consistent verb_noun pattern throughout, using 'get_' for single-item retrieval and 'list_' for collections, with clear and descriptive nouns (e.g., get_ticker_details, list_futures_contracts). There are no deviations in naming conventions, making the set predictable and readable.
With 53 tools, the count is excessive for a single server, making it overwhelming and difficult for agents to navigate efficiently. While the domain (financial data) is broad, this many tools suggests poor scoping and could lead to usability issues, as typical well-scoped servers have 3-15 tools.
The tool surface provides comprehensive coverage for financial data retrieval, including stocks, crypto, forex, futures, and market metadata, with full CRUD-like operations (mostly read/list functions) and no apparent gaps. It supports diverse workflows from real-time quotes to historical analysis and auxiliary data like news or holidays.
Maintenance
Related MCP Connectors
MCP Server for an Agent Task Marketplace
Trading MCP server for AI agents, with live market data, account reads and controlled execution.
Multi-tenant FastMCP server for Charles Schwab brokerage data, monetized via DPYC Tollbooth
Related MCP Servers
- AlicenseBqualityDmaintenanceHigh-performance CCXT MCP server for cryptocurrency exchange integration2494 npm145MIT
- -licenseNot gradedqualityNot gradedmaintenanceReal-time financial market data MCP server. Stocks, crypto, technicals, sentiment, FDA calendar. No API keys required.-
- AlicenseAqualityBmaintenanceMCP Server for publicly available real-time Indian Mutual Funds data128MIT
- FlicenseAqualityDmaintenanceExtensible trading-intelligence MCP server with diagnostic tools, structured logging, and tool registration; currently provides server info tool with plans for market data adapters.1-