eodhd-api

EODHD Financial Data Plugin for Claude

Developer-first financial data for Claude — 150,000+ tickers across 70+ exchanges, powered by EODHD API and an OAuth-secured MCP Server.

⚠ Not financial advice. This plugin delivers AI-generated analysis on top of EODHD market data. Always verify figures against eodhd.com and the underlying issuer filings before making any investment, trading, or risk decision. Support: [email protected].

Highlights

• MCP Server v2 with OAuth 2.0 — 72 tools, 100+ embedded docs, smart ticker resolution
• 7 curated workflow skills — company briefs, earnings, market overview, screening, risk, macro, options
• Financial analyst agent — autonomous multi-source analysis
• 5 slash commands — /eodhd-api:eodhd-analyze, /eodhd-api:eodhd-compare, /eodhd-api:eodhd-market, /eodhd-api:eodhd-screen, /eodhd-api:eodhd-macro
• 64 endpoint docs + 28 general reference guides
• Stdlib-only Python client — zero dependencies, 30+ endpoints

Installation

Claude Code (Plugin System)

# Register the marketplace
/plugin marketplace add EodHistoricalData/eodhd-claude-skills

# Install the plugin
/plugin install eodhd-api@eodhd-claude-skills

Plugin commands are namespaced. After install, invoke commands with the eodhd-api: prefix — e.g. /eodhd-api:eodhd-analyze AAPL, not /eodhd-analyze. Type / to see them listed under the eodhd-api: group.

Claude Code (Community Marketplace)

If you have the Anthropic community marketplace added:

/plugin marketplace add anthropics/claude-plugins-community
/plugin install eodhd-api@claude-community

MCP Server (Direct)

The plugin includes .mcp.json for automatic MCP Server connection:

{
  "eodhd": {
    "type": "http",
    "url": "https://mcp.eodhd.com/v2/mcp"
  }
}

Manual Setup

git clone https://github.com/EodHistoricalData/eodhd-claude-skills.git
export EODHD_API_TOKEN="your_token_here"

Prerequisites

1. EODHD account + API token — sign up at eodhd.com. Free tier works for evaluation; production usage typically needs a paid plan (see Access Tiers below).
2. Python 3.8+ for the helper client (stdlib-only, no pip install needed)

Access Tiers

The plugin itself is MIT-licensed and free. Data access is gated by your EODHD subscription. The skills degrade gracefully — if an endpoint requires a tier you don't have, you'll get a clear 402 Payment Required (not a crash).

Tier	Price	What works in this plugin
Free (details)	$0/mo, 20 calls/day	US tickers, EOD prices (past year), 15-min delayed quotes, exchanges list, US Treasury rates. Good for testing the plugin.
EOD Historical Data — All World (details)	from $19.99/mo	Full 70+ exchanges, 30+ years of EOD prices, dividends, splits. Enables market-overview, basic stock-screener.
Fundamentals Data Feed (details)	from $59.99/mo	Adds fundamentals, financial statements, insiders, sentiment, ratios. Enables company-brief, earnings-monitor, portfolio-risk.
All-In-One (details)	from $99.99/mo	Everything above + intraday bars (1m/5m/1h), live quotes, technical indicators, screener, news, macro. Recommended for full plugin usage.
Marketplace add-ons (separate SKUs)	varies	Required for options-analyzer (US options chains), Investverte ESG, PRAAMS risk/bank/bond analytics, TradingHours.

Pricing on this page is indicative — see eodhd.com/pricing for current rates.

Repository Structure