Claim your free API key
Register at eodhd.com/register and grab your key. Free plan is enough to start.
75
Read‑only tools
15
Categories
150K+
Tickers
70+
Exchanges
30+
Years history
100+
Embedded docs
What is this
A Model Context Protocol server giving AI clients structured access to financial data
Connect Claude, ChatGPT, Cursor, Windsurf, or any MCP‑compatible client to live EODHD financial data — prices, fundamentals, news, technicals, macro, US options, ESG, and more — through a single read‑only interface.
AI engineers
Quant researchers
Fintech product teams
Developers & agents
How it works
From free key to first AI query in under 5 minutes
Choose v1 or v2
v1 = API key auth. v2 = OAuth 2.1. Use v2 for Claude Desktop; v1 for ChatGPT and Claude Code.
Connect your MCP client
Paste the URL into Claude Desktop, ChatGPT MCP Connector, Cursor, Windsurf — or install the .mcpb bundle.
Ask your first question
Try analyze_stock("AAPL.US") or compare_stocks. The agent has 75 tools and 100+ docs at hand.
Why EODHD MCP
Built for serious AI workflows, not demos
75 tools across 15 categories
Prices, intraday, US tick, fundamentals, news, sentiment, technicals, US options, US Treasury rates, ESG, macro, calendars, and marketplace bundles.
API key auth or OAuth 2.1
v1 — API key for ChatGPT, Claude Code, and custom agents. v2 — built‑in OAuth 2.1 server with PKCE, dynamic client registration, and discovery.
100+ docs built into the server
72 endpoint pages, 7 plan guides, 28 reference pages — exposed as MCP resources. Your agent reads them locally, with zero API calls.
Smart ticker lookup + pivot analytics
Resolve "Apple" → AAPL.US or ISIN → SYMBOL.EXCHANGE. Compute support & resistance with five pivot methods server‑side — no extra API call.
Works with your stack
One server, every major MCP client
Claude Desktop
Claude Code
ChatGPT MCP Connectors
Cursor
Windsurf
MCP Inspector
Custom MCP clients
v1 — API key For ChatGPT & CLI agents
Best for ChatGPT MCP Connectors, Claude Code CLI, custom agents, and any programmatic access. Auth via URL parameter, header, or env var.
https://mcpv2.eodhd.dev/v1/mcp?apikey=YOUR_API_KEYView v1 on GitHub →
v2 — OAuth 2.1 For Claude Desktop
Built‑in OAuth 2.1 server with PKCE, dynamic client registration (RFC 7591), token introspection (RFC 7662), and discovery (RFC 8414/9728). No API key in the URL.
https://mcpv2.eodhd.dev/v2/mcpView v2 on GitHub →
Technical proof, not marketing claims
Production‑grade engineering you can audit
No MCP testimonials yet — instead, here is what is verifiably in the repo.
197 automated tests
Pytest suite across Python 3.10, 3.11, 3.12, 3.13.
Security toolchain
Ruff, MyPy, Bandit, Semgrep, pip-audit on every build.
Three transports
streamable-http (default), SSE, stdio.
Prompt‑injection mitigation
Invisible Unicode characters stripped from all inputs.
30+ date formats
ISO, US, EU, named months, Unix timestamps — all coerced to YYYY-MM-DD.
.mcpb bundle for Claude Desktop
One‑click install from GitHub Releases.
Open‑source on GitHub
v1 and v2 repos under the EodHistoricalData org. MIT‑style release artefacts.
Optional retry & rate limiter
Exponential backoff, per‑token buckets, thread-safe asyncio.
3 prompt templates
analyze_stock, compare_stocks, market_overview — multi‑tool workflows.
Get started
Install the MCP server in your AI client
Pick the path that matches your client. Full step‑by‑step setup — including .mcpb bundle, OAuth flow, and developer config — lives in the MCP docs.
v2 — OAuth 2.1
Settings → Extensions → Add. Paste the URL and approve the OAuth consent. No API key in the URL.
https://mcpv2.eodhd.dev/v2/mcp
v1 — API key
Add the MCP connector, paste the URL with your API key. Same URL works for every v1‑compatible client.
https://mcpv2.eodhd.dev/v1/mcp?apikey=YOUR_API_KEY
Source checkout
git clone the repo, run python server.py --stdio,
point your client at the binary. Full stdio/SSE/HTTP modes supported.
git clone github.com/EodHistoricalData/EODHD-MCP-Server
Beyond MCP
Part of the EODHD AI‑Ready toolkit
MCP server is one of four ways to plug EODHD financial data into your AI stack. Mix them, or use just the one that fits your client.
EODHD MCP Server
You are here75 tools · OAuth 2.1 + API key · 100+ embedded docs. Built for Claude Desktop, ChatGPT, Cursor, Windsurf, and custom MCP clients.
View on GitHub →EODHD Agent Skills
Skills72 API endpoints & 28 reference guides packaged as a Claude Skills Library. Stdlib-only Python — works with Claude Code, Codex‑style agents, and generic AI workflows.
View on GitHub →EODHD OpenAPI Spec
OpenAPIOfficial OpenAPI 3.1 spec covering 74 endpoints. Machine‑readable, Swagger‑compatible, ready for AI function calling and SDK code generation.
View on GitHub →EODHD ChatGPT Assistant
AssistantCustom GPT trained on EODHD documentation. Delivers financial data directly in chat and writes code for fetching, processing, and analyzing market data.
Try the Assistant →Start free. Upgrade only when you need more data.
MCP tool calls consume the same quota as regular EODHD API requests. Plan unlocks the data; the MCP server is included.
If a tool needs an endpoint outside your plan, the MCP server returns the upstream permission error verbatim — your agent shows the exact reason and the plan required.
Frequently asked questions
Install the .mcpb bundle in Claude Desktop, or connect any MCP client over streamable-http, SSE, or stdio. v1 uses an API key in the URL; v2 uses OAuth 2.1.
Yes. Supported clients include Claude Desktop, Claude Code, ChatGPT (MCP Connectors), Cursor, Windsurf, MCP Inspector, and any custom MCP client.
v1 uses API-key authentication via URL parameter. v2 adds a built‑in OAuth 2.1 authorization server with PKCE, dynamic client registration, token introspection, and discovery.
Yes. EODHD offers a free plan. Register at eodhd.com/register and copy the API key into the v1 URL — or use OAuth 2.1 with v2.
75 tools across 15 categories: prices and intraday, fundamentals, news and sentiment, technical indicators, US options, US Treasury rates, ESG, macro indicators, calendars, indices, stock logos, and marketplace bundles.
Both. v1 accepts the API key in the URL, Authorization header, or X-API-Key header. v2 includes a built‑in OAuth 2.1 server with PKCE and dynamic client registration.
Broader tool surface (75 tools across 15 categories), built‑in OAuth 2.1, 100+ embedded documentation resources, smart ticker resolution from company name or ISIN, and server‑side support/resistance computation.
The MCP tool returns the upstream EODHD permission error verbatim, so your AI agent can surface the exact reason and the plan required.
Bring real financial data into your AI workflow today
Free plan. No credit card. 75 tools the moment you connect.
