# Polygon — how to use (mcp.ai)

Connect your Polygon account and use 90 tools for analytics straight from your AI agent. Connect with your own API key. Polygon.io provides real-time and historical market data APIs for stocks, options, forex, and cryptocurrencies.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_polygon?ms=1787293740000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `polygon_get_aggregates`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/polygon`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/polygon/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/polygon/get/aggregates` — Tool to fetch custom aggregate OHLCV bars for a stock. Use when you need historical price and volume data aggregated by custom intervals over a date range.
  - body: { to: string, sort?: string, from_: string, limit?: integer, ticker: string, adjusted?: boolean, timespan: string, multiplier: integer }
- `POST https://api.mcp.ai/api/polygon/get/all/tickers` — Tool to retrieve all ticker symbols across asset classes. Use when you need to filter by market or exchange and paginate through results. Without filters, result sets can be extremely large — always n
  - body: { sort?: string, limit?: integer, order?: string, active?: boolean, cursor?: string, market?: string, search?: string, ticker?: string, exchange?: string }
- `POST https://api.mcp.ai/api/polygon/get/condition/codes` — Tool to retrieve a unified list of trade and quote condition codes and their definitions. Use when needing to decode condition identifiers after fetching market data.
  - body: { id?: string, sort?: string, limit?: integer, order?: string, data_type?: string, asset_class?: string }
- `POST https://api.mcp.ai/api/polygon/get/crypto/aggregates` — Tool to retrieve aggregate bars for a cryptocurrency over a time range. Use when you need to fetch historical bars aggregated by specific time intervals.
  - body: { sort?: string, limit?: integer, to_date: string, adjusted?: boolean, timespan: string, from_date: string, multiplier: integer, crypto_ticker: string }
- `POST https://api.mcp.ai/api/polygon/get/crypto/all/tickers` — Tool to retrieve snapshots for all cryptocurrency tickers. Use when you need a full-market crypto snapshot of the latest values.
  - body: { tickers?: string[] }
