EODHD Guard

Name: EODHD Guard
Author: techfreakworm

von techfreakwormVersion 0.2.0i★ –iLäuft auf deinem Computer

Name in der Registryio.github.techfreakworm/eodhd-guard-mcp

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

EODHD market data that catches silent failures: frozen codes, NA quotes, empty answers.

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Sonstiges
Das musst du eintragen: EODHD_API_KEY

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: EODHD_API_KEY, EODHD_GUARD_DAILY_BUDGET

Als geheim markierte Werte sind Schlüssel zu deinem Konto. Gib sie nie weiter und füge sie nie in einen Chat ein.

Du brauchst

PyPIuv für Python installiert (für den Befehl uvx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "eodhd-guard": {
      "command": "uvx",
      "args": [
        "eodhd-guard-mcp"
      ],
      "env": {
        "EODHD_API_KEY": "your-value",
        "EODHD_GUARD_DAILY_BUDGET": "your-value"
      }
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add eodhd-guard --env EODHD_API_KEY=your-value --env EODHD_GUARD_DAILY_BUDGET=your-value -- uvx eodhd-guard-mcp

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "eodhd-guard": {
      "command": "uvx",
      "args": [
        "eodhd-guard-mcp"
      ],
      "env": {
        "EODHD_API_KEY": "your-value",
        "EODHD_GUARD_DAILY_BUDGET": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "eodhd-guard": {
      "type": "stdio",
      "command": "uvx",
      "args": [
        "eodhd-guard-mcp"
      ],
      "env": {
        "EODHD_API_KEY": "your-value",
        "EODHD_GUARD_DAILY_BUDGET": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

EODHD_API_KEY geheim erforderlich env
Your EODHD API key. You need your own EODHD subscription.
EODHD_GUARD_DAILY_BUDGET env
Most EODHD API calls this server may spend per GMT day; 0 means no limit.

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 6. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto techfreakworm bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

Im Vergleich mit anderen in Sonstigesi

Mehr Sterne als 0 % der anderen 32464 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 92 % der anderen 32464 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 32464 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist EODHD Guard sicher?

Er hat 1 von 1 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Das musst du eintragen: EODHD_API_KEY

Läuft er auf meinem Computer oder in der Cloud?

Er läuft auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.2.0) kam vor 3 Tagen in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Python (uv) auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Spec Driven Development, Remote Desktop Commander, yontu

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

So liest du eine Karte:★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

Spec Driven Development

von formulahendry

MCP Server that facilitates spec-driven development workflows, not just Vibe Coding.

Läuft auf deinem Computer★ 440MITAktualisiert vor 14 Monaten

Installieren

Remote Desktop Commander

von desktop-commander

Remote Desktop Commander: use files, terminal and processes on your own computers from any AI app.

Läuft in der Cloud★ 211Aktualisiert gestern

Installieren

yontu

von senrecep

Türkçe yazı denetimi: TDK kuralları, yapay zekâ izleri, metin türüne göre üslup.

Läuft auf deinem ComputerAktualisiert heute

Installieren

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

eodhd-guard-mcp

A guard-first MCP server for the EODHD market-data API: it catches silent failures, says what each price is, and counts what every call costs.

Status: alpha (0.2.x). Tool names, parameters and output fields can still change before 1.0.

Unofficial. This project is not affiliated with or endorsed by EODHD or Unicorn Data Services. You need your own EODHD subscription, and EODHD's data licence applies to everything you fetch. See the data licence notice.

Why

EODHD is a broad, inexpensive market-data API. An evaluation in October 2026 (about 930 calls) found its data sound for the US, London and Swiss markets, and good as a cross-check for India. It also found failures that an AI assistant cannot see, because the API reports them as success:

Frozen codes. A delisted or renamed code keeps answering HTTP 200 with frozen data. Roche's Swiss line changed from ROG.SW to ROP.SW in March 2026, and the old code kept answering.
Empty and placeholder answers. A real-time quote for an unknown code is HTTP 200 with every field set to "NA". Tokyo and the UAE have no prices and answer with [] or a bare 404.
Ignored parameters. A bad from date is ignored and the whole history comes back. An unknown period falls back to daily. A symbol without an exchange suffix silently means the US.
Prices that are not what they look like. close is not adjusted for splits or dividends, yet it is back-adjusted for some spin-offs and demergers. adjusted_close is the column to use for returns.
Lateness. Quotes are 15 to 20 minutes delayed. Intraday bars for the current session are not available. End-of-day bars appear anywhere from 10 minutes (US) to 4.5 hours (India) after the close.
Cost. Every endpoint has a price in API calls (end-of-day 1, intraday 5, fundamentals 10, news 5 for each ticker), so an unattended agent can spend a day's allowance in minutes.
Scores that look like measurements. News sentiment is an automated text score. In checks, a story about steep declines scored strongly positive, and polarity was close to +1 or -1 for most of the articles.

This server has 17 tools, and every one has guards. It validates arguments before sending anything, turns empty and placeholder answers into errors or explicit warnings, says whether each price is raw or adjusted and how old it is, states the cost of every response, counts every call in a local ledger, and stops at a daily budget. Each caveat is explained in docs/caveats.md.

Requirements

Python 3.10 or later.
Your own EODHD subscription and API key. This project does not include or resell data.
An MCP client that can start a stdio server or connect to a streamable-HTTP one, such as Claude Code or Claude Desktop.

EODHD plan for each tool

EODHD refuses requests that your plan does not include (HTTP 403). The server reports that as PLAN_ERROR. For intraday bars, fundamentals, the three calendars and dividend and split history, the message names the plans that include the endpoint. For the other endpoints it says that a higher plan may include it.

Tools	EODHD plan needed
`get_eod_prices`, `get_dividends`, `get_splits`, `search_symbols`, `list_exchanges`, `list_exchange_symbols`, `check_symbol`	"EOD Historical Data" or higher
`get_intraday_prices`	"EOD+Intraday" or "All-in-One"
`get_fundamentals`, `get_earnings_calendar`, `get_dividend_calendar`, `get_split_calendar`	"Fundamentals Data Feed" or "All-in-One"
`get_quote`	Live (delayed) prices: check EODHD's plan table for your plan
`get_news`, `get_sentiment`, `get_economic_events`	The server does not know which plans include them: check EODHD's plan table. A 403 comes back as `PLAN_ERROR`
`get_usage`	Any plan; the account endpoint is free

check_symbol also needs the plan that covers get_quote when you pass include_quote. The free EODHD plan allows 20 calls a day and one year of end-of-day history; if you use it, set EODHD_GUARD_DAILY_BUDGET=20. EODHD changes its plans from time to time, so check eodhd.com for the current table.

Data licence notice

EODHD's data is licensed for personal, non-commercial use, and EODHD's terms do not allow redistributing it. That was the position at the time of the October 2026 evaluation; read the current terms on eodhd.com before you use output for anything beyond your own analysis.

This project ships no EODHD data. Its tests use synthetic fixtures.
You are responsible for complying with EODHD's terms for everything you fetch, store and share.
The local cache holds EODHD responses. Do not share it, sync it to a shared folder or commit it. See Cache and state files.
Nothing here is legal advice.

Unofficial

eodhd-guard-mcp is an independent project. It is not affiliated with, endorsed by or supported by EODHD or Unicorn Data Services. "EODHD" and "EOD Historical Data" are names of their respective owners, used here only to say which API the server talks to.

Install

The package is on PyPI. Run it without installing, with uv:

uvx eodhd-guard-mcp --version

Or install it, preferably into an isolated environment:

pipx install eodhd-guard-mcp

or, inside a virtual environment

pip install eodhd-guard-mcp

It is also listed in the official MCP registry as io.github.techfreakworm/eodhd-guard-mcp.

The latest unreleased code installs from GitHub:

pip install git+https://github.com/techfreakworm/eodhd-guard-mcp

Or from a clone:

git clone https://github.com/techfreakworm/eodhd-guard-mcp.git

cd eodhd-guard-mcp pip install -e .

Check the install and your configuration:

eodhd-guard-mcp --version

EODHD_API_KEY_FILE="$HOME/.config/eodhd-guard-mcp/api_key" eodhd-guard-mcp --check

--check prints the configuration to stderr, with the key shown only as set or not set, together with the state directory and the budget. Add --online to make one free call to EODHD's account endpoint and print only its usage counters. The exit code is non-zero when something is wrong. See Command line.

Configure

The server needs your API key. Pass it as EODHD_API_KEY_FILE, the path of a file that holds only the key, or as EODHD_API_KEY. Prefer the file. An inline key lands in your shell history and in your MCP client's configuration, in plain text.

To create the key file without putting the key in your shell history:

mkdir -p ~/.config/eodhd-guard-mcp

(umask 077; touch ~/.config/eodhd-guard-mcp/api_key) ${EDITOR:-nano} ~/.config/eodhd-guard-mcp/api_key

Claude Code

claude mcp add eodhd-guard --env EODHD_API_KEY_FILE="$HOME/.config/eodhd-guard-mcp/api_key" -- eodhd-guard-mcp

With the key inline, which is easier but leaves it in your shell history and in Claude Code's configuration file:

claude mcp add eodhd-guard --env EODHD_API_KEY=... -- eodhd-guard-mcp

examples/claude_code.md has the full walk-through, including uvx, user scope and a lower budget.

Claude Desktop

Add the server to claude_desktop_config.json and restart Claude Desktop. The file is at ~/Library/Application Support/Claude/ on macOS and %APPDATA%\Claude\ on Windows.

"mcpServers": { "eodhd-guard": { "command": "eodhd-guard-mcp", "args": [], "env": { "EODHD_API_KEY_FILE": "/Users/you/.config/eodhd-guard-mcp/api_key" } } } }

Claude Desktop does not always see the PATH of your shell. If it cannot find the command, put the absolute path from which eodhd-guard-mcp (macOS and Linux) or where eodhd-guard-mcp (Windows) in command. On Windows, write backslashes twice inside the JSON. Or let uvx fetch and run it:

"mcpServers": { "eodhd-guard": { "command": "uvx", "args": ["eodhd-guard-mcp"], "env": { "EODHD_API_KEY_FILE": "/Users/you/.config/eodhd-guard-mcp/api_key" } } } }

The same file is in examples/claude_desktop_config.json.

Any other stdio client

Start eodhd-guard-mcp with no arguments and set EODHD_API_KEY_FILE in its environment. python -m eodhd_guard_mcp does the same. Logs go to stderr, because stdout carries the protocol.

Streamable HTTP

eodhd-guard-mcp --transport streamable-http --host 127.0.0.1 --port 8000

The server answers at http://127.0.0.1:8000/mcp. This transport has no authentication. Anyone who can reach the port can spend your EODHD calls, so keep the host on 127.0.0.1. The server prints a warning to stderr to remind you.

Command line

Option	Meaning
`--transport stdio\	streamable-http`	How to serve MCP. The default is stdio.
`--host`, `--port`	For streamable HTTP. Defaults: `127.0.0.1` and `8000`.
`--check`	Print the configuration, the state directory and the budget, and exit.
`--check --online`	Also make the free account call and print its counters.
`--version`	Print the version.

--check writes a JSON report to stderr, because stdout carries the protocol on stdio. It holds the version, api_key (set or NOT SET), the base URL, the state directory, the daily budget (a number, or unlimited), the cache setting, the stale-session threshold and the coverage switch. With --online it adds account (EODHD's counters) or account_error. The exit code is 0 when all is well, 1 when no key is set or the online call fails, and 2 when a setting is invalid.

Environment variables

Variable	Meaning	Default
`EODHD_API_KEY`	API key	none
`EODHD_API_KEY_FILE`	File holding the key (used when `EODHD_API_KEY` is unset)	none
`EODHD_GUARD_DAILY_BUDGET`	Cost units per GMT day, 0 = unlimited	`1000`
`EODHD_GUARD_STATE_DIR`	Ledger and cache folder	`$XDG_STATE_HOME/eodhd-guard-mcp`, else `~/.local/state/eodhd-guard-mcp`; `%LOCALAPPDATA%\eodhd-guard-mcp` on Windows
`EODHD_GUARD_CACHE`	`on` or `off` (also 1/0, true/false, yes/no)	`on`
`EODHD_GUARD_STALE_SESSIONS`	Sessions behind before data counts as stale (`STALE_DATA`, `STALE_QUOTE`, `POSSIBLY_INACTIVE` and the `check_symbol` verdict); an integer, 1 or more	`3`
`EODHD_GUARD_TIMEOUT`	Request timeout in seconds, above 0	`30`
`EODHD_GUARD_MAX_RETRIES`	Retries for 429, 5xx and network errors; an integer, 0 to 5	`2`
`EODHD_GUARD_ALLOW_UNCOVERED`	Skip the coverage pre-check for Tokyo and the UAE	`off`
`EODHD_GUARD_BASE_URL`	API base, for tests and proxies; see below	`https://eodhd.com/api`
`EODHD_GUARD_LOG_LEVEL`	`DEBUG`, `INFO`, `WARNING`, `ERROR` or `CRITICAL`; logs go to stderr	`WARNING`

An invalid value stops the server at start-up with a CONFIG_ERROR message that names the variable and the values it accepts. A key file that cannot be read, or is empty, does the same. A key that is simply not set does not stop the server: listing tools works, and each tool c

Nur der Anfang wird gezeigt; den Rest findest du im Repo

EODHD Guard

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

Im Vergleich mit anderen in Sonstigesi

Häufige Fragen

Alternativen

Spec Driven Development

Remote Desktop Commander

yontu

README vom Entwickler

eodhd-guard-mcp

Why

Requirements

EODHD plan for each tool

Data licence notice

Unofficial

Install

or, inside a virtual environment

Configure

Claude Code

Claude Desktop

Any other stdio client

Streamable HTTP

Command line

Environment variables