eodhistoricaldata/eodhd-mcp-server

Developer tools

Эта страница переведена автоматически. Технические детали смотрите в оригинале. Открыть оригинал

24 stars 4 forks Качество 82 Тренд 25MIT

Repository Install

EODHD MCP Server for AI assistants

Обзор

Model Context Protocol (MCP) server for EOD Historical Data APIs. The current server exposes across three transports — 85 are read-only; the three Praams report tools trigger provider-side report generation and email delivery, so they are annotated readOnlyHint=False: - streamable-http via server.py on /mcp by default - sse - stdio It also ships bundled MCP prompts and documentation resources. - End-of-day, intraday, and US tick data - Live quotes and US Live v2 extended quotes - Fundamentals, earnings, and financial statements - Company news, sentiment, and news word weights - Screeners, search, and technical indicators - Corporate actions: IPOs, splits, dividends, symbol changes - Macro indicators, economic events, exchanges, and listings - CBOE index tools - Treasury bill, yield, real yield, and long-term rates - Credit & sovereign risk: risk premiums, credit ratings, CDS/default spreads, corporate CMDI/HQM yields, CDS-market aggregates - Sanctions / OFAC: entities, vessels,...

README

Показан фрагмент оригинального README. Открыть оригинал.

EODHD MCP Server

Model Context Protocol (MCP) server for EOD Historical Data APIs.

The current server exposes 88 MCP tools across three transports — 85 are read-only; the three Praams report tools trigger provider-side report generation and email delivery, so they are annotated readOnlyHint=False:

streamable-http via server.py on /mcp by default
sse
stdio

It also ships bundled MCP prompts and documentation resources.

Coverage

Core datasets

End-of-day, intraday, and US tick data
Live quotes and US Live v2 extended quotes
Fundamentals, earnings, and financial statements
Company news, sentiment, and news word weights
Screeners, search, and technical indicators
Corporate actions: IPOs, splits, dividends, symbol changes
Macro indicators, economic events, exchanges, and listings
CBOE index tools
Treasury bill, yield, real yield, and long-term rates
Credit & sovereign risk: risk premiums, credit ratings, CDS/default spreads, corporate CMDI/HQM yields, CDS-market aggregates
Sanctions / OFAC: entities, vessels, programs, sources
Interest rates: reference rates (SOFR etc.), central-bank policy rates, funding-stress spreads

Marketplace and partner datasets

US options: contracts, EOD, and underlyings
Praams: risk scoring, bonds, bank statements, reports, screeners
Investverte ESG: companies, countries, and sectors
TradingHours market lookup, market details, and status

Current Behavior

All tools are read-only except the three Praams report tools; every tool registers through app/tools/__init__.py.
All HTTP requests go through the shared async client in app/api_client.py.
Upstream API errors are preserved as MCP ToolErrors with status code and upstream details where available.
API tokens are injected into EODHD requests as api_token=... query parameters.
Optional retry support is controlled by EODHD_RETRY_ENABLED or per-call settings in code.

Requirements

Python 3.10+
A valid EODHD API key
An MCP-compatible client such as Claude Desktop, Claude Code, ChatGPT MCP/Connectors, or MCP Inspector

Installation

git clone https://github.com/EodHistoricalData/EODHD-MCP-Server.git
cd EODHD-MCP-Server
pip install -r requirements.txt

For development tooling:

pip install -e ".[dev]"

Create a .env file at the repository root:

EODHD_API_KEY=YOUR_EODHD_API_KEY
MCP_HOST=127.0.0.1
MCP_PORT=8000
MCP_PATH=/mcp
LOG_LEVEL=INFO
# Optional:
EODHD_RETRY_ENABLED=false
# Deployment label added to the outbound User-Agent (e.g. v1 / v2):
EODHD_MCP_EDITION=

Открыть полный README на GitHub

Установка

This server does not publish a one-line install command.

Open the repository installation guide Новичок в MCP? Начните с руководства на mcpskill.org →

Конфигурация

{
  "mcpServers": {
    "eodhd-mcp": {
      "command": "python3",
      "args": [
        "/absolute/path/to/EODHD-MCP-Server/server.py",
        "--stdio"
      ],
      "env": {
        "EODHD_API_KEY": "YOUR_EODHD_API_KEY"
      }
    }
  }
}