EOD履歴データAPI用のモデルコンテキストプロトコル(MCP)サーバー。

現在のサーバーは、88 MCP ツール を 3 つのトランスポート全体で公開しています。85 は読み取り専用です。3 プラムスレポートツールは、プロバイダ側のレポート生成とメール配信をトリガーします。 [readOnlyHint=False]:

• [streamable-http] をデフォルトで [server.py] から [[[/mcp]]] に [[[streamable-http]]]]] で [[[server.py]]]]]] で [[[[[[[/mcp]]]]]])]
• [sse
• [stdio

また、MCP のプロンプトとドキュメントリソースをバンドルして出荷します。

カバレッジ

コアデータセット

• 終日、イントラデー、米国ティックデータ
• ライブ引用符と米国ライブv2拡張引用符
• 基本・業績・財務諸表
• 会社のニュース、感情、ニュースワードの重量
• 選別機、検索、テクニカル指標
• 企業行動:IPO、株式分割、配当、銘柄変更
• マクロ指標、経済イベント、取引所、上場
• CBOEインデックスツール
• Treasury の手形、収穫、実質の収穫および長期率
• クレジット& sovereignリスク:リスクプレミアム、クレジット評価、CDS /デフォルトスプレッド、企業CMDI / HQMの収量、CDS市場集計
• Sanctions / OFAC: 組織、船舶、プログラム、ソース
• 金利:参考価格(SOFR等)、中央銀行の政策料金、資金調達ストレススプレッド

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=