# Polygon.io MCP

> Polygon.io connects your agent to institutional-grade financial data, giving you instant access to real-time and historical stock market information right inside your chat window. You can retrieve OHLCV aggregates, analyze tick-by-tick trades, check company fundamentals, or track past dividend payments instantly without leaving your workflow.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Tags:** stock-market, trading-data, financial-analysis, real-time-data, ticker-search

## Description

Need to understand a market trend but hate opening ten different tabs? This MCP lets you pull deep financial data directly through natural language queries. Your agent handles the complexity; you just ask questions about the stock market.

Whether you're analyzing historical performance or checking current liquidity, you get raw, structured data—from detailed company metadata to precise trade volumes. You can monitor how a stock behaved minute-by-minute or see every cash dividend paid over the last decade. Since Vinkius hosts this MCP in their catalog, connecting it is fast; just plug into your preferred AI client.

This means you spend zero time copying data between screens and all your focus stays on the analysis itself.

## Tools

### get_aggregates
Retrieves Open, High, Low, Close, Volume (OHLCV) price bars for a specified stock ticker and time period.

### get_company
Fetches detailed background information, including the industry classification, for any given stock ticker.

### list_dividends
Generates a list showing all historical cash dividend distributions for an asset.

### list_quotes
Gets real-time, tick-by-tick quotes (NBBO) to show the current best bid and offer prices.

### list_tickers
Queries and returns the full list of all financial tickers supported by the platform.

### list_trades
Retrieves every recorded tick-by-tick trade that occurred for a specific stock ticker.

## Prompt Examples

**Prompt:** 
```
Get company details and industry for ticker NVDA.
```

**Response:** 
```
I've retrieved the details for NVIDIA Corp (NVDA). They operate in the Semiconductors & Related Devices industry. Their primary business involves designing graphics processing units (GPUs) for the gaming and professional markets.
```

**Prompt:** 
```
Show me the historical dividends for MSFT.
```

**Response:** 
```
Fetching dividend history for Microsoft (MSFT)... I found a consistent record of quarterly cash dividends. The most recent distribution was $0.75 per share with an ex-dividend date of February 14, 2024.
```

**Prompt:** 
```
Get daily aggregate bars for TSLA from 2024-01-01 to 2024-01-10.
```

**Response:** 
```
I've compiled the daily aggregates for Tesla (TSLA) for that period. On Jan 2nd, it opened at $250.08 and closed at $248.42 with a volume of 104M. Would you like the full breakdown for the remaining days?
```

## Capabilities

### Get Historical Price Ranges
Retrieve Open, High, Low, Close, Volume (OHLCV) bars for any stock across custom timeframes.

### Analyze Live Market Movements
Access tick-by-tick trade data and quotes to pinpoint exact market movements and execution prices.

### Research Company Basics
Pull detailed metadata for a stock ticker, including its industry classification and primary business description.

### Check Dividend History
List historical cash dividend payments, including the frequency and ex-dividend dates for specific assets.

### View Available Instruments
Query a full list of supported financial tickers and instruments available on the platform.

## Use Cases

### Validating a new investment theory
A quant researcher wants to know if volatility was higher last month than this month. They ask their agent to get daily aggregates for the past two months using `get_aggregates`. The agent returns the OHLCV data, allowing them to instantly compare volume and price movement without manual charting.

### Preparing a client presentation
A financial analyst needs to prove a company's stable dividend record. They use `list_dividends` on the target ticker. The agent compiles the full history, showing consistent cash payments and ex-dividend dates for easy inclusion in slides.

### Debugging an application connection
A fintech developer needs to ensure their system can handle a new stock symbol. They first run `list_tickers` to confirm support, then use `get_company` on the specific ticker to pull metadata and verify the industry classification before writing any code.

### Real-time competitive analysis
A trader wants to know if a stock is currently experiencing heavy buying pressure. They ask for quotes using `list_quotes`. The agent returns the best bid and offer data, allowing them to make immediate decisions based on current market interest.

## Benefits

- Stop switching between charting platforms and data sheets. You can now get daily aggregates using the `get_aggregates` tool and immediately analyze what that means for your report.
- Validate complex strategies by getting tick-by-tick trades with `list_trades`. Instead of guessing market depth, you see the exact execution prices in real time.
- Save hours researching company background. The `get_company` tool instantly gives you industry classifications and business descriptions without visiting a separate corporate website.
- Build comprehensive financial models by running through historical dividend payments using the `list_dividends` tool, ensuring your cash flow projections are accurate.
- Know exactly what data is available. Use `list_tickers` to check if a specific instrument is supported before writing any code or query.

## How It Works

The bottom line is you get deep market insights without leaving the conversation interface.

1. Subscribe to this MCP and enter your Polygon.io API Key into the client settings.
2. Ask your agent a specific question, for example: 'What were the daily aggregates for TSLA last month?'
3. The agent runs the necessary tools against the live financial data and returns the structured analysis directly in your chat.

## Frequently Asked Questions

**How does Polygon.io MCP get real-time stock quotes?**
It uses the `list_quotes` tool to fetch tick-by-tick data, giving you the current best bid and offer prices (NBBO). This is critical for immediate trading decisions.

**Can I check dividend history with Polygon.io MCP?**
Yes, running `list_dividends` pulls a comprehensive record of all historical cash dividends paid out by the company over time, helping you project future payouts.

**What is the difference between get_aggregates and list_trades?**
`get_aggregates` summarizes price action (OHLCV) for a given period. `list_trades`, however, provides raw, individual records of every single trade that occurred during that time.

**Do I need an API key to use Polygon.io MCP?**
Yes, you must subscribe and enter your personal Polygon.io API Key into the client settings for the agent to access the live financial data.

**What if I want a list of all available stocks?**
Use the `list_tickers` tool. It queries the platform and returns the full, supported list of financial instruments you can analyze with other tools.