# MarketStack MCP

> MarketStack provides direct access to massive global stock market data, letting your AI client pull everything from end-of-day prices and historical dividends to real-time intraday points across 70+ exchanges. Get fundamental company facts and SEC filings for deep financial analysis.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** stock-market, financial-data, trading, market-analysis, equities

## Description

You can connect MarketStack to your AI agent to access a massive database of global stock market information. Instead of jumping between dozens of websites or juggling spreadsheet exports, you ask your agent directly for data points. Need historical performance? You get end-of-day prices and intraday intervals for thousands of tickers globally. Want to understand a company's foundation? You can retrieve specific financial concepts, SEC filings, and CIK codes right in the chat window. This makes fundamental research instant. Since Vinkius hosts this MCP, you connect your preferred AI client once—whether it’s Claude, Cursor, or Windsurf—and immediately gain access to global market data analysis tools.

It's simple: tell your agent what tickers and dates you need, and it pulls the structured data so you can analyze trends instantly.

## Tools

### get_eod
Retrieves end-of-day price data for multiple stock tickers using comma-separated symbols.

### get_cik_code
Finds the Corporate Identifier Code (CIK) number associated with a company name.

### get_company_concepts
Retrieves specific structured financial data points for a company using its CIK code.

### get_company_facts
Pulls detailed, structured fundamental financial data about any listed corporation.

### get_company_name
Identifies a company's official name if you only have its CIK code.

### get_exchange_tickers
Lists all available stock tickers that trade on a specified exchange.

### get_exchange
Retrieves detailed information about a specific global stock exchange.

### get_submissions
Gets records of SEC filings submitted by a company, tracking regulatory activity.

### get_ticker_eod
Fetches end-of-day price data for one specific stock ticker symbol.

### get_ticker_intraday
Retrieves intraday price points for a single, specified stock ticker.

### get_ticker
Gets general details and metadata about a specific stock ticker symbol.

### get_intraday
Retrieves intraday price data points for multiple tickers using comma-separated symbols.

### list_currencies
Shows a list of all supported global currencies and their codes.

### list_dividends
Retrieves the historical record of dividend payments for any company.

### list_exchanges
Lists all supported stock exchanges across different global markets.

### list_splits
Retrieves the historical data regarding stock splits for a given company.

### list_tickers
Lists every available ticker symbol across all supported exchanges.

### list_timezones
Provides a list of time zones supported by the data for accurate timestamping.

## Prompt Examples

**Prompt:** 
```
Get the end-of-day stock prices for AAPL and MSFT for the last 5 days.
```

**Response:** 
```
I've retrieved the EOD data for Apple (AAPL) and Microsoft (MSFT). Over the last 5 trading days, AAPL moved from $185.92 to $189.45, while MSFT showed a steady increase from $402.12 to $410.50. Would you like the specific daily breakdown?
```

**Prompt:** 
```
List all stock exchanges in the United States supported by MarketStack.
```

**Response:** 
```
I found several US-based exchanges: New York Stock Exchange (MIC: XNYS), NASDAQ Stock Exchange (MIC: XNAS), and Investors Exchange (MIC: IEXG). I can provide more details on any of these using their MIC codes.
```

**Prompt:** 
```
Show me the intraday data for TSLA with a 1-hour interval.
```

**Response:** 
```
Fetching intraday points for Tesla (TSLA) at 1-hour intervals... The data shows the price opened at $175.20 at 09:30 and reached a peak of $178.50 by 14:30. Would you like to see the volume for these periods as well?
```

## Capabilities

### Retrieve historical pricing
Fetch end-of-day or intraday price points for one or multiple stocks across custom date ranges.

### Research company fundamentals
Pull structured financial data, SEC filings, and key identifiers (like CIK codes) for detailed corporate analysis.

### Track corporate actions
View the history of stock splits and dividends paid out by a company over time.

### Discover market assets
List all supported global exchanges, tickers, currencies, or timezones to scope your research.

## Use Cases

### Analyzing a competitor's financial health
A financial analyst needs to compare Company A and Company B. They ask their agent to retrieve both companies’ CIK codes using `get_cik_code`, then pull their most recent fundamental data with `get_company_facts` for a head-to-head report.

### Backtesting a trading strategy
A quant trader wants to test a moving average crossover on three different assets. They use the combined functionality of `get_intraday` and `get_eod` to pull clean, multi-ticker data sets for rapid backtesting.

### Understanding a stock's history
A portfolio manager is looking at an old holding. They ask the agent to check both historical dividends via `list_dividends` and any subsequent splits using `list_splits` to understand how the initial investment was diluted or rewarded.

### Global market coverage check
A developer needs to know all supported markets before writing a dashboard. They first call `list_exchanges` and then use `get_exchange_tickers` on a specific exchange to build out the entire list of tradable assets.

## Benefits

- Pull historical pricing for any portfolio. You can use `get_eod` or `get_intraday` to pull multi-day price points for multiple tickers at once, saving hours of manual spreadsheet work.
- Deepen fundamental analysis with company data. Use tools like `get_company_facts` and `get_submissions` to quickly gather SEC filings and structured financial metrics on a company without leaving your chat window.
- Track ownership changes effortlessly. Pulling historical records using `list_dividends` or `list_splits` allows you to understand how corporate actions have affected an asset's value over years.
- Scope your research globally. Instead of guessing where to look, use `list_exchanges` and `get_exchange` to confirm exactly which markets are supported for any given ticker.
- Build comprehensive profiles instantly. You can combine the general data from `get_ticker` with specific details like CIK codes using `get_cik_code`, creating a full asset profile in minutes.

## How It Works

The bottom line is that you stop looking up data and start analyzing it immediately within your workflow.

1. Subscribe to this MCP and enter your MarketStack Access Key.
2. Instruct your AI client with the specific symbols, date ranges, and data types you require (e.g., 'Get EOD prices for AAPL').
3. The agent calls the necessary tool, pulls the structured market data, and presents it directly in your chat interface.

## Frequently Asked Questions

**How do I check a ticker’s price history with MarketStack?**
You can pull historical prices using `get_eod` or `get_intraday`. Just provide the symbols and whether you need end-of-day points or intraday data points.

**Can I find a company’s CIK code with MarketStack?**
Yes, use the `get_cik_code` tool. You just provide the company name, and it returns their unique Corporate Identifier Code needed for other tools.

**How does MarketStack handle multiple stocks?**
The MCP handles multiple tickers efficiently. For pricing data, you list the symbols separated by commas in a single request to `get_eod` or `get_intraday`.

**What is the difference between get_company_facts and get_submissions?**
`get_company_facts` provides structured, high-level financial data (like revenue figures), while `get_submissions` pulls records of actual regulatory filings from the SEC.

**What if I only know the exchange name, not the ticker?**
You can use `list_exchanges` to find the supported market identifiers first. Then, use `get_exchange_tickers` on that specific exchange to get a full list of available symbols.