# EODHD Financial MCP

> EODHD Financial provides professional-grade stock market data from global exchanges. Your AI client can pull real-time prices, historical OHLCV records, company fundamentals, dividend payouts, and split histories for any ticker across major markets like the US, Germany, London, and Tokyo.

## Overview
- **Category:** data-analytics
- **Price:** Free
- **Tags:** stock-market, financial-data, market-prices, historical-data, investment-analysis, fundamental-data

## Description

Need to understand a stock's performance across different markets? This MCP connects your agent directly to global financial data. Instead of hopping between specialized websites or running complex spreadsheet formulas, you talk to your AI client, and it fetches exactly what you need.

Want to check the current price for five stocks and then pull the P/E ratio for one of them? You just ask. It handles the multi-ticker requests and pulls fundamental data points like market cap or earnings reports automatically. If you're building an advanced analysis pipeline, this MCP acts as a reliable source of truth, pulling historical prices (daily, weekly, monthly) and tracking every dividend payment or stock split for multiple tickers at once. Since it's hosted on Vinkius, your AI client can treat all this financial data just like any other service connected in the catalog.

## Tools

### get_dividends
Retrieves a stock's dividend payment history, including dates and amounts per share.

### get_eod_data
Fetches historical end-of-day price data (OHLCV) for a specified date range.

### get_exchange_symbols
Lists all valid symbol codes, names, and country information for specific global exchanges.

### get_fundamentals
Returns key financial metrics like P/E ratios, market cap, and earnings reports for a given stock.

### get_historical_dividends
Retrieves dividend dates and amounts simultaneously for multiple comma-separated tickers.

### get_historical_splits
Gets the history of stock splits, including dates and ratios, for a list of tickers.

### get_multi_price
Returns the current price, change, and percentage change for several specified tickers at once.

### get_realtime_price
Provides the immediate stock price, open, high, low, volume, and change metrics for a single ticker.

### get_splits
Retrieves a stock's historical split dates and ratios for a specified symbol.

### search_tickers
Finds matching stock symbols, names, and countries to ensure correct ticker formatting for other calls.

## Prompt Examples

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

**Response:** 
```
AAPL.US: $198.45 (Open: $197.20, High: $199.10, Low: $196.80). Previous close: $197.50. Change: +$0.95 (+0.48%). Volume: 45.2M.
```

**Prompt:** 
```
Show me Microsoft's fundamentals.
```

**Response:** 
```
MSFT.US fundamentals: Market Cap: $3.1T, P/E: 36.5, EPS: $13.50, Dividend Yield: 0.72%, Beta: 0.89. 52-week high: $468.35, 52-week low: $309.45. Sector: Technology, Industry: Software.
```

**Prompt:** 
```
Get prices for AAPL, MSFT and GOOGL.
```

**Response:** 
```
AAPL.US: $198.45 (+0.48%), MSFT.US: $432.10 (+1.2%), GOOGL.US: $175.80 (-0.3%). All prices are real-time with volume data.
```

## Capabilities

### Fetch real-time market prices
Get current stock metrics, including volume and change percentage, for single or multiple tickers.

### Retrieve historical price data
Download end-of-day price records spanning years, filtering by day, week, or month.

### Access core company fundamentals
Pull key financial metrics like market cap, P/E ratios, and earnings statements for deep valuation analysis.

### Track dividend history
View a stock's complete payout record, including ex-dividend dates and amounts paid per share.

### Monitor corporate actions
Get detailed records of all historical stock splits (e.g., 2:1 ratios) across multiple tickers.

## Use Cases

### Comparing rival tech companies' market value
A portfolio manager needs a quick comparison of three rivals. Instead of visiting each company’s investor relations page, they ask the agent for fundamental data and use get_multi_price to compare current prices simultaneously.

### Validating an old investment thesis
A researcher needs to know how a stock performed over three years. They first run search_tickers to confirm the correct format, then use get_eod_data to pull the required historical OHLCV dataset for analysis.

### Reviewing dividend payouts across an international basket
A wealth advisor must check multiple global stocks. They use get_historical_dividends to retrieve dividend amounts and dates for all tickers in their client's portfolio simultaneously.

## Benefits

- Get immediate, detailed stock snapshots. Use the get_realtime_price tool to pull current price, open, high, low, volume, and change metrics for a single ticker without delay.
- Build deep historical models. The get_eod_data tool lets you download end-of-day OHLCV data for any date range, supporting daily, weekly, or monthly granularity.
- Analyze company health quickly. Use get_fundamentals to pull market cap, P/E ratios, and earnings reports directly into your conversation flow.
- Compare multiple assets effortlessly. The get_multi_price tool lets you check the current price changes for a list of stocks in one single query.
- Track corporate actions accurately. You can use get_historical_dividends or get_historical_splits to pull comprehensive records across several tickers at once.

## How It Works

The bottom line is you ask for financial data in plain English, and this MCP handles all the API calls to get it back structured for immediate use.

1. First, subscribe to the MCP and provide your EODHD API key within your AI client.
2. Second, tell your agent exactly what you need—for example, 'What was AAPL's price history between 2023 and 2024?'
3. Finally, the MCP executes the request, returning structured data containing prices, fundamentals, or dividend records directly to your chat interface.

## Frequently Asked Questions

**How do I find the correct ticker symbol before using EODHD Financial MCP?**
You use the search_tickers tool. This function returns a list of matching symbols, names, and country codes, ensuring you have the precise format required for all other calls like get_realtime_price.

**Can I compare prices for multiple stocks using EODHD Financial MCP?**
Yes. Use the get_multi_price tool to pull the current price, change percentage, and volume simultaneously for a comma-separated list of tickers.

**What kind of historical data can I get with the EODHD Financial MCP?**
You can fetch end-of-day price history (OHLCV) using get_eod_data, which supports date range filtering for daily, weekly, and monthly periods.

**Does EODHD Financial MCP handle international exchanges?**
Yes. The service supports major global exchanges like the US, Germany (XETRA), London, Tokyo, and Paris, allowing you to pull data from diverse markets.

**How do I check a stock's fundamental metrics with EODHD Financial MCP?**
Use get_fundamentals. You provide the ticker and can filter for specific sections like 'General,' or 'Valuation' to pull P/E ratios, market cap, and earnings.