eodhd-claude-skills

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.

Disclaimer: This plugin may differ from actual EODHD API behavior due to documentation discrepancies or API evolution. Claude may interpret information incorrectly. For questions, email supportlevel1@eodhistoricaldata.com

Highlights

• MCP Server v2 with OAuth 2.0 — 75 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-analyze, /eodhd-compare, /eodhd-market, /eodhd-screen, /eodhd-macro
• 72 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

MCP Server (Direct)

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

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

Manual Setup

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

Prerequisites

1. EODHD API Token — get one at eodhd.com (free tier available)
2. Python 3.8+ for the helper client (stdlib-only, no pip install needed)

Repository Structure

eodhd-claude-skills/
├── .claude-plugin/
│   ├── marketplace.json            # Plugin manifest for Claude Code
│   └── plugin.json                 # Extended plugin metadata
├── .claude/
│   └── commands/                   # Slash commands
│       ├── eodhd-analyze.md        # /eodhd-analyze <ticker>
│       ├── eodhd-compare.md        # /eodhd-compare <ticker1> <ticker2>
│       ├── eodhd-market.md         # /eodhd-market
│       ├── eodhd-screen.md         # /eodhd-screen <criteria>
│       └── eodhd-macro.md          # /eodhd-macro
├── .mcp.json                       # MCP Server connector (OAuth)
├── agents/
│   └── financial-analyst.md        # Financial analyst agent definition
├── skills/
│   ├── eodhd-api/                  # Core skill — full API access
│   │   ├── SKILL.md
│   │   ├── references/
│   │   │   ├── general/            # 28 general guides
│   │   │   ├── endpoints/          # 72 endpoint docs
│   │   │   ├── subscriptions/      # 7 subscription plans
│   │   │   └── workflows.md
│   │   ├── scripts/
│   │   │   └── eodhd_client.py     # Python API client (stdlib-only)
│   │   └── templates/
│   │       └── analysis_report.md
│   ├── company-brief/              # Company snapshot workflow
│   ├── earnings-monitor/           # Earnings tracking workflow
│   ├── market-overview/            # Market summary workflow
│   ├── portfolio-risk/             # Risk analysis workflow
│   ├── stock-screener/             # Stock screening workflow
│   ├── macro-dashboard/            # Macro-economic dashboard
│   └── options-analyzer/           # Options analysis workflow
├── adapters/
│   ├── claude/eodhd-api.md
│   └── codex/eodhd-api.md
├── CLAUDE.md
├── LICENSE                         # MIT
└── README.md

Quick Start

1. Set your API token

export EODHD_API_TOKEN="your_token_here"

2. Use slash commands

/eodhd-analyze AAPL           # Full company analysis
/eodhd-compare AAPL MSFT      # Side-by-side comparison
/eodhd-market                  # Market overview
/eodhd-screen high dividend large cap   # Stock screening
/eodhd-macro                   # Macro dashboard

3. Use the Python client directly

python skills/eodhd-api/scripts/eodhd_client.py --endpoint eod --symbol AAPL.US --from-date 2025-01-01 --to-date 2025-03-31
python skills/eodhd-api/scripts/eodhd_client.py --endpoint fundamentals --symbol MSFT.US
python skills/eodhd-api/scripts/eodhd_client.py --endpoint screener --limit 20

4. Use in prompts

Use the eodhd-api plugin. Pull daily prices for AAPL.US from 2025-01-01 to 2025-03-31
and give me a trend analysis with key support/resistance levels.

Skills

Core Skill: eodhd-api

Full access to all 72 EODHD endpoints via Python client and curl. Handles any financial data request.

Workflow Skills