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:
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.
Using with Claude Desktop
A) Install via MCP bundle (.mcpb)
- Download the .mcpb from Releases (https://github.com/Enlavan/EODHD_MCP_server/releases).
- Claude Desktop → Settings → Extensions → Advanced → Install Extension.
- Select the .mcpb, approve, enter your API key, enable the extension.
B) Use source checkout (developer config)
- Clone this repo (https://github.com/Enlavan/EODHD_MCP_server) anywhere.
- Claude Desktop → Developer → Edit config, add:
{
"mcpServers": {
"eodhd-mcp": {
"command": "python3",
"args": [
"/home/user/EODHD_MCP_server/server.py", //actual path to the library
"--stdio"
],
"env": {
"EODHD_API_KEY": "YOUR_EODHD_API_KEY" //your valid EODHD API key
}
}
}
}Install and Run Locally
Our MCP server is open source and can be downloaded and run locally. Visit the EODHD GitHub repository to get started – setup instructions are provided in the readme.md file.
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 |
| 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 |
| get_dividends_data | Retrieve historical and upcoming dividend payments for a company. | Api Documentation |
| get_us_live_extended_quotes | New “Live v2” endpoint – provides extended live quotes for U.S. instruments. | Api Documentation |
| get_technical_indicators | Analytics tool – SMA, EMA, RSI, MACD, etc. | Api Documentation |
| get_historical_market_cap | Retrieve historical market capitalization data for a company over time. | API Documentation |
| get_upcoming_dividends | Access historical and upcoming dividend events with flexible filters by symbol or date. | API Documentation |
| get_cboe_indices_list | Retrieve a list of available CBOE indices with latest values and metadata. | API Documentation |
| get_cboe_index_data | Get detailed CBOE index data, including index levels and full component breakdown for a specific date and feed type. | API Documentation |
Marketplace products (by EODHD):
| 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 |
Marketplace products (third party providers):
| Tool | Description | Documentation |
|---|---|---|
| get_mp_illio_performance_insights | Illio performance analytics dataset. | API Documentation |
| get_mp_illio_risk_insights | Risk factor analytics from Illio. | Api Documentation |
| get_mp_illio_market_insights_performance | Market performance insights via Illio API. | Api Documentation |
| get_mp_illio_market_insights_best_worst | Best/worst performing instruments analytics. | Api Documentation |
| get_mp_illio_market_insights_volatility | Market volatility insights. | Api Documentation |
| get_mp_illio_market_insights_risk_return | Risk–return analysis showing how instruments perform relative to market risk. | API Documentation |
| get_mp_illio_market_insights_largest_volatility | Identify instruments with the largest increases and decreases in volatility over time. | API Documentation |
| get_mp_illio_market_insights_beta_bands | Analyze instrument sensitivity to market movements using beta band distributions. | API Documentation |
| Tool | Description | Documentation |
|---|---|---|
| get_mp_praams_risk_scoring_by_ticker | Retrieve Praams equity risk and return scoring for a company using its ticker symbol. | API Documentation |
| get_mp_praams_risk_scoring_by_isin | Retrieve Praams equity risk and return scoring for a company using its ISIN. | API Documentation |
| get_mp_praams_bond_analyze_by_isin | Access detailed Praams bond risk and return analysis for a specific bond identified by ISIN. | API Documentation |
| get_mp_praams_bank_income_statement_by_ticker | Retrieve bank income statement data using a ticker symbol, including core revenue and profitability metrics. | API Documentation |
| get_mp_praams_bank_income_statement_by_isin | Retrieve bank income statement data using an ISIN, including recurring and non-recurring income details. | API Documentation |
| get_mp_praams_bank_balance_sheet_by_ticker | Access detailed bank balance sheet data using a ticker symbol, including assets, liabilities, and equity. | API Documentation |
| get_mp_praams_bank_balance_sheet_by_isin | Access detailed bank balance sheet data using an ISIN, including assets, liabilities, and equity. | API Documentation |
| Tool | Description | Documentation |
|---|---|---|
| get_mp_investverte_esg_list_companies | Retrieve a list of companies covered by the Investverte ESG dataset. | API Documentation |
| get_mp_investverte_esg_list_countries | Retrieve a list of countries covered by the Investverte ESG dataset. | API Documentation |
| get_mp_investverte_esg_list_sectors | Retrieve a list of sectors available in the Investverte ESG dataset. | API Documentation |
| get_mp_investverte_esg_view_company | Access ESG ratings and scores for a specific company across environmental, social, and governance dimensions. | API Documentation |
| get_mp_investverte_esg_view_country | Access aggregated ESG ratings and scores for a specific country. | API Documentation |
| get_mp_investverte_esg_view_sector | View ESG data aggregated by sector and industry over time. | API Documentation |
More endpoints and datasets to be added soon. Feel free to contact our support if you are expecting something specific.
