# EODHD APIs — how to use (mcp.ai)

Connect your EODHD APIs account and use 11 tools for analytics straight from your AI agent. Connect with your own API key. EODHD APIs provide comprehensive financial data, including historical stock market data, live stock prices, fundamental data, and more, accessible via REST and WebSocket APIs.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_eodhd_apis?ms=1787296080000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `eodhd_apis_get_eod_yahoo_style`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/eodhd_apis`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/eodhd_apis/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/eodhd_apis/get/eod/yahoo/style` — Retrieves end-of-day historical stock price data using Yahoo Finance style parameters via EODHD API. Returns OHLCV (Open, High, Low, Close, Volume) data plus adjusted close prices for stocks, ETFs, mu
  - body: { a: string, b: string, c: string, d: string, e: string, f: string, g: string, s: string, fmt?: string }
- `POST https://api.mcp.ai/api/eodhd_apis/get/id/mapping` — Tool to convert between different security identifiers (CUSIP, ISIN, FIGI, LEI, CIK, ticker symbol). Use when you need to map one type of identifier to another, normalize portfolio data, or cross-refe
  - body: { fmt?: string, filter_ex?: string, filter_cik?: string, filter_lei?: string, page_limit?: integer, filter_figi?: string, filter_isin?: string, page_offset?: integer, filter_cusip?: string, filter_symbol?: string }
- `POST https://api.mcp.ai/api/eodhd_apis/get/macro/indicators` — Retrieve macroeconomic indicator data for a specific country from EODHD. Returns historical time series data for economic indicators like GDP, inflation, unemployment, population, and many more. Data 
  - body: { country: string, indicator?: string }
- `POST https://api.mcp.ai/api/eodhd_apis/get/mutual/funds/data` — Retrieves comprehensive fundamental data for mutual funds via EODHD API. Returns fund details including general information (name, family, inception date, summary), asset allocation (cash, stocks, bon
  - body: { filter?: string, ticker: string }
- `POST https://api.mcp.ai/api/eodhd_apis/get/real/time/quote` — Retrieves real-time (delayed 15-20 minutes for stocks, ~1 minute for forex) OHLCV data for stocks, forex, and cryptocurrencies. Returns latest 1-minute bar with open, high, low, close, volume, previou
  - body: { s?: string, fmt?: string, symbol: string }
- `POST https://api.mcp.ai/api/eodhd_apis/get/real/time/websocket/forex` — Provides WebSocket connection details for real-time FOREX currency pair data from EODHD. Returns the WebSocket endpoint URL and subscription message needed to receive live bid/ask prices with ~50ms la
  - body: { symbols: string[] }
- `POST https://api.mcp.ai/api/eodhd_apis/get/real/time/websocket/us/trade` — Tool to retrieve real-time trade data for the US market via WebSocket. Use when live updates for specific US symbols are required. Example: subscribe to ['AAPL', 'GOOG'].
  - body: { action: string, symbols: string[] }
- `POST https://api.mcp.ai/api/eodhd_apis/get/user/info` — Retrieve current user account information and API usage statistics from EODHD. Returns details including subscription type, daily rate limits, number of API requests made, email, name, and payment met
  - body: { fmt?: string }
- `POST https://api.mcp.ai/api/eodhd_apis/get/ust/yield/rates` — Retrieve US Treasury yield curve rates from EODHD API. Returns historical par yield data across all maturities (1 month, 6 months, 1 year, 2 years, 5 years, 10 years, 30 years, etc.). Use this when yo
  - body: { to?: string, from?: string, limit?: integer, offset?: integer, filter_year?: integer }
- `POST https://api.mcp.ai/api/eodhd_apis/list/exchanges` — Retrieve a list of all supported stock exchanges from EODHD API. Returns exchange codes, names, countries, and currencies for 70+ global exchanges. Use this when you need to discover available exchang
  - body: { fmt?: string }
- `POST https://api.mcp.ai/api/eodhd_apis/search/instruments` — Search for stocks, ETFs, mutual funds, bonds, and indices by ticker symbol, company name, or ISIN. Use when you need to find instruments by name or identifier, discover available tickers, or look up s
  - body: { type?: string, limit?: integer, query: string, exchange?: string }

## Example prompts
- "What can I do in EODHD APIs?"
- "Show me a summary of my EODHD APIs account"

## More
- Page: https://mcp.ai/eodhd_apis
- Agent spec (llms.txt): https://mcp.ai/eodhd_apis/llms.txt
- Postman collection: https://mcp.ai/eodhd_apis/postman.json