# Polygon.io MCP for AI Agents AI Agent Connect > Polygon.io MCP provides your AI agent with direct access to institutional-grade market data for stocks, crypto, and forex. It pulls real-time quotes, historical OHLC bars, and financial news so you can analyze trends and check market statuses without leaving your workspace. ## Overview - **Category:** data-analytics - **Price:** Free - **Endpoint:** https://edge.vinkius.com/vk_preview_dqPiZ3NKcmnEpDsgvwZEXUcEm8HKkvzCFRr9cX8T/ai-agent-connect - **Tags:** stock-market, crypto-trading, financial-data, market-analysis, forex-data ## Description Imagine you're deep in a research project and need to know the dividend history for a specific stock or the current price of a crypto pair. Usually, that means opening a new tab, navigating a complex dashboard, and copy-pasting data into your notes. With this Connector, you just ask your AI client to do it for you. It pulls the data directly into your conversation. Whether you're looking for a snapshot of the entire U.S. stock market or need to see tick-level trades for a specific ticker, the information appears instantly. You can check market statuses, look up upcoming holidays that might affect trading hours, or get technical indicators like moving averages to see where the price is heading. This makes it much easier to build out research reports or test your own data queries while you're coding. You can find this Connector in the Vinkius catalog to get started. It turns your AI into a high-speed financial terminal that knows exactly what's happening in the markets right now. ## Tools ### get_dividends Retrieve historical dividends for stocks. This is perfect for tracking payout history over several years. ### get_forex_conversion Retrieve real-time currency conversion rates. Use this to quickly check exchange rates between different currencies. ### get_indices_snapshot Retrieve snapshot data for one or more indices. This gives you a quick look at how major indices are performing. ### get_market_holidays List future holidays affecting market hours. Use this to plan your trading schedule around closures. ### get_market_snapshot Retrieve a snapshot of the entire U.S. stock market. This helps you see the overall sentiment of the market at a glance. ### get_market_status Check if markets are open, closed, or in pre-market sessions. Use this to confirm trading status before making a move. ### get_news Retrieve real-time structured news articles from Benzinga. This keeps you updated on the latest headlines for your favorite companies. ### get_options_snapshot Retrieve a snapshot of all options contracts for an underlying ticker. This helps you see the entire options chain for a specific stock. ### get_quotes Retrieve National Best Bid and Offer (NBBO) quotes for a stock. This provides the most accurate current pricing data. ### get_sma Retrieve Simple Moving Average (SMA) technical indicator. Use this to identify trends in price action over time. ### get_splits Retrieve historical stock splits. This is useful for adjusting your historical price data. ### get_trades Retrieve tick-level trade data for a specified stock. Use this to see every individual trade happening in the market. ### get_merchant_aggregates Retrieve aggregated European consumer spending data. Use this to see broader economic trends in the region. ### list_futures_contracts Discover listed futures contracts and specifications. It helps you identify available contracts for different assets. ### list_options_contracts Retrieve an index of options contracts. This is useful for seeing the full scope of options available for a ticker. ### list_ticker_types Retrieve a list of all ticker types supported. It helps you understand what kinds of assets you can query. ### list_tickers Retrieve a list of ticker symbols across asset classes. Use this to find the specific symbols you need for your analysis. ### get_crypto_trades Retrieve tick-level trade data for crypto pairs. This provides the raw data needed for detailed crypto analysis. ### get_custom_bars Retrieve aggregated historical OHLC and volume data for a stock. Use this to build charts or analyze past price action. ### get_treasury_yields Retrieve historical U.S. Treasury yield data. This helps you monitor the health of the bond market. ### list_exchanges Retrieve a list of known exchanges and their identifiers. Use this to find the correct exchange code for different markets. ## Prompt Examples **Prompt:** ``` What's the current status of the U.S. stock market and when is the next holiday? ``` **Response:** ``` The U.S. stock market is currently **Open**. Here is the upcoming holiday schedule: * **Presidents' Day**: February 19th Would you like me to check the status of any specific indices as well? ``` **Prompt:** ``` Give me a table of the dividend history for AAPL over the last 5 years. ``` **Response:** ``` Here is the historical dividend data for Apple Inc. (AAPL): | Year | Dividend Amount | | :--- | :--- | | 2023 | $0.94 | | 2022 | $0.94 | | 2021 | $0.88 | | 2020 | $0.80 | | 2019 | $0.72 | Would you like me to pull the split history for this ticker as well? ``` **Prompt:** ``` What are the latest news headlines for Tesla? ``` **Response:** ``` Here are the latest headlines for Tesla (TSLA) from Benzinga: * **Tesla shares rise on new production targets** * **Elon Musk comments on next-gen vehicle platform** * **Tesla battery production hits new milestone** Let me know if you want me to pull more details on any of these stories. ``` ## Capabilities ### Pull historical stock bars Get aggregated OHLC and volume data for any ticker over custom timeframes. ### Get real-time crypto trades Retrieve tick-level trade data for various crypto pairs. ### Check market status See if markets are currently open, closed, or in pre-market sessions. ### Fetch dividend and split history Retrieve historical payout data and stock split records for companies. ### Get treasury yield data Access historical U.S. Treasury yield data from 1-month to 30-year. ### Get live financial news Pull real-time structured news articles from Benzinga. ## Use Cases ### Checking market status and holidays A trader wants to know if the market is open and what the next holiday is. They ask the agent to check the current status and look up upcoming closures. ### Compiling dividend history An analyst needs to know the dividend history for a stock. They ask the agent to pull historical payouts and splits to compile a table. ### Verifying ticker types A developer is building a tool and needs to know what ticker types are available. They ask the agent to list all supported types. ### Analyzing crypto trades A crypto enthusiast wants to see the latest trades for a specific pair. They ask the agent to pull the latest tick-level trade data. ## Benefits - Stop switching tabs between your research and your data source by pulling stock prices directly into your chat. - Build faster research reports by using get_dividends and get_splits to pull historical data in seconds. - Stay on top of the news with get_news which pulls structured articles from Benzinga into your current session. - Monitor market sentiment quickly using get_market_snapshot to see how the entire U.S. market is moving. - Analyze crypto trends with get_crypto_trades which provides tick-level data for your agent to process. - Simplify technical analysis by asking your agent to calculate the get_sma indicator for any ticker. ## How It Works The bottom line is you get instant, high-quality financial data inside your AI chat. 1. Subscribe to the Polygon.io MCP on Vinkius. 2. Add your Polygon.io API key to your configuration. 3. Ask your agent to pull stock prices, news, or historical data. ## Frequently Asked Questions **Can the Polygon.io MCP get real-time crypto prices?** Yes, it pulls tick-level trade data for crypto pairs, allowing you to see live price movements in your chat. **Does Polygon.io MCP work for international stocks?** Yes, it supports various asset classes including stocks and forex, providing a wide range of global market coverage. **Can I use Polygon.io MCP to check market holidays?** Yes, you can ask about upcoming holidays that affect market hours to help plan your trading schedule. **Does Polygon.io MCP provide news?** It pulls real-time, structured news articles from Benzinga so you can stay updated on company headlines. **Can I get historical data with Polygon.io MCP?** Yes, it can pull historical OHLC bars and volume data for various tickers over custom timeframes. **Does Polygon.io MCP support technical indicators?** Yes, it can retrieve the Simple Moving Average (SMA) and other metrics to help you analyze price trends. **How can I get historical price data for a specific stock like Apple?** You can use the `get_custom_bars` tool. Provide the ticker 'AAPL', a multiplier (e.g., '1'), a timespan (e.g., 'day'), and the date range ('from' and 'to') to receive detailed OHLC and volume data. **Can I check if the stock market is currently open or if there's a holiday?** Yes. Use `get_market_status` to see the current state of various exchanges, and `get_market_holidays` to see upcoming dates when the markets will be closed. **How do I find the ticker symbol for a company if I only know its name?** Use the `list_tickers` tool and provide the company name in the `search` parameter. The agent will return a list of matching tickers along with their primary exchange and asset class.