# MarketStack MCP for AI Agents AI Agent Connect

> MarketStack MCP lets your AI agent pull real-time and historical stock market data from over 70 global exchanges. Get end-of-day prices, intraday points, and ticker metadata without leaving your chat or code editor. It is your direct line to global equities and corporate actions like dividends and splits.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_Kz59N6U7aUbf2YonH0LW64Fzw9wmXcB700y6VVgy/ai-agent-connect
- **Tags:** stock-market, financial-data, trading, market-analysis, equities

## Description

MarketStack gives your agent a direct line to global stock markets. Instead of jumping between tabs to find a ticker's history or checking a company's latest SEC filings, you can just ask your agent to do it. It pulls data from dozens of exchanges, meaning you get a global view of the market rather than just a local one. You can grab end-of-day prices for a massive list of symbols or drill down into specific intraday movements to see how a stock behaved during a trading session. It also handles the heavy lifting for fundamental analysis, pulling things like company facts, CIK codes, and historical corporate actions. If you're building a financial dashboard or just need to see how a dividend schedule looks for a specific ticker, this Connector does the searching for you. It's one of the ways Vinkius makes it easy to connect your agent to high-quality, structured financial data without needing to write custom scrapers or manage complex API keys yourself. You can use it to build out complete investment profiles or to stay on top of corporate events like stock splits and dividends as they happen. By letting your agent handle the data fetching, you spend less time on manual research and more time making actual decisions. Whether you are looking at domestic equities or international markets, you get the same level of detail and reliability.

## Tools

### get_eod
Fetch end-of-day data for one or many stock tickers at once. This helps you quickly see closing prices for your watchlist.

### get_company_concepts
Retrieve specific financial concepts for a company using its CIK code. This is useful for deep fundamental analysis.

### get_company_facts
Get structured financial data for a company. Use this to pull core facts for a specific ticker.

### get_company_name
Look up a company name based on its CIK code. It helps when you only have the identifier but need the name.

### get_exchange_tickers
List every ticker currently available on a specific exchange. This helps you see the full scope of a specific market.

### get_exchange
Pull detailed information for a specific stock exchange. Use this to get market identifiers like MIC codes.

### get_submissions
Retrieve the latest SEC submissions for a company. This is the best way to find recent filings quickly.

### get_ticker_eod
Get the end-of-day data for a single stock ticker. This is a quick way to check a specific company's daily close.

### get_ticker_intraday
Fetch intraday price points for a single stock ticker. This is useful for watching a stock move during the day.

### get_ticker
Pull all the details for a specific stock ticker. This helps you get a full profile of a company's market presence.

### get_intraday
Retrieve intraday data points for one or multiple stock tickers. Use this to track several stocks at once.

### list_currencies
See a list of all supported currencies. This is helpful for international market research.

### list_dividends
Get historical dividend data for assets. This helps you see the payout history for a specific stock.

### list_exchanges
List every supported stock exchange in the database. Use this to see which global markets are available.

### list_splits
Retrieve historical stock split data. This is key for understanding historical price adjustments.

### list_tickers
List all available stock tickers across the platform. This helps you see the full breadth of available data.

### list_timezones
See the list of supported timezones. This is useful for coordinating international market hours.

### get_cik_code
Find the specific CIK code for any company. You can use this to identify the correct SEC identifier for a ticker.

## Prompt Examples

**Prompt:** 
```
What's the current price of Apple and Microsoft?
```

**Response:** 
```
Here are the current market prices for Apple and Microsoft:

| Ticker | Company | Price |
| :--- | :--- | :--- |
| **AAPL** | Apple Inc. | **$189.45** |
| **MSFT** | Microsoft Corp. | **$410.50** |

Would you like to see the intraday movement for either of these?
```

**Prompt:** 
```
List the SEC filings for Nvidia.
```

