모형 Context 의정서 (MCP) EOD Historical Data APIs를 위한 서버.

현재 서버는 ** 88 MCP 도구 ** 3 개의 운송 중 - 85은 읽기 전용; 세 Praams 보고서 도구 트리거 공급자 측 보고서 발생 및 이메일 배달, 그래서 그들은 주석 readOnlyHint=False]:

• streamable-http 를 통해 server.py] 에 /mcp] 기본
• [T4]]
• [T5]

또한 묶인 MCP 프롬프트 및 문서 리소스를 발송합니다.

적용

핵심 데이터셋

• End-of-day, intraday 및 미국 진드기 데이터
• 실시간 견적 및 미국 라이브 v2 확장 견적
• 금융, 수입 및 금융 진술
• 회사 뉴스, 감정 및 뉴스 단어 무게
• Screeners, 검색 및 기술 지표
• 기업 행동 : IPO, 분할, 배당, 기호 변경
• Macro 지표, 경제 이벤트, 교환 및 목록
• CBOE 인덱스 도구
• 재무 계산서, 수율, 실제 수율 및 장기적인 비율
• 신용 및 소위 위험 : 위험 프리미엄, 신용 등급, CDS / 기본 스프레드, 법인 CMDI / HQM 수율, CDS 시장 집계
• Sanctions / OFAC : entities, 선박, 프로그램, 소스
• 이자율: 참고요금 (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=