EODHD Guard

Name: EODHD Guard
Author: techfreakworm

by techfreakwormversion 0.2.0i★ –iRuns on your computer

Registry nameio.github.techfreakworm/eodhd-guard-mcp

Install

Overview

Description from the maker (original English)

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

PopNx MCP’s three pillars

These three are never merged into one score: opinions, measurements and popularity are different things.

User voiceiNo reviews yetReviews open together with accounts in a later step
Our basic checksi1 of 1 passedChecked from public information; code not scanned yet
UsageiNot measured yet★ –

What you can do with it

We have not written a plain-language summary for this one yet. Below are the facts we read from the registry.

Connection: Runs on your computer
Transport: stdio
Category: Other
You need to fill in: EODHD_API_KEY

Install

Pick the AI app you use, then copy the settings.

Before you install

Basic checks: 1 of 1 passed
Runs on your computer with your user’s permissions (files, network, apps).
You fill in yourself: EODHD_API_KEY, EODHD_GUARD_DAILY_BUDGET

Values marked secret are keys to your account. Never share them or paste them into a chat.

You need

PyPIPython’s uv installed (for the uvx command)

Which app do you use?

ClaudeClaude CodeCursorVS CodeChatGPT

Pick your app above. We remember it, so next time the button says “Install in …”.

Open Claude Desktop → Settings → Developer → Edit Config, and paste this into claude_desktop_config.json

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

Run this in your terminal

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

Fill in the empty values before running it.

Open in Cursor

Or copy the settings yourself

Paste into .cursor/mcp.json in your project, or ~/.cursor/mcp.json

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

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

Open in VS Code

Or copy the settings yourself

Paste into .vscode/mcp.json in your project

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

Your browser asks to open the app, then the app shows the settings and asks you to confirm. Key values are left empty for you to fill in.

This one runs on your computer, and ChatGPT can only connect to servers on the internet. Pick another app.

Your choice stays on this device in a cookie; no account needed.

Values you fill in

EODHD_API_KEY secret required 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.

These settings are generated from the maker’s registry entry. If the README says otherwise, follow the README.

What it can do

Runs on your computer; the tool list appears in your AI app after you install it.

Basic checksi

We check information anyone can see; we have not read the code. Checks that do not apply are left out of the count. · Checked Nov 6, 2026

✓ Pass
Maker matches the repo
The registry name was verified with the GitHub account techfreakworm, which owns the repo
… Not checked yet
Still maintained
We have not read this repo from GitHub yet
… Not checked yet
Has a licence
We have not read this repo from GitHub yet
– Not applicable
Endpoint responds
This one runs on your computer; there is no internet endpoint
– Not applicable
Sign-in with OAuth
Runs on your computer and uses local settings instead
… Not checked yet
No hidden instructions in tool descriptions
Runs on your computer; we can only read tool lists from internet endpoints

Compared with others in Otheri

More stars than 0% of the other 32497 servers in this category
Published to the registry more recently than 91% of the other 32497 servers in this category
Basic checks equal to or better than 100% of the other 32497 servers in this category

Compared with every active server in this category in the registry. Stars count only when the publisher owns the repo.

Common questions

Is EODHD Guard safe?

It passed 1 of 1 applicable basic checks. We have not read the code. Before adding a key or token, see what access the server asks for and use a key with only the permissions you need.

What keys or codes does it need?

You need to fill in: EODHD_API_KEY

Does it run on my computer or in the cloud?

It runs on your computer. Your AI app starts it when needed, and data does not pass through the maker’s servers (unless it calls an online service itself).

Is it still maintained?

The GitHub repo last changed –, and the latest version (0.2.0) reached the registry 3 days ago.

Which apps can use it?

Apps that support MCP, such as Claude Desktop, Claude Code, Cursor and VS Code. You also need Python (uv) on your computer.

What can I use instead?

In the same category: Spec Driven Development, Remote Desktop Commander, Zoo MCP

Alternatives

Servers in the same category from other makers, sorted by stars.

Reading a card:★ GitHub starsiThree pillars: reviews · checks · usageiUpdated = latest version published to the registryi

Spec Driven Development

by formulahendry

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

Runs on your computer★ 440MITUpdated 14 months ago

Install

Remote Desktop Commander

by desktop-commander

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

Runs in the cloud★ 211Updated yesterday

Install

Zoo MCP

by KittyCAD

An MCP server that provides access to the Zoo API for various CAD operations and tools.

Runs on your computerUpdated today

Install

README from the maker

Open the README

Copied from the maker’s repo as written. PopNx MCP has not reviewed or endorsed it. HTML, images and scripts are removed. Links lead off this site.

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

Only the beginning is shown; read the rest in the repo

EODHD Guard

Overview

PopNx MCP’s three pillars

What you can do with it

Install

Before you install

Values you fill in

What it can do

Basic checksi

Maker matches the repo

Still maintained

Has a licence

Endpoint responds

Sign-in with OAuth

No hidden instructions in tool descriptions

Compared with others in Otheri

Common questions

Alternatives

Spec Driven Development

Remote Desktop Commander

Zoo MCP

README from the maker

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