**Response:** 
```
I've found the most recent SEC submissions for NVIDIA Corporation:

*   **10-Q** - Oct 24, 2023
*   **8-K** - Oct 20, 2023
*   **DEF 14A** - Sept 15, 2023

Let me know if you want me to pull more details on a specific filing.
```

**Prompt:** 
```
Give me a list of US stock exchanges.
```

**Response:** 
```
Here are the supported US-based exchanges:

*   **NYSE** (MIC: XNYS)
*   **NASDAQ** (MIC: XNAS)
*   **Investors Exchange** (MIC: IEXG)

I can provide specific ticker lists for any of these exchanges if you'd like.
```

## Capabilities

### Pull end-of-day stock prices
Fetch closing prices for one or many stock tickers at once.

### Track intraday price movements
Get specific price points for tickers during active trading sessions.

### Look up company CIK codes
Identify the unique SEC identifier for any publicly traded company.

### Fetch historical dividend data
Retrieve a history of dividend payments for specific assets.

### Get SEC company submissions
Pull the latest filings and documents submitted to the SEC.

### Identify all tickers on a specific exchange
List every ticker currently available on a specific global exchange.

## Use Cases

### Comparing daily performance
A trader asks their agent to show the last 5 days of prices for Apple and Microsoft. The agent uses `get_eod` to create a comparison table.

### Finding recent SEC filings
An analyst needs to see what Tesla filed this week. The agent uses `get_submissions` to list the latest documents with dates.

### Identifying US exchanges
A developer wants to know which US markets are supported. The agent uses `list_exchanges` to provide a list of MIC codes.

### Researching dividend history
A user wants to know how often a company pays out. The agent uses `list_dividends` to generate a historical payout list.

## Benefits

- Stop manual copy-pasting by using `get_eod` and `get_intraday` to pull prices directly into your chat.
- Speed up fundamental research by pulling SEC filings with `get_submissions` and `get_company_facts`.
- Track corporate actions accurately using `list_dividends` and `list_splits` for better portfolio analysis.
- Identify global market opportunities by listing all tickers on specific exchanges with `list_exchanges`.
- Automate metadata collection for apps by using `get_ticker` and `get_exchange` to fill out database fields.

## How It Works

The bottom line is you get structured market data directly in your chat or IDE.

1. Connect the MarketStack MCP to your AI client via Vinkius.
2. Enter your MarketStack Access Key in the configuration settings.
3. Ask your agent to pull ticker data, dividends, or SEC filings in plain English.

## Frequently Asked Questions

**Can MarketStack MCP get real-time data?**
Yes, it provides intraday price points for specific tickers, allowing you to see how stocks are moving during active trading hours.

**Does MarketStack MCP cover international markets?**
Yes, it supports over 70 global exchanges, giving you access to data far beyond just the US markets.

**Can I use MarketStack MCP for dividend history?**
Yes, you can pull historical dividend data for specific assets to help with your long-term investment research.

**Does MarketStack MCP show SEC filings?**
It can retrieve the latest SEC submissions for a company, making it easy to stay updated on official corporate disclosures.

**Is MarketStack MCP good for building a finance app?**
Yes, it is great for developers because it provides structured ticker metadata and exchange details for your application.

**Can MarketStack MCP find a company's CIK code?**
Yes, it can identify the unique SEC CIK code for a company based on its ticker or name, which is essential for deeper research.

**Can I get intraday data for specific time intervals?**
Yes! Use the `get_intraday` tool. You can specify intervals such as '1min', '5min', '1hour', and up to '24hour' to get precise price movements throughout the trading day.

**How do I find which stock exchanges are supported by this server?**
Simply run the `list_exchanges` tool. It will return a paginated list of all supported global exchanges along with their names, MIC codes, and locations.

**Can I filter end-of-day data for a specific date range?**
Absolutely. Both `get_eod` and `get_ticker_eod` tools accept `date_from` and `date_to` parameters in YYYY-MM-DD format to help you analyze specific historical periods.