# Polygon Io

> Polygon Io is a freemium MCP server for sports data. US stock market data over MCP: tickers, OHLC bars, dividends, splits, news and market. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web, self-hosted
- **Website:** https://pipeworx.io/packs/polygon-io
- **Repository:** https://github.com/pipeworx-io/mcp-polygon-io
- **MCP Registry name:** io.github.pipeworx-io/polygon-io
- **Categories:** [sports data](https://ai-powered.com/categories/sports-data), [financial data](https://ai-powered.com/categories/financial-data)
- **Listing updated:** 2026-11-18

## About

The README describes this as a Pipeworx gateway pack wrapping the Massive API (formerly Polygon.io), so requests are routed through Pipeworx rather than sent directly to the upstream host. It exposes roughly a dozen tools covering US equities reference data, price bars from one minute to quarterly, daily open/close and previous-close figures, and a market-wide grouped daily call that returns every ticker for a given date.

Beyond prices, the pack surfaces corporate actions such as splits and dividends, ticker-tagged news with per-ticker sentiment, market holidays, current market status and a list of covered exchanges. The README states the pack is an independent, unofficial integration and is not endorsed by the upstream provider.

It suits developers and AI agents that need US stock data inside an MCP client or a script. Access works anonymously with a daily cap, or with a free Pipeworx key that raises the limit; the registry entry lists the key as optional.

## Features

- **Ticker search and reference:** Looks up US stock, option, index, forex and crypto symbols and returns company details such as SIC code and exchange.
- **OHLC price bars:** Returns open, high, low, close, volume and VWAP bars at granularities from one minute to one quarter.
- **Daily and previous-session prices:** Gives official daily open, close and after-hours prices for a date, plus the prior session's figures.
- **Market-wide daily snapshot:** Fetches OHLCV data for all US stocks on a single date in one call, useful for screening.
- **Splits and dividends:** Provides historical and upcoming split ratios and cash dividend schedules for a ticker.
- **Ticker-tagged market news:** Returns headlines with publisher, link, summary and per-ticker sentiment insights.

## Good for

- Pulling intraday or daily bars to chart a US equity inside an AI assistant
- Adjusting historical price comparisons for stock splits
- Screening the whole US market for a given trading day
- Checking upcoming market holidays and whether exchanges are open
- Gathering recent ticker-specific news for research summaries

## Install

### Claude Code (Terminal)

```sh
claude mcp add --transport http polygon-io https://gateway.pipeworx.io/polygon-io/mcp
```

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://gateway.pipeworx.io/polygon-io/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "polygon-io": {
      "url": "https://gateway.pipeworx.io/polygon-io/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "polygon-io": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/polygon-io/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "polygon-io": {
      "serverUrl": "https://gateway.pipeworx.io/polygon-io/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```json
{
  "mcpServers": {
    "polygon-io": {
      "type": "http",
      "url": "https://gateway.pipeworx.io/polygon-io/mcp"
    }
  }
}
```

## Tools

- `tickers`: Search ticker reference universe with filters for type, market, exchange and status.
- `ticker_details`: Fetch reference detail for a single ticker.
- `aggregates`: Retrieve OHLC bars for a ticker at a chosen timespan.
- `daily_open_close`: Daily open, high, low, close and after-hours prices for a ticker on a date.
- `previous_close`: Previous trading session OHLC and volume for a ticker.
- `grouped_daily`: OHLCV bars for all US stocks on a given date.
- `news`: Ticker-tagged financial news with sentiment insights.
- `splits`: Historical stock splits for a ticker.
- `dividends`: Historical and upcoming cash and stock dividends.
- `market_holidays`: Upcoming US market holidays and exchange status.
- `market_status`: Current market status.
- `exchanges`: Reference list of covered exchanges.

## FAQ

### Does it require an API key?

No. The README says calls are anonymous without a key but capped daily; a free Pipeworx key raises the cap.

### Which market data does it cover?

The tool list covers US stocks in detail, with reference tools that also cover options, indices, forex, crypto and exchanges.

### Is this an official Massive or Polygon.io product?

No. The README states it is an independent, unofficial integration not affiliated with or endorsed by the upstream provider.

### How do I install it locally?

The README gives an npx configuration using the @pipeworx/mcp-polygon-io package, which forwards calls to the hosted gateway endpoint.

### Is Polygon Io free?

Polygon Io has a free plan, with paid plans for more usage or features.

### How do I add Polygon Io to Claude Code?

Run this command in your terminal: claude mcp add --transport http polygon-io https://gateway.pipeworx.io/polygon-io/mcp

## Where this comes from

- Description: written from the project's README, the project's website and its MCP Registry entry.
- Install steps: from the official MCP Registry entry.

## Alternatives

- [Stocktwits](https://ai-powered.com/mcp/stocktwits): Stocktwits is a freemium MCP server for sports data.

---
Source: https://ai-powered.com/mcp/polygon-io
