# IEX Cloud MCP

> IEX Cloud lets your agent pull real-time financial data: stock quotes, crypto prices, FX rates, historical charts, and market metrics. You get instant access to things like a company's balance sheet or today's top gainers without opening ten browser tabs. It’s professional-grade intelligence for any AI client.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** stock-market, financial-data, cryptocurrency, market-analysis, investment-tools

## Description

Connect this MCP to your agent, and you immediately get professional financial intelligence. Instead of switching between terminals and websites—which is slow, right?—your agent handles the data retrieval automatically. Need a quick check on NVIDIA's current price alongside Bitcoin’s rate? Just ask. You can run complex analyses using historical reports or track global economic indicators like US Treasury yields. This capability makes it possible for your AI client to perform deep market analysis without you writing boilerplate API calls yourself. It just works, giving you the data points needed for everything from quarterly report drafting to testing fintech ideas. If you're building an automated research tool, Vinkius hosts this MCP right where all the other specialized APIs live, making it easy for your agent to access financial data alongside other services.

## Tools

### get_stock_chart
Fetches detailed historical price data necessary to generate a stock's charting history.

### get_crypto_quote
Retrieves current, real-time quotes for any cryptocurrency symbol.

### get_upcoming_earnings
Shows a calendar of future scheduled corporate earnings release dates.

### get_stock_financials
Retrieves fundamental company reports, including income statements and balance sheets.

### get_fx_latest
Gets the most recent foreign exchange rates between two fiat currencies.

### get_market_list
Pulls lists of stocks based on criteria like highest volume or biggest percentage moves.

### get_stock_news
Gathers the latest headlines and articles related to a specific stock symbol.

### get_stock_quote
Delivers up-to-the-second price, trading volume, and market cap for one stock.

### get_sector_performance
Calculates and reports performance metrics for all defined market sectors (e.g., tech, healthcare).

### get_stock_stats
Provides key fundamental statistics about a company beyond just the current quote.

### get_treasury_yield
Retrieves the current yield for various US Treasury bonds.

## Prompt Examples

**Prompt:** 
```
What is the current price and market cap of NVIDIA (NVDA)?
```

**Response:** 
```
I'll check the latest quote for NVDA... The current price is $135.58 with a market cap of approximately $3.33 trillion. Trading volume today is 42.1 million shares.
```

**Prompt:** 
```
Show me the latest news for Microsoft.
```

**Response:** 
```
Fetching the latest headlines for MSFT... I found several recent articles, including a report on their latest AI integration and a summary of their quarterly cloud growth.
```

**Prompt:** 
```
Which stocks are the top gainers in the market today?
```

**Response:** 
```
Querying the market lists... The top gainers today are led by 'TechSolutions Inc' (+12.4%) and 'BioHealth Corp' (+8.9%). Would you like details on any of these?
```

## Capabilities

### Get stock quotes
Retrieve real-time pricing, volume, and market capitalization metrics for any listed stock.

### Analyze historical performance
Fetch time-series data and financial reports (like balance sheets) over defined date ranges.

### Benchmark entire markets
List the most active, top gaining, or worst performing stocks across major market sectors.

### Track alternative assets
Get real-time quotes for cryptocurrencies and current foreign exchange rates.

### Monitor macroeconomics
Access key US economic data, such as Treasury yields or upcoming earnings calendars.

## Use Cases

### Quickly assessing a potential investment target.
A junior analyst needs to vet three stocks. Instead of calling the exchange website three times, they ask their agent: 'Give me the quote for NVDA, its key stats, and any recent news.' The MCP pulls everything using `get_stock_quote`, `get_stock_stats`, and `get_stock_news` in one go.

### Analyzing geopolitical risk impact on a portfolio.
A portfolio manager needs to see how changes in the US debt market affect their holdings. The agent runs checks using `get_treasury_yield`, then compares those results with sector performance data from `get_sector_performance`.

### Developing a crypto/fiat comparison tool.
A developer building a trading bot needs real-time pairing. They use the MCP to pull current Bitcoin prices using `get_crypto_quote` and pair those metrics with up-to-the-minute currency exchange rates via `get_fx_latest`.

### Preparing for an earnings call review.
A finance professional needs to summarize a company's health. They ask the agent to retrieve the full financial statement using `get_stock_financials`, and then cross-reference it with the nearest upcoming report date from `get_upcoming_earnings`.

## Benefits

- Instantly check a stock's current status. Instead of jumping through tabs, you ask for the quote, and it returns the price, volume, and market cap via `get_stock_quote`.
- Build deeper reports using fundamental data. You can automate fetching income statements, balance sheets, and cash flow reports with `get_stock_financials`.
- Compare assets across markets. Get current crypto prices from `get_crypto_quote` and compare them directly against real-time FX rates from `get_fx_latest`.
- Track market movements quickly. Need to know who's winning today? Use `get_market_list` to see the top gainers or biggest losers without manual searching.
- Understand macro risks easily. You can pull US Treasury yields via `get_treasury_yield` and pair that data with upcoming earnings dates from `get_upcoming_earnings` for context.

## How It Works

The bottom line is you ask for an insight, and this MCP gives your agent the raw, accurate numbers needed to build it.

1. Subscribe to this MCP and enter your IEX Cloud API Token into your agent client.
2. Ask your AI client a specific question, like 'What was Apple's stock price last year?'
3. The MCP executes the necessary tool call, sending back structured data (e.g., historical chart data) that your agent can interpret and summarize.

## Frequently Asked Questions

**Can I see historical price trends for a specific stock?**
Yes. Use the `get_stock_chart` tool by providing the symbol and a range (like '1m' or '1y') to retrieve historical data points for analysis.

**Does this server support cryptocurrency prices?**
Absolutely. You can use `get_crypto_quote` with symbols like 'BTCUSD' to get real-time pricing and market data for major digital assets.

**How can I find out which companies are reporting earnings soon?**
Use the `get_upcoming_earnings` tool. It returns a calendar of companies scheduled to release their financial results in the near future.

**How do I authenticate when calling a function like `get_stock_quote`?**
You must provide an active API token. When connecting the MCP to your agent, you input this token as part of the setup process. This guarantees that every action taken through your AI client is properly authorized with IEX Cloud.

**Are there rate limits when calling `get_stock_quote` or other tools?**
Yes, API usage is governed by quotas set by the provider. You need to check your specific IEX Cloud plan for current call limits. It’s important that your agent logic includes error handling to gracefully manage these potential rate limit responses.

**What kind of financial reports can `get_stock_financials` retrieve?**
This tool retrieves core company documents, including the income statement, balance sheet, and cash flow. It gives analysts a deep view into corporate health that goes well beyond just current stock pricing.

**Does the MCP support global currency pairs using `get_fx_latest`?**
Yes, it provides real-time foreign exchange rates for many major and minor currency pairs. Just specify the two currencies you need to get their current cross-rate immediately.

**What should I do if `get_market_list` fails or returns an empty list?**
Failure usually means the requested market criteria are invalid or temporarily unavailable. Your agent should be designed to catch these errors and prompt you for alternative parameters, like changing the time frame or sector.