--- source_url: "https://eodhd.com/financial-apis/mcp-server-for-financial-data-by-eodhd" title: "MCP Server For Financial Data by EODHD | EODHD APIs Documentation" mirrored_at: 2026-08-16T03:38:06.819Z host: eodhd.com cited_in_42a: true mirror_canonical: "https://index.42a.ai/eodhd.com/financial-apis/mcp-server-for-financial-data-by-eodhd" --- > **Original source:** https://eodhd.com/financial-apis/mcp-server-for-financial-data-by-eodhd 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, popular AI platforms like **ChatGPT** and **Claude**, as well as any custom-trained LLMs, AI assistants, or autonomous agents can access EODHD’s rich financial datasets. The server exposes **72 read-only tools**, **100+ documentation resources**, and **3 prompt templates** — giving developers and fintech teams a powerful way to bring stock market data, fundamentals, technical analysis, and macro indicators directly into their AI workflows. ## Server Versions EODHD provides two versions of the MCP server. Both share the same codebase, tools, and features — the only difference is the authorization method. Version URL Authorization Best for GitHub **v1** https://mcp.eodhd.com/v1/mcp?apikey=YOUR\_API\_KEY API key (passed as a URL parameter) ChatGPT, custom agents, programmatic access [EODHD-MCP-Server](https://github.com/EodHistoricalData/EODHD-MCP-Server) **v2** https://mcp.eodhd.com/v2/mcp OAuth 2.1 (built-in OAuth server) Claude Desktop and other clients with native OAuth support – ## v1 — API Key Authorization To access the v1 server, provide your API key as a URL parameter. 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](https://eodhd.com/pricing). You can also use the “demo” key: ``` https://mcp.eodhd.com/v1/mcp?apikey=YOUR_API_KEY ``` ## v2 — OAuth Authorization The v2 server includes a built-in lightweight OAuth server. Clients that support OAuth (such as Claude Desktop) can connect without manually passing an API key — the OAuth flow handles authentication automatically. Simply use the v2 URL and follow the OAuth consent flow in your client: ``` https://mcp.eodhd.com/v2/mcp ``` Both versions provide the same 72 tools and 100+ documentation resources. Choose v1 if your client expects an API key in the URL, or v2 if your client supports OAuth natively. ## Key Features ### Agent Documentation Resources The MCP server includes **100+ pages of EODHD API documentation** embedded directly as MCP resources. AI agents can look up endpoint details, available parameters, and subscription plan coverage without consuming any API calls. The documentation is parsed into structured JSON, so agents navigate it programmatically. This covers 72 endpoint reference pages, 7 subscription plan guides, and 28 general reference pages (authentication, data formats, exchange lists, rate limits, symbol conventions). The **retrieve\_description\_by\_id** tool provides instant access to any documentation page. ### Smart Ticker Resolution The **resolve\_ticker** tool converts company names, partial tickers, or ISINs into the correct **SYMBOL.EXCHANGE** format. For example, “Apple” resolves to **AAPL.US**, “Deutsche Bank” to **DBK.XETRA**. When a company trades on multiple exchanges, it returns the top 10 alternatives with exchange details. This is designed to be called first whenever a user mentions a company by name. ### Prompt Templates Three ready-to-use MCP prompt templates that chain multiple tools into complete workflows: - **analyze\_stock(ticker)** — Full single-stock analysis: fundamentals → historical prices → support/resistance → technicals → news. Outputs a summary with bull/bear case and key metrics. - **compare\_stocks(ticker1, ticker2)** — Side-by-side comparison: Market Cap, P/E, Revenue Growth, Profit Margin, 52W Return, Dividend Yield with a verdict. - **market\_overview(exchange)** — Daily market snapshot: top gainers/losers, upcoming economic events, earnings watch. ### Reliability - **Input formatters** — standardized input sanitization across all 72 tools. Accepts 30+ date formats (ISO, US, EU, named months, Unix timestamps) and normalizes automatically. Ticker and exchange sanitization prevents URL-breaking characters. - **Output formatters** — structured MCP resource responses with proper MIME types. Binary data (logos, PDFs) base64-encoded. API errors converted to structured ToolError messages. - **197 automated tests**, CI on Python 3.10–3.13. Security toolchain: Ruff, MyPy, Bandit, Semgrep, pip-audit. ## How to Add MCP Server to ChatGPT ChatGPT uses API key authorization — use the **v1** endpoint. **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.com/v1/mcp?apikey=YOUR\_API\_KEY and a label/name Use the full URL path (ending in /v1/mcp) with your API key. Get the key from the EODHD dashboard. 5\. Save / enable the connector After adding, the connector becomes available (for your user or workspace). 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. Use a tool through the MCP. For example, ask ChatGPT: _“Use the **get\_historical\_stock\_prices** 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 Claude Desktop supports OAuth natively — use the **v2** endpoint for the simplest setup. You can also use v1 with an API key if you prefer. ### Option 1: v2 with OAuth (recommended) Open Claude Desktop → **Settings → Extensions → Add** → paste the v2 server URL. The built-in OAuth server will handle authentication — you will be prompted to authorize through a consent flow, no API key needed. ``` https://mcp.eodhd.com/v2/mcp ``` ### Option 2: v1 with API key The simplest way is to add the v1 URL as a remote server directly: open Claude Desktop → **Settings → Extensions → Add** → paste the URL with your API key: ``` https://mcp.eodhd.com/v1/mcp?apikey=YOUR_API_KEY ``` Alternatively, you can download and run the server locally: #### A) Install via MCP bundle (.mcpb) 1. Download the .mcpb from Releases ([https://github.com/EodHistoricalData/EODHD-MCP-Server/releases](https://github.com/EodHistoricalData/EODHD-MCP-Server/releases)). 2. Claude Desktop → **Settings → Extensions → Advanced → Install Extension**. 3. Select the .mcpb, approve, enter your API key, enable the extension. #### B) Use source checkout (developer config) 1. Clone the repo ([https://github.com/EodHistoricalData/EODHD-MCP-Server](https://github.com/EodHistoricalData/EODHD-MCP-Server)) anywhere. 2. Claude Desktop → **Developer → Edit config**, add: ``` { "mcpServers": { "eodhd-mcp": { "command": "python3", "args": [ "/home/user/EODHD-MCP-Server/server.py", "--stdio" ], "env": { "EODHD_API_KEY": "YOUR_EODHD_API_KEY" } } } } ``` ## Install and Run Locally Both server versions are open source and can be downloaded and run locally. Visit the GitHub repositories to get started — setup instructions are provided in each README. The servers support three transports: **streamable-http** (default), **SSE** (Server-Sent Events), and **stdio** (for Claude Desktop and Claude Code). ## Tools Both v1 and v2 expose the same set of 72 tools. EODHD main datasets: Tool Description Documentation resolve\_ticker Resolve a company name, partial ticker, or ISIN to the correct SYMBOL.EXCHANGE format. Handles multi-exchange ambiguity. [API Documentation](https://eodhd.com/financial-apis/search-api-for-stocks-etfs-mutual-funds) retrieve\_description\_by\_id Access 100+ pages of embedded API documentation — endpoints, subscription plans, and general references. No API calls consumed. [GitHub](https://github.com/EodHistoricalData/EODHD-MCP-Server) get\_historical\_stock\_prices Retrieve end-of-day historical stock prices for a given symbol and date range. [API Documentation](https://eodhd.com/financial-apis/api-for-historical-data-and-volumes) get\_live\_price\_data Get live quote data for stocks, ETFs, indices, and other instruments. [API Documentation](https://eodhd.com/financial-apis/live-ohlcv-stocks-api) get\_intraday\_historical\_data Fetch historical intraday data (minute/hour resolution) for a symbol. [API Documentation](https://eodhd.com/financial-apis/intraday-historical-data-api) get\_fundamentals\_data Retrieve fundamental company data (financial statements, ratios, etc.). [API Documentation](https://eodhd.com/financial-apis/stock-etfs-fundamental-data-feeds) get\_bulk\_fundamentals Fetch fundamental data for all stocks on an exchange in bulk — up to 500 tickers per call. Covers General, Highlights, Valuation, Technicals, Earnings, Financials. [API Documentation](https://eodhd.com/financial-apis/bulk-fundamentals-api-via-extended-fundamentals-plan) get\_us\_tick\_data Access U.S. tick-by-tick trade and quote data. [API Documentation](https://eodhd.com/financial-apis/us-stock-market-tick-data-api) get\_historical\_market\_cap Retrieve historical market capitalization values for a company. [API Documentation](https://eodhd.com/financial-apis/historical-market-capitalization-api) get\_historical\_dividends Retrieve historical dividend payment data for a company. [API Documentation](https://eodhd.com/financial-apis/api-splits-dividends) get\_historical\_splits Retrieve historical stock split data for a company. [API Documentation](https://eodhd.com/financial-apis/api-splits-dividends) get\_asx\_corporate\_actions Structured corporate action data for ASX (Australian Securities Exchange) listed securities: dividends, splits, bonus issues, and rights issues. [API Documentation](https://eodhd.com/financial-apis/api-splits-dividends) get\_company\_news Get recent or historical news articles related to a company/ticker. [API Documentation](https://eodhd.com/financial-apis/stock-market-financial-news-api) get\_sentiment\_data Returns sentiment analysis data (positive/negative/neutral) on news or social content. [API Documentation](https://eodhd.com/financial-apis/stock-market-financial-news-api) get\_news\_word\_weights Extract weighted keyword data from financial news. [API Documentation](https://eodhd.com/financial-apis/stock-market-financial-news-api) get\_exchanges\_list Retrieve a full list of supported stock exchanges. [API Documentation](https://eodhd.com/financial-apis/exchanges-api-list-of-tickers-and-trading-hours) get\_exchange\_tickers Get all tickers listed on a specific exchange. [API Documentation](https://eodhd.com/financial-apis/covered-tickers-eodhd) get\_exchange\_details Fetch detailed metadata about a particular exchange. [API Documentation](https://eodhd.com/financial-apis/exchanges-api-trading-hours-and-stock-market-holidays) get\_macro\_indicator Access macroeconomic indicators (GDP, inflation, etc.). [API Documentation](https://eodhd.com/financial-apis/macroeconomics-data-and-macro-indicators-api) get\_historical\_commodity\_prices Historical price data for commodity series (energy, metals, agriculturals, and commodity indices), sourced from FRED. [API Documentation](https://eodhd.com/financial-apis/commodities-api) get\_economic\_events Get global economic events calendar with forecasts and actuals. [API Documentation](https://eodhd.com/financial-apis/economic-events-data-api) get\_symbol\_change\_history Retrieve history of symbol/ticker changes (e.g., renames, delistings). [API Documentation](https://eodhd.com/financial-apis/exchanges-api-trading-hours-and-stock-market-holidays) get\_stocks\_from\_search Search stocks and instruments by name, ticker, or ISIN. [API Documentation](https://eodhd.com/financial-apis/search-api-for-stocks-etfs-mutual-funds) get\_user\_details Retrieve account information and API usage details. [API Documentation](https://eodhd.com/financial-apis/user-api) get\_insider\_transactions Access insider transaction reports for U.S. public companies. [API Documentation](https://eodhd.com/financial-apis/insider-transactions-api) get\_insider\_transactions\_form4 Richer SEC Form 4 insider-trading filings for U.S.-listed issuers, sourced directly from SEC EDGAR. Returns non-derivative and derivative transactions with footnotes linked back to each transaction and field. [API Documentation](https://eodhd.com/financial-apis/insider-transactions-api) capture\_realtime\_ws Connect to WebSocket to capture real-time data streams (US trades, US quotes, forex, crypto). [API Documentation](https://eodhd.com/financial-apis/new-real-time-data-api-websockets) stock\_screener Use stock screener filters to retrieve matching instruments. [API Documentation](https://eodhd.com/financial-apis/stock-market-screener-api) get\_upcoming\_earnings List upcoming earnings reports with dates and expectations. [API Documentation](https://eodhd.com/financial-apis/calendar-upcoming-earnings-ipos-and-splits) get\_earnings\_trends Retrieve historical and forecasted earnings trends for a company. [API Documentation](https://eodhd.com/financial-apis/calendar-upcoming-earnings-ipos-and-splits) get\_upcoming\_ipos Get calendar of upcoming IPOs with details. [API Documentation](https://eodhd.com/financial-apis/calendar-upcoming-earnings-ipos-and-splits) get\_upcoming\_splits Access information on upcoming stock splits. [API Documentation](https://eodhd.com/financial-apis/calendar-upcoming-earnings-ipos-and-splits) get\_upcoming\_dividends Access upcoming ex-dividend dates with flexible filters by symbol or date. [API Documentation](https://eodhd.com/financial-apis/calendar-upcoming-earnings-ipos-and-splits) get\_us\_live\_extended\_quotes New “Live v2” endpoint — provides extended live quotes for U.S. instruments. [API Documentation](https://eodhd.com/financial-apis/live-v2-for-us-stocks-extended-quotes-2025) get\_technical\_indicators Analytics tool — SMA, EMA, RSI, MACD, etc. [API Documentation](https://eodhd.com/financial-apis/technical-indicators-api) get\_support\_resistance\_levels Compute support and resistance levels using 5 pivot point methods: Classic, Fibonacci, Woodie, Camarilla, DeMark. Calculated server-side from historical data. [API Documentation](https://eodhd.com/financial-apis/technical-indicators-api) get\_cboe\_indices\_list Retrieve a list of available CBOE indices with latest values and metadata. [API Documentation](https://eodhd.com/financial-apis/cboe-europe-indices-api-beta) get\_cboe\_index\_data Get detailed CBOE index data, including index levels and full component breakdown. [API Documentation](https://eodhd.com/financial-apis/cboe-europe-indices-api-beta) get\_stock\_market\_logos Get company logo in PNG format (200×200, transparency). 40,000+ logos across 60+ exchanges. [API Documentation](https://eodhd.com/marketplace/unicornbay/logo/docs) get\_stock\_market\_logos\_svg Get company logo in SVG vector format. Available for US and Toronto exchanges. [API Documentation](https://eodhd.com/marketplace/unicornbay/logo/docs) get\_ust\_bill\_rates US Treasury bill rates — daily rates for 4WK through 52WK tenors (bank discount rate + coupon-equivalent yield). [API Documentation](https://eodhd.com/financial-apis/us-treasury-ust-interest-rates-api-beta) get\_ust\_yield\_rates US Treasury par yield curve — rates for maturities from 1 month to 30 years. [API Documentation](https://eodhd.com/financial-apis/us-treasury-ust-interest-rates-api-beta) get\_ust\_real\_yield\_rates US Treasury real yield rates (TIPS — Treasury Inflation-Protected Securities). [API Documentation](https://eodhd.com/financial-apis/us-treasury-ust-interest-rates-api-beta) get\_ust\_long\_term\_rates US Treasury long-term composite rates. [API Documentation](https://eodhd.com/financial-apis/us-treasury-ust-interest-rates-api-beta) Marketplace products ([by EODHD](https://eodhd.com/marketplace?providers=unicornbay)): Tool Description Documentation get\_us\_options\_contracts Retrieve available U.S. options contracts for an underlying asset. [API Documentation](https://eodhd.com/marketplace/unicornbay/options/docs) get\_us\_options\_eod Access end-of-day data for U.S. options contracts. [API Documentation](https://eodhd.com/marketplace/unicornbay/options/docs) get\_us\_options\_underlyings Get list of underlying assets available in the U.S. options dataset. [API Documentation](https://eodhd.com/marketplace/unicornbay/options/docs) mp\_indices\_list Retrieve a list of supported indices in the marketplace dataset. [API Documentation](https://eodhd.com/marketplace/unicornbay/spglobal/docs) mp\_index\_components Get components/constituents of a selected index. [API Documentation](https://eodhd.com/marketplace/unicornbay/spglobal/docs) get\_mp\_tick\_data Access marketplace tick-by-tick data. [API Documentation](https://eodhd.com/marketplace/unicornbay/options/docs) get\_mp\_tradinghours\_list\_markets List all available markets from the TradingHours API. [API Documentation](https://eodhd.com/marketplace/tradinghours/markets-equities/docs) get\_mp\_tradinghours\_lookup\_markets Search for markets by name or country. [API Documentation](https://eodhd.com/marketplace/tradinghours/markets-equities/docs) get\_mp\_tradinghours\_market\_details Get full market metadata — timezone, MIC codes, regular/pre/post-market sessions, holiday calendar. [API Documentation](https://eodhd.com/marketplace/tradinghours/markets-equities/docs) get\_mp\_tradinghours\_market\_status Get real-time open/closed status for a market. [API Documentation](https://eodhd.com/marketplace/tradinghours/markets-equities/docs) Marketplace products (third-party providers): [PRAAMS products](https://eodhd.com/marketplace?providers=praams): 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](https://eodhd.com/marketplace/praams/analyse) get\_mp\_praams\_risk\_scoring\_by\_isin Retrieve PRAAMS equity risk and return scoring for a company using its ISIN. [API Documentation](https://eodhd.com/marketplace/praams/analyse) get\_mp\_praams\_bond\_analyze\_by\_isin Access detailed PRAAMS bond risk and return analysis for a specific bond identified by ISIN. [API Documentation](https://eodhd.com/marketplace/praams/analyse) 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](https://eodhd.com/marketplace/praams/bank/docs) 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](https://eodhd.com/marketplace/praams/bank/docs) 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](https://eodhd.com/marketplace/praams/bank/docs) get\_mp\_praams\_bank\_balance\_sheet\_by\_isin Access detailed bank balance sheet data using an ISIN, including assets, liabilities, and equity. [API Documentation](https://eodhd.com/marketplace/praams/bank/docs) get\_mp\_praams\_report\_equity\_by\_ticker Generate comprehensive multi-factor PDF investment report for an equity by ticker. Covers valuation, performance, profitability, growth, dividends, and 6 risk dimensions. 120,000+ global equities. [API Documentation](https://eodhd.com/marketplace/praams/reports) get\_mp\_praams\_report\_equity\_by\_isin Generate comprehensive multi-factor PDF investment report for an equity by ISIN. [API Documentation](https://eodhd.com/marketplace/praams/reports) get\_mp\_praams\_report\_bond\_by\_isin Generate comprehensive multi-factor PDF investment report for a bond by ISIN. [API Documentation](https://eodhd.com/marketplace/praams/reports) get\_mp\_praams\_smart\_screener\_equity Smart investment screener for equities — filter and rank stocks using multi-factor risk/return criteria. [API Documentation](https://eodhd.com/marketplace/praams/explore) get\_mp\_praams\_smart\_screener\_bond Smart investment screener for bonds — filter and rank bonds using multi-factor risk/return criteria. [API Documentation](https://eodhd.com/marketplace/praams/explore) [ESG by Investverte](https://eodhd.com/marketplace/investverte/esg_data): Tool Description Documentation get\_mp\_investverte\_esg\_list\_companies Retrieve a list of companies covered by the Investverte ESG dataset. [API Documentation](https://eodhd.com/marketplace/investverte/esg_data) get\_mp\_investverte\_esg\_list\_countries Retrieve a list of countries covered by the Investverte ESG dataset. [API Documentation](https://eodhd.com/marketplace/investverte/esg_data) get\_mp\_investverte\_esg\_list\_sectors Retrieve a list of sectors available in the Investverte ESG dataset. [API Documentation](https://eodhd.com/marketplace/investverte/esg_data) get\_mp\_investverte\_esg\_view\_company Access ESG ratings and scores for a specific company across environmental, social, and governance dimensions. [API Documentation](https://eodhd.com/marketplace/investverte/esg_data) get\_mp\_investverte\_esg\_view\_country Access aggregated ESG ratings and scores for a specific country. [API Documentation](https://eodhd.com/marketplace/investverte/esg_data) get\_mp\_investverte\_esg\_view\_sector View ESG data aggregated by sector and industry over time. [API Documentation](https://eodhd.com/marketplace/investverte/esg_data) More endpoints and datasets to be added soon. Feel free to contact our support if you are expecting something specific.