# Polygon.io MCP for AI Agents AI Agent Connect

> Polygon.io MCP gives your AI agent direct access to institutional-grade stock market data. You can pull real-time trades, historical aggregates, company fundamentals, and dividend history instantly. It's the bridge between your chat interface and live market feeds.

## Overview
- **Category:** money-moves
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_8YdMcCERRHhCdZDn0EolzUq7yE1Irfyp84qVvYs9/ai-agent-connect
- **Tags:** stock-market, trading-data, financial-analysis, real-time-data, ticker-search

## Description

This Polygon.io MCP connects your AI client to a professional financial data feed, letting you pull precise OHLCV bars, tick-by-tick quotes, and company metadata without leaving your workspace. It turns your agent into a financial researcher that actually has its hands on the live wires. Instead of opening five different tabs and copy-pasting spreadsheets into your chat, you just ask. You can verify ticker symbols, check industry classifications, or analyze historical price movements in seconds. It's about moving from looking at data to actually analyzing it without the friction of manual entry. Because Vinkius makes it so easy to manage these connections, you can get your agent up and running with this data feed in minutes. You stop hunting for data and start actually doing the work that matters. You can check a company's dividend history or look for a specific day's aggregate bars with just one prompt. This connection puts the power of institutional-grade data right in your chat window.

## Tools

### list_dividends
List historical dividends to see past cash distributions. This helps you track payment frequency and history.

### list_quotes
Get tick-by-tick quotes (NBBO) for real-time market monitoring. It provides the most granular look at current pricing.

### get_company
Get company details for a ticker like industry and description. Use this to quickly pull fundamental metadata.

### list_tickers
Query all supported tickers to find the right financial instrument. Use this to verify which assets are available on the platform.

### get_aggregates
Get aggregate bars for a stock to see historical price trends. This is useful for plotting price action over time.

### list_trades
Get tick-by-tick trades to see exact execution data. Use this to analyze the order flow for specific stocks.

## Prompt Examples

**Prompt:** 
```
What's the dividend history for AAPL?
```

**Response:** 
```
I've pulled the historical dividend data for Apple Inc. (AAPL). They have a consistent record of quarterly cash dividends. The most recent distribution was $0.96 per share with an ex-dividend date of May 10, 2024.
```

**Prompt:** 
```
Give me the daily aggregates for TSLA from Jan 1 to Jan 5, 2024.
```

**Response:** 
```
Here are the daily aggregates for Tesla (TSLA) for that period:

| Date | Open | High | Low | Close | Volume |
| :--- | :--- | :--- | :--- | :--- | :--- |
| 2024-01-02 | 250.08 | 252.10 | 248.42 | 248.42 | 104M
| 2024-01-03 | 248.42 | 250.00 | 247.00 | 249.00 | 98M

Would you like a more detailed breakdown for any specific day?
```

**Prompt:** 
```
What industry does NVDA belong to and what do they do?
```

**Response:** 
```
NVIDIA Corp (NVDA) operates in the Semiconductors & Related Devices industry. Their primary business involves designing graphics processing units (GPUs) for gaming and professional markets.
```

## Capabilities

### Pull historical price bars
Get OHLCV data for any ticker over minute, hour, or day timeframes.

### Track live trades
Access tick-by-tick trade data to see exact execution prices.

### Look up company details
Fetch industry classifications and descriptions for specific stocks.

### Review dividend history
Get a list of historical cash distributions and ex-dividend dates for assets.

### Search for tickers
Query the full list of supported financial instruments on the platform.

### Get real-time quotes
Retrieve NBBO quotes for live market monitoring.

## Use Cases

### Verifying a stock's history
A researcher needs to know a company's industry and recent dividends. They ask the agent to pull company details and dividend history for a ticker.

### Analyzing a trading day
A trader wants to see the price action for a specific day. They ask the agent for daily aggregate bars for a ticker from a specific date range.

### Building a portfolio summary
An analyst needs to check the ticker list and metadata for a group of companies. They ask the agent to list supported tickers and fetch company details for each.

### Strategy backtesting
A quant wants to see the exact execution prices for a volatile stock. They ask the agent to pull tick-by-tick trades to see the order flow.

## Benefits

- Stop manual data entry by using `get_aggregates` to pull historical OHLCV bars directly into your workspace.
- Analyze precise market movements with `list_trades` which provides tick-by-tick data for better strategy validation.
- Verify company fundamentals instantly using `get_company` to get industry classifications and descriptions.
- Automate dividend research by pulling historical distributions and ex-dividend dates with `list_dividends`.
- Quickly identify assets by querying the full list of supported tickers with `list_tickers`.
- Monitor live market liquidity with `list_quotes` to get real-time NBBO data in your chat.

## How It Works

The bottom line is you get live financial data inside your chat window without the manual copy-pasting.

1. Subscribe to the Polygon.io MCP on the Vinkius Marketplace.
2. Add your Polygon.io API key to your AI client configuration.
3. Ask your agent to fetch market data or company info using natural language.

## Frequently Asked Questions

**Can the Polygon.io MCP provide real-time stock prices?**
Yes, it can pull real-time quotes and tick-by-tick trade data so you can see live market movements in your chat.

**Does the Polygon.io MCP include historical data?**
It provides historical aggregates like OHLCV bars and past dividend distributions for various assets.

**Can I use the Polygon.io MCP to find specific stock tickers?**
You can query the full list of supported tickers and financial instruments available on the platform.

**Is the Polygon.io MCP good for dividend research?**
It's great for that because it can list historical cash distributions and ex-dividend dates for specific assets.

**Can I get company metadata with the Polygon.io MCP?**
Yes, it retrieves details like industry classifications and company descriptions for various tickers.

**How does the Polygon.io MCP help with quant trading?**
It allows you to inspect tick-by-tick trades and NBBO quotes to validate your trading strategies against real execution data.

**Can I get historical price data for a specific stock over a date range?**
Yes. Use the `get_aggregates` tool by providing the ticker, multiplier, timespan (e.g., 'day'), and the 'from' and 'to' dates. The agent will return the OHLCV bars for that period.

**How do I find the description and industry of a specific company?**
Simply use the `get_company` tool with the stock ticker (e.g., 'AAPL'). It will retrieve the official company metadata, including its business description and industry classification.

**Is it possible to see the most recent trades for a ticker?**
Yes! The `list_trades` tool allows you to fetch tick-by-tick trade data for a specific ticker, showing execution prices and sizes as they happen in the market.