- `POST https://api.mcp.ai/api/polygon/get/crypto/ema` — Tool to calculate Exponential Moving Average (EMA) technical indicator for a crypto ticker. Use when you need trend analysis or moving average calculations for cryptocurrency pairs.
  - body: { limit?: integer, order?: string, window?: integer, adjusted?: boolean, timespan?: string, timestamp?: string, series_type?: string, timestamp.gt?: string, timestamp.lt?: string, crypto_ticker: string, timestamp.gte?: string, timestamp.lte?: string, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/crypto/grouped/daily` — Tool to retrieve daily grouped bars for all cryptocurrencies on a specified date. Use when you need a comprehensive end-of-day summary across all crypto tickers.
  - body: { date: string, adjusted?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/crypto/last/trade` — Tool to retrieve the last trade for a specified cryptocurrency pair. Use when you need the most recent trade details after specifying both symbols.
  - body: { to_symbol: string, from_symbol: string }
- `POST https://api.mcp.ai/api/polygon/get/crypto/macd` — Tool to calculate Moving Average Convergence/Divergence (MACD) technical indicator for a crypto ticker. Use when you need momentum analysis, trend identification, or trading signal generation for cryp
  - body: { limit?: integer, order?: string, adjusted?: boolean, timespan?: string, timestamp?: string, long_window: integer, series_type?: string, short_window: integer, crypto_ticker: string, signal_window: integer, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/crypto/open/close` — Tool to fetch daily open and close prices for a given crypto pair on a specified date. Use after specifying both currency symbols and the date.
  - body: { base: string, date: string, quote: string }
- `POST https://api.mcp.ai/api/polygon/get/crypto/prev/close` — Tool to retrieve previous day’s close for a crypto ticker. Use when you need the last closing price of a cryptocurrency before analysis or trading.
  - body: { adjusted?: boolean, crypto_ticker: string }
- `POST https://api.mcp.ai/api/polygon/get/crypto/rsi` — Tool to calculate the Relative Strength Index (RSI) for a cryptocurrency ticker. Use when you need to analyze momentum or identify overbought/oversold conditions for crypto assets.
  - body: { limit?: integer, order?: string, window?: integer, adjusted?: boolean, timespan?: string, timestamp?: string, series_type?: string, timestamp.gt?: string, timestamp.lt?: string, crypto_ticker: string, timestamp.gte?: string, timestamp.lte?: string, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/crypto/sma` — Tool to calculate Simple Moving Average (SMA) technical indicator for a cryptocurrency ticker. Use when you need trend analysis, support/resistance levels, or trading signal generation for crypto pair
  - body: { limit?: integer, order?: string, window: integer, adjusted?: boolean, timespan: string, timestamp?: string, series_type?: string, timestamp.gt?: string, timestamp.lt?: string, crypto_ticker: string, timestamp.gte?: string, timestamp.lte?: string, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/crypto/ticker/book` — Tool to retrieve the full L2 order book for a crypto ticker. Use when you need a snapshot of combined bids and asks for market depth analysis.
  - body: { ticker: string }
- `POST https://api.mcp.ai/api/polygon/get/crypto/trades` — Tool to fetch historical trade data for a cryptocurrency ticker. Use when you need tick-level trades within a time range.
  - body: { sort?: string, limit?: integer, order?: string, timestamp?: string, timestamp.gt?: string, timestamp.lt?: string, crypto_ticker: string, timestamp.gte?: string, timestamp.lte?: string }
- `POST https://api.mcp.ai/api/polygon/get/dividends` — Tool to retrieve dividend data for stocks. Use when you need corporate dividend information for specific tickers.
  - body: { skip?: integer, sort?: string, limit?: integer, order?: string, ticker?: string, pay_date?: string, frequency?: string, cash_amount?: number, record_date?: string, dividend_type?: string, declaration_date?: string, ex_dividend_date?: string }
- `POST https://api.mcp.ai/api/polygon/get/economy/inflation` — Tool to retrieve key indicators of realized inflation including CPI and PCE price indexes. Use when analyzing inflation trends, economic conditions, or historical price changes in the U.S. economy.
  - body: { date?: string, sort?: string, limit?: integer }
- `POST https://api.mcp.ai/api/polygon/get/ema` — Tool to retrieve the Exponential Moving Average for a stock ticker. Use when you need EMA values across a specific timespan with optional underlying data.
  - body: { limit?: integer, order?: string, window: integer, adjusted?: boolean, timespan: string, series_type?: string, stock_ticker: string, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/filing` — Tool to retrieve SEC filing details by filing ID. Use when you need detailed information about a specific SEC filing.
  - body: { filing_id: string }
- `POST https://api.mcp.ai/api/polygon/get/filing/file` — Tool to retrieve information about a specific SEC filing file. Use when you need to get metadata and download URL for a particular file within an SEC filing.
  - body: { file_id: string, filing_id: string }
- `POST https://api.mcp.ai/api/polygon/get/forex/aggregates` — Tool to retrieve aggregate bars for a forex pair over a date range. Use when you need custom OHLC bars for forex currency pairs within specified time span.
  - body: { to: string, sort?: string, from_: string, limit?: integer, adjusted?: boolean, timespan: string, multiplier: integer, forex_ticker: string }
- `POST https://api.mcp.ai/api/polygon/get/forex/ema` — Tool to calculate Exponential Moving Average (EMA) technical indicator for a forex pair. Use when you need trend analysis or moving average calculations for currency pairs.
  - body: { limit?: integer, order?: string, window?: integer, adjusted?: boolean, timespan?: string, timestamp?: string, series_type?: string, forex_ticker: string, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/forex/grouped/daily` — Tool to retrieve daily grouped OHLC bars for all forex currency pairs on a specified date. Use when you need aggregated forex data after confirming the date parameter.
  - body: { date: string, adjusted?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/forex/historical/quotes` — Tool to retrieve historical forex quotes for a currency pair over a time range. Use when you need bid/ask quotes for an FX ticker between timestamps or dates. Use after confirming the forex ticker sym
  - body: { sort?: string, limit?: integer, order?: string, fxTicker: string, timestamp?: string, timestamp.gt?: string, timestamp.lt?: string, timestamp.gte?: string, timestamp.lte?: string }
- `POST https://api.mcp.ai/api/polygon/get/forex/locales` — Tool to list locales supported by Polygon's forex asset class. Use when you need available locale codes for regional filtering in FX endpoints.
  - body: { asset_class?: string }
- `POST https://api.mcp.ai/api/polygon/get/forex/macd` — Tool to calculate Moving Average Convergence/Divergence (MACD) technical indicator for a forex pair. Use when you need momentum analysis, trend identification, or trading signal generation for currenc
  - body: { limit?: integer, order?: string, adjusted?: boolean, timespan: string, timestamp?: string, long_window: integer, series_type?: string, forex_ticker: string, short_window: integer, timestamp_gt?: string, timestamp_lt?: string, signal_window: integer, timestamp_gte?: string, timestamp_lte?: string, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/forex/prev/close` — Tool to retrieve previous day's close for a forex ticker. Use when you need the last closing price of a forex currency pair before analysis or trading.
  - body: { adjusted?: boolean, forexTicker: string }
- `POST https://api.mcp.ai/api/polygon/get/forex/real/time/currency/conversion` — Tool to convert amounts between currency pairs using real-time forex rates. Use when you need to perform currency conversions with the latest market rates.
  - body: { amount?: number, precision?: integer, to_currency: string, from_currency: string }
- `POST https://api.mcp.ai/api/polygon/get/forex/rsi` — Tool to calculate the Relative Strength Index (RSI) technical indicator for a forex pair. Use when you need momentum analysis or want to identify overbought/oversold conditions for currency pairs.
  - body: { limit?: integer, order?: string, window: integer, adjusted?: boolean, timespan: string, timestamp?: string, series_type?: string, forex_ticker: string, timestamp_gt?: string, timestamp_lt?: string, timestamp_gte?: string, timestamp_lte?: string, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/forex/sma` — Tool to calculate Simple Moving Average (SMA) technical indicator for a forex pair. Use when you need trend analysis or moving average calculations for currency pairs.
  - body: { limit?: integer, order?: string, window?: integer, adjusted?: boolean, timespan?: string, timestamp?: string, series_type?: string, forex_ticker: string, timestamp.gt?: string, timestamp.lt?: string, timestamp.gte?: string, timestamp.lte?: string, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/forex/snapshot/losers` — Tool to retrieve the current snapshot of the top losers in the forex market. Use when you need up-to-date information on the worst-performing forex pairs.
- `POST https://api.mcp.ai/api/polygon/get/futures/aggregates` — Tool to retrieve historical OHLCV aggregates for a futures contract. Use when you need aggregated price and volume data for a futures contract over specified time windows.
  - body: { sort?: string, limit?: integer, ticker: string, resolution?: string, window_start.gte?: string, window_start.lte?: string }
- `POST https://api.mcp.ai/api/polygon/get/futures/product/schedules` — Tool to retrieve trading schedules for a futures product. Use when you need daily trading session schedules for a given product code.
  - body: { sort?: string, limit?: integer, product_code: string, session_end_date?: string }
- `POST https://api.mcp.ai/api/polygon/get/futures/products` — Tool to retrieve a comprehensive list of futures products with advanced filtering. Use when you need to filter futures listings by date, sector, exchange, or type.
  - body: { name?: string, sort?: string, type?: string, as_of?: string, limit?: integer, sector?: string, sub_sector?: string, asset_class?: string, name_search?: string, trading_venue?: string, asset_sub_class?: string }
- `POST https://api.mcp.ai/api/polygon/get/futures/quotes` — Tool to retrieve real-time quote data for a specified futures contract ticker. Use after confirming the exact futures ticker identifier (e.g., 'GCJ5').
  - body: { sort?: string, limit?: integer, ticker: string, timestamp?: string, session_end_date?: string }
- `POST https://api.mcp.ai/api/polygon/get/futures/schedules` — Tool to retrieve futures trading schedules. Use when you need trading schedules for all futures contracts on a specific date.
  - body: { sort?: string, limit?: integer, trading_venue?: string, session_end_date?: string }
- `POST https://api.mcp.ai/api/polygon/get/futures/trades` — Tool to retrieve tick-level trade data for a specified futures contract. Use when you need detailed trade data over a time range.
  - body: { sort?: string, limit?: integer, ticker: string, timestamp?: string, timestamp.gt?: string, timestamp.lt?: string, timestamp.gte?: string, timestamp.lte?: string, session_end_date?: string, session_end_date.gt?: string, session_end_date.lt?: string, session_end_date.gte?: string, session_end_date.lte?: string }
- `POST https://api.mcp.ai/api/polygon/get/historic/forex/ticks` — Tool to get historic ticks for a currency pair on a specific date. Use when you need historical forex tick-level data (ask/bid prices with timestamps) for a given day.
  - body: { date: string, limit?: integer, offset?: integer, to_currency: string, from_currency: string }
- `POST https://api.mcp.ai/api/polygon/get/inflation/expectations` — Tool to retrieve inflation expectations data from the Federal Reserve based on Treasury yields and Cleveland Fed models. Use when analyzing expected future inflation rates across multiple time horizon
  - body: { date?: string, sort?: string, limit?: integer, date.gt?: string, date.lt?: string, date.gte?: string, date.lte?: string, date.any_of?: string }
- `POST https://api.mcp.ai/api/polygon/get/ipo/data` — Tool to retrieve comprehensive information on Initial Public Offerings (IPOs), including upcoming and historical events. Use when analyzing IPO listing data by date range, ticker, or identifier.
  - body: { isin?: string, sort?: string, limit?: integer, order?: string, ticker?: string, us_code?: string, listing_date?: string, listing_date_gte?: string, listing_date_lte?: string }
- `POST https://api.mcp.ai/api/polygon/get/macd` — Tool to retrieve the Moving Average Convergence/Divergence (MACD) for a stock ticker. Use when you need momentum analysis or signal generation over a specified timeframe.
  - body: { limit?: integer, order?: string, adjusted?: boolean, timespan: string, timestamp?: string, long_window: integer, series_type?: string, short_window: integer, stock_ticker: string, signal_window: integer, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/market/holidays` — Tool to retrieve upcoming market holidays and half-day closures. Use when you need to look up upcoming exchange holidays and early closures.
- `POST https://api.mcp.ai/api/polygon/get/market/status` — Tool to retrieve current market status. Use when you need to know if U.S. exchanges are open, closed, or on holiday.
- `POST https://api.mcp.ai/api/polygon/get/meta/conditions/by/ticktype` — Tool to retrieve condition code mappings for a specific tick type (trades or quotes). Use when you need to decode numeric condition codes into human-readable labels for market data interpretation.
  - body: { ticktype: string }
- `POST https://api.mcp.ai/api/polygon/get/news` — Tool to retrieve recent news articles related to a ticker. Use when you need to fetch financial news after identifying a ticker symbol.
  - body: { sort?: string, limit?: integer, order?: string, cursor?: string, ticker?: string, published_utc.gte?: string, published_utc.lte?: string }
- `POST https://api.mcp.ai/api/polygon/get/open/close` — Tool to fetch daily open and close prices for a stock on a specific date. Use when you need daily OHLC with pre/post-market prices.
  - body: { date: string, adjusted?: boolean, stocksTicker: string }
- `POST https://api.mcp.ai/api/polygon/get/option/chain/snapshot` — Tool to fetch a real-time snapshot of all option contracts for an underlying asset. Use after selecting the underlying ticker to retrieve live option chain data.
  - body: { sort?: string, limit?: integer, order?: string, strike_price?: number, contract_type?: string, expiration_date?: string, underlying_ticker: string }
- `POST https://api.mcp.ai/api/polygon/get/option/snapshot` — Tool to retrieve a real-time snapshot for a single option contract. Use when you need up-to-the-minute quotes, trades, greeks, and metrics for a specified option contract.
  - body: { option_contract: string, underlying_asset: string }
- `POST https://api.mcp.ai/api/polygon/get/options/contract/overview` — Tool to retrieve comprehensive details about a specific options contract including contract type, exercise style, expiration date, strike price, and underlying ticker. Use when you need specifications
  - body: { as_of?: string, options_ticker: string }
- `POST https://api.mcp.ai/api/polygon/get/options/custom/bars` — Tool to retrieve historical OHLC and volume data for options contracts over custom date ranges with configurable time windows. Use when you need aggregate bars for options price analysis or strategy d
  - body: { sort?: string, limit?: integer, to_date: string, adjusted?: boolean, timespan: string, from_date: string, multiplier: integer, options_ticker: string }
- `POST https://api.mcp.ai/api/polygon/get/options/ema` — Tool to calculate Exponential Moving Average (EMA) technical indicator for an options ticker. Use when you need trend analysis or moving average calculations for options contracts.
  - body: { limit?: integer, order?: string, window: integer, adjusted?: boolean, timespan: string, timestamp?: string, series_type?: string, timestamp.gt?: string, timestamp.lt?: string, timestamp.gte?: string, timestamp.lte?: string, options_ticker: string, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/options/macd` — Tool to calculate Moving Average Convergence/Divergence (MACD) technical indicator for an options ticker. Use when you need momentum analysis, trend identification, or trading signal generation for op
  - body: { limit?: integer, order?: string, adjusted?: boolean, timespan: string, timestamp: string, long_window: integer, series_type?: string, short_window: integer, signal_window: integer, options_ticker: string, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/options/rsi` — Tool to calculate Relative Strength Index (RSI) technical indicator for an options ticker. Use when you need momentum analysis or want to identify overbought/oversold conditions for options contracts.
  - body: { limit?: integer, order?: string, window?: integer, adjusted?: boolean, timespan: string, timestamp?: string, series_type?: string, timestamp_gt?: string, timestamp_lt?: string, timestamp_gte?: string, timestamp_lte?: string, options_ticker: string, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/options/sma` — Tool to calculate Simple Moving Average (SMA) technical indicator for an options ticker. Use when you need trend analysis or smoothed price data for options contracts.
  - body: { limit?: integer, order?: string, cursor?: string, window: integer, adjusted?: boolean, timespan: string, timestamp?: string, series_type?: string, timestamp_gt?: string, timestamp_lt?: string, timestamp_gte?: string, timestamp_lte?: string, options_ticker: string, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/previous/close` — Tool to get previous trading day’s OHLC and volume for a stock. Use when you need the last day’s open, high, low, close, and volume for a given ticker.
  - body: { ticker: string, adjusted?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/reference/exchanges` — Tool to retrieve supported exchanges and their details. Use when you need a list of exchanges filtered by asset class or locale.
  - body: { locale?: string, asset_class?: string }
- `POST https://api.mcp.ai/api/polygon/get/reference/markets` — Tool to retrieve all supported markets from Polygon.io. Use when you need a list of available market types.
- `POST https://api.mcp.ai/api/polygon/get/reference/types` — Tool to retrieve all ticker types supported by Polygon. Use when you need to understand the different ticker classifications available across asset classes and markets.
- `POST https://api.mcp.ai/api/polygon/get/related/companies` — Tool to get a list of related companies for a ticker symbol based on various similarity metrics. Use when you need to find companies related to a specific ticker.
  - body: { ticker: string }
- `POST https://api.mcp.ai/api/polygon/get/risk/categories` — Tool to retrieve risk factor taxonomy categories from SEC 10-K filings. Use when you need to explore or filter risk classifications by taxonomy version or category level.
  - body: { sort?: string, limit?: integer, taxonomy?: number, taxonomy.gt?: number, taxonomy.lt?: number, taxonomy.gte?: number, taxonomy.lte?: number, primary_category?: string, tertiary_category?: string, secondary_category?: string, primary_category.gt?: string, primary_category.lt?: string, primary_category.gte?: string, primary_category.lte?: string, tertiary_category.gt?: string, tertiary_category.lt?: string, secondary_category.gt?: string, secondary_category.lt?: string, tertiary_category.gte?: string, tertiary_category.lte?: string, secondary_category.gte?: string, secondary_category.lte?: string, primary_category.any_of?: string, tertiary_category.any_of?: string, secondary_category.any_of?: string }
- `POST https://api.mcp.ai/api/polygon/get/rsi` — Tool to retrieve the Relative Strength Index (RSI) for a stock ticker. Use after confirming ticker symbol and timespan to analyze momentum over a period.
  - body: { limit?: integer, order?: string, window?: integer, adjusted?: boolean, timespan: string, timestamp?: integer, series_type?: string, stock_ticker: string, timestampLimit?: integer }
- `POST https://api.mcp.ai/api/polygon/get/short/interest` — Tool to retrieve bi-monthly aggregated short interest data for stocks reported to FINRA. Use when analyzing sentiment, identifying potential short squeezes, or researching short positions.
  - body: { sort?: string, limit?: integer, ticker?: string, days_to_cover?: number, settlement_date?: string, avg_daily_volume?: integer }
- `POST https://api.mcp.ai/api/polygon/get/short/volume` — Tool to retrieve short volume data for stocks. Use when analyzing short selling activity, market sentiment, or detecting abnormal short-selling patterns.
  - body: { date?: string, sort?: string, limit?: integer, ticker?: string, total_volume?: integer, short_volume_ratio?: number }
- `POST https://api.mcp.ai/api/polygon/get/sma` — Tool to retrieve the Simple Moving Average (SMA) for any ticker (stocks, forex, crypto). Use when you need SMA values over a specified timespan with optional underlying data.
  - body: { limit?: integer, order?: string, window: integer, adjusted?: boolean, timespan: string, fx_ticker: string, timestamp?: integer, series_type?: string, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/snapshot/all/tickers` — Tool to retrieve the current market snapshot for all stock tickers. Use when you need real-time OHLCV, trades, and quotes across the entire US stock market in one call.
  - body: { tickers?: string[], include_otc?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/snapshot/losers` — Tool to retrieve the current snapshot of the top losers in the U.S. stock market. Use when you need up-to-date information on the worst-performing stocks.
  - body: { include_otc?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/snapshot/single/ticker` — Tool to retrieve the current snapshot of a specific stock ticker. Use when you need the most recent market snapshot after specifying the ticker symbol.
  - body: { ticker: string }
- `POST https://api.mcp.ai/api/polygon/get/splits` — Tool to retrieve stock split events. Use when you need corporate stock split data filtered by ticker or date range. Example: "Get splits for AAPL between 2021-01-01 and 2021-12-31".
  - body: { sort?: string, limit?: integer, order?: string, ticker?: string, execution_date.gte?: string, execution_date.lte?: string }
- `POST https://api.mcp.ai/api/polygon/get/stock/financials` — Tool to retrieve historical financial data for a stock ticker from SEC filings. Use when analyzing company financials, comparing quarters, or examining financial trends.
  - body: { sort?: string, type?: string, limit?: integer, stocks_ticker: string }
- `POST https://api.mcp.ai/api/polygon/get/stock/float` — Tool to retrieve stock float data showing the number and percentage of publicly tradable shares. Use when you need information about the free float of stocks.
  - body: { sort?: string, limit?: integer, ticker?: string, ticker_gt?: string, ticker_lt?: string, ticker_gte?: string, ticker_lte?: string, ticker_any_of?: string, free_float_percent?: number, free_float_percent_gt?: number, free_float_percent_lt?: number, free_float_percent_gte?: number, free_float_percent_lte?: number }
- `POST https://api.mcp.ai/api/polygon/get/stock/splits/by/ticker` — Tool to retrieve historical stock splits for a specific ticker symbol. Use when you need split history including ex-dates, payment dates, and split ratios for a particular stock.
  - body: { stocks_ticker: string }
- `POST https://api.mcp.ai/api/polygon/get/stocks/balance/sheets` — Tool to retrieve point-in-time balance sheet data including assets, liabilities, and equity from company SEC filings. Use when analyzing financial position with quarterly and annual history.
  - body: { cik?: string, sic?: string, sort?: string, limit?: integer, order?: string, ticker?: string, timeframe?: string, filing_date?: string, company_name?: string, filing_date_gt?: string, filing_date_lt?: string, filing_date_gte?: string, filing_date_lte?: string, include_sources?: boolean, company_name_search?: string, period_of_report_date?: string, period_of_report_date_gt?: string, period_of_report_date_lt?: string, period_of_report_date_gte?: string, period_of_report_date_lte?: string }
- `POST https://api.mcp.ai/api/polygon/get/stocks/cash/flow/statements` — Tool to retrieve historical cash flow statement data from company SEC filings across quarterly, annual, and TTM frequencies. Use when analyzing cash generation, operating activities, investing activit
  - body: { cik?: string, sic?: string, sort?: string, limit?: integer, order?: string, ticker?: string, timeframe?: string, filing_date?: string, company_name?: string, filing_date_gt?: string, filing_date_lt?: string, filing_date_gte?: string, filing_date_lte?: string, include_sources?: boolean, company_name_search?: string, period_of_report_date?: string, period_of_report_date_gt?: string, period_of_report_date_lt?: string, period_of_report_date_gte?: string, period_of_report_date_lte?: string }
- `POST https://api.mcp.ai/api/polygon/get/stocks/custom/bars` — Tool to retrieve aggregated historical OHLC and volume data for a stock over custom date ranges with configurable time windows. Use when you need aggregate bars for stock price analysis, backtesting, 
  - body: { sort?: string, limit?: integer, to_date: string, adjusted?: boolean, timespan: string, from_date: string, multiplier: integer, stocks_ticker: string }
- `POST https://api.mcp.ai/api/polygon/get/stocks/daily/market/summary` — Tool to retrieve daily OHLC, volume, and VWAP data for all U.S. stocks on a specified trading date. Use when you need to get grouped daily aggregate bars for all US stocks for a specific date.
  - body: { date: string, adjusted?: boolean, include_otc?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/technical/indicator/ema` — DEPRECATED: Use POLYGON_GET_EMA instead. Tool to fetch Exponential Moving Average (EMA) for a given stock ticker. Use when you need historical EMA data after confirming ticker, timespan, and window si
  - body: { limit?: integer, order?: string, ticker: string, window: integer, adjusted?: boolean, timespan: string, series_type?: string, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/technical/indicator/sma` — Tool to fetch Simple Moving Average (SMA) for a given stock ticker. Use when you need historical SMA data after confirming ticker, timespan, and window size.
  - body: { limit?: integer, order?: string, ticker: string, window: integer, adjusted?: boolean, timespan: string, series_type?: string, expand_underlying?: boolean }
- `POST https://api.mcp.ai/api/polygon/get/ticker/company/details` — Tool to retrieve detailed company information for a stock ticker. Use when you need company fundamentals like CEO, industry, sector, market cap, and headquarters information.
  - body: { stocks_ticker: string }
- `POST https://api.mcp.ai/api/polygon/get/ticker/details` — Tool to retrieve detailed information for a ticker. Use when you need an overview of a ticker including company info, market data, and identifiers.
  - body: { date?: string, ticker: string }
- `POST https://api.mcp.ai/api/polygon/get/ticker/details/vx` — Tool to retrieve comprehensive details for a specific ticker symbol using Polygon's vX API. Use when you need detailed information about a company including identifiers, market data, and corporate det
  - body: { date?: string, ticker: string }
- `POST https://api.mcp.ai/api/polygon/get/ticker/events` — Tool to retrieve corporate events for a specific ticker. Use when you need the timeline of corporate actions for a given ticker.
  - body: { types?: string, ticker: string }
- `POST https://api.mcp.ai/api/polygon/get/ticker/types` — Tool to retrieve all ticker types supported by Polygon.io. Use after authenticating to explore ticker categories.
  - body: { type?: string, limit?: integer, offset?: integer, asset_class?: string }
- `POST https://api.mcp.ai/api/polygon/get/treasury/yields` — Tool to retrieve historical U.S. Treasury yield data for standard timeframes from 1-month to 30-year maturities. Use when analyzing interest rates, yield curves, or economic indicators. Data available
  - body: { date?: string, sort?: string, limit?: integer, date_gt?: string, date_lt?: string, date_gte?: string, date_lte?: string, date_any_of?: string }
- `POST https://api.mcp.ai/api/polygon/get/v1/meta/crypto/exchanges` — Tool to retrieve a list of cryptocurrency exchanges using the legacy v1 API. Use when you need the complete list of crypto exchanges supported.
- `POST https://api.mcp.ai/api/polygon/get10/k/sections` — Tool to retrieve 10-K filing sections from the SEC. Use when you need to access specific sections of 10-K filings such as business descriptions, risk factors, or financial statements.
  - body: { cik?: string, sort?: string, limit?: integer, ticker?: string, section?: string, period_end?: string, filing_date?: string }
- `POST https://api.mcp.ai/api/polygon/last/quote/for/a/symbol` — Tool to retrieve the last quote tick for a given stock symbol. Use when you need the most recent bid/ask prices, sizes, and exchange information for a stock.
  - body: { symbol: string }
- `POST https://api.mcp.ai/api/polygon/last/trade/for/a/currency/pair` — Tool to retrieve the last trade tick for a currency pair in the forex market. Use when you need the most recent trade price, exchange, and timestamp for a specific currency pair.
  - body: { to_currency: string, from_currency: string }
- `POST https://api.mcp.ai/api/polygon/list/filing/files` — Tool to retrieve files associated with an SEC filing. Use when you need to list all files (documents, exhibits, etc.) attached to a specific SEC filing by its filing ID.
  - body: { sort?: string, limit?: integer, order?: string, filename?: string, sequence?: integer, filing_id: string, filename.gt?: string, filename.lt?: string, sequence.gt?: integer, sequence.lt?: integer, filename.gte?: string, filename.lte?: string, sequence.gte?: integer, sequence.lte?: integer }
- `POST https://api.mcp.ai/api/polygon/list/options/contracts` — Tool to list and filter options contracts by underlying ticker, type, expiration, strike, and more. Use when you need to enumerate an options chain or find specific contracts matching criteria.
  - body: { sort?: string, as_of?: string, limit?: integer, order?: string, expired?: boolean, strike_price?: number, contract_type?: string, expiration_date?: string, strike_price_gt?: number, strike_price_lt?: number, strike_price_gte?: number, strike_price_lte?: number, underlying_ticker?: string, expiration_date_gt?: string, expiration_date_lt?: string, expiration_date_gte?: string, expiration_date_lte?: string }
- `POST https://api.mcp.ai/api/polygon/list/sec/filings` — Tool to retrieve SEC filings from Polygon. Use when you need to query 10-K or 10-Q filings by company, date range, or other criteria.
  - body: { sort?: string, type?: string, limit?: integer, order?: string, has_xbrl?: boolean, filing_date?: string, filing_date.gt?: string, filing_date.lt?: string, filing_date.gte?: string, filing_date.lte?: string, period_of_report_date?: string, period_of_report_date.gt?: string, period_of_report_date.lt?: string, entities.company_data.cik?: string, entities.company_data.sic?: string, period_of_report_date.gte?: string, period_of_report_date.lte?: string, entities.company_data.name?: string, entities.company_data.ticker?: string, entities.company_data.name.search?: string }

## Example prompts
- "What can I do in Polygon?"
- "Show me a summary of my Polygon account"

## More
- Page: https://mcp.ai/polygon
- Agent spec (llms.txt): https://mcp.ai/polygon/llms.txt
- Postman collection: https://mcp.ai/polygon/postman.json