The official MCP-server for EODHD makes it easy for AI agents and large language models (LLMs) to connect with real-time and historical financial data using the Model Context Protocol (MCP). With this integration, not only popular AI platforms like ChatGPT and Claude can access EODHD’s rich financial datasets, but also any custom-trained LLMs, AI assistants, or autonomous agents. This gives developers and fintech teams a powerful way to bring stock market data, fundamental datasets, and intraday quotes directly into their AI workflows.
Server
https://mcp.eodhd.dev/mcpParameters
To access our server, you need to provide an API key as a parameter. This is how we determine which data a user can access. Sign up for free to get your API key. The free plan grants access to limited data – you can compare access levels on our pricing page. You can also use the “demo” key:
- You can start with “DEMO” API key to test the data for a few tickers only: AAPL.US, TSLA.US, VTI.US, AMZN.US, BTC-USD.CC and EURUSD.FOREX. For these tickers, all of our types of data (APIs), including Real-Time Data, are available without limitations.
- Register for the free plan to receive your API key (limited to 20 API calls per day) with access to End-Of-Day Historical Stock Market Data API for any ticker, but within the past year only. Plus a List of tickers per Exchange is available.
- We recommend to explore our plans, starting from $19.99, to access the necessary type of data without limitations.
https://mcp.eodhd.dev/mcp?apikey=YOUR_API_KEYHow to add MCP server to ChatGPT
| Action | Explanation / What to check |
|---|---|
| 1. Open ChatGPT → go to Settings | In web or desktop app. Your ChatGPT plan (Plus, Pro, Business, Enterprise, etc.) must support connectors / MCP. Business, Enterprise accounts – available only for the owner. |
| 2. Enable Developer Mode under “Connectors” or advanced settings | This unlocks the ability to add a custom MCP connector. |
| 3. Go to Connectors (or “Sources”) tab and click Add connector / source | You should see an option to “Add MCP server” or similar. |
| 4. Enter MCP server URL – https://mcp.eodhd.dev/mcp?apikey=YOUR_API_KEY and a label/name | Use the full URL path (ending in /mcp) if required by ChatGPT UI. Add your own API key taken from EODHD dashboard. |
| 5. Save / enable the connector | After adding, the connector becomes available (for your user or workspace). (OpenAI Help Center) |
| 6. In a new Chat, click “Add sources” (or “+ / Sources”) and select your newly added MCP connector | This attaches the MCP to that chat session. (Vercel) |
Use a tool through the MCP For example, ask ChatGPT:
“Use the get_stock_price tool via EODHD to fetch AAPL historical data for 2024”
ChatGPT will call the MCP server under the hood, execute the tool, and return results.
Tools
EODHD main datasets:
| Tool | Description | Documentation |
|---|---|---|
| get_historical_stock_prices | Retrieve end-of-day historical stock prices for a given symbol and date range. | API Documentation |
| get_live_price_data | Get live quote data for stocks, ETFs, indices, and other instruments. | API Documentation |
| get_intraday_historical_data | Fetch historical intraday data (minute/hour resolution) for a symbol. | API Documentation |
| get_fundamentals_data | Retrieve fundamental company data (financial statements, ratios, etc.). | API Documentation |
| get_us_tick_data | Access U.S. tick-by-tick trade and quote data. | API Documentation |
| get_historical_market_cap | Retrieve historical market capitalization values for a company. | API Documentation |
| get_company_news | Get recent or historical news articles related to a company/ticker. | API Documentation |
| get_sentiment_data | Returns sentiment analysis data (positive/negative/neutral) on news or social content. | API Documentation |
| get_news_word_weights | Extract weighted keyword data from financial news. | API Documentation |
| get_exchanges_list | Retrieve a full list of supported stock exchanges. | API Documentation |
| get_exchange_tickers | Get all tickers listed on a specific exchange. | API Documentation |
| get_exchange_details | Fetch detailed metadata about a particular exchange. | API Documentation |
| get_macro_indicator | Access macroeconomic indicators (GDP, inflation, etc.). | API Documentation |
| get_economic_events | Get global economic events calendar with forecasts and actuals. | API Documentation |
| get_symbol_change_history | Retrieve history of symbol/ticker changes (e.g., renames, delistings). | API Documentation |
| get_stocks_from_search | Search stocks and instruments by name, ticker, or ISIN. | API Documentation |
| get_user_details | Retrieve account information and API usage details. | API Documentation |
| get_insider_transactions | Access insider transaction reports for U.S. public companies. | API Documentation |
| get_capture_realtime_ws | Connect to WebSocket to capture real-time data streams. | API Documentation |
| get_stock_screener_data | Use stock screener filters to retrieve matching instruments. | API Documentation |
| get_upcoming_earnings | List upcoming earnings reports with dates and expectations. | API Documentation |
| get_earnings_trends | Retrieve historical and forecasted earnings trends for a company. | API Documentation |
| get_upcoming_ipos | Get calendar of upcoming IPOs with details. | API Documentation |
| get_upcoming_splits | Access information on upcoming stock splits. | API Documentation |
Marketplace products:
| Tool | Description | Documentation |
|---|---|---|
| get_mp_us_options_contracts | Retrieve available U.S. options contracts for an underlying asset. | API Documentation |
| get_mp_us_options_eod | Access end-of-day data for U.S. options contracts. | API Documentation |
| get_mp_us_options_underlyings | Get list of underlying assets available in the U.S. options dataset. | API Documentation |
| get_mp_indices_list | Retrieve a list of supported indices in the marketplace dataset. | API Documentation |
| get_mp_index_components | Get components/constituents of a selected index. | API Documentation |
More endpoints and datasets to be added soon. Feel free to contact our support if you are expecting something specific.
