Name: EODHD Guard
Author: techfreakworm

EODHD Guard MCP

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

Grade A Local · stdio API key 17 tools v0.2.0 MIT

No reviews yet by techfreakwormPyPI 677 Runs on your machine, nothing hosted

100/100

trust score

downloads a day

local

runs on your machine

downloads in 30d

What it does

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

Quickstart

# 1 — add it to Claude Code
claude mcp add --scope user --env 'EODHD_API_KEY=${EODHD_API_KEY}' --transport stdio eodhd-guard-mcp '--' uvx eodhd-guard-mcp

# 2 — ask your agent for something these tools do
#   get_earnings_calendar, get_dividends, get_dividend_calendar and 14 more

It needs EODHD_API_KEY: this reads it from your environment, so export it first.

EODHD Guard costs nothing on mcprush: there is no plan to choose here, no cap to set and nothing mcprush can bill you for.

Publishernot claimed

techfreakworm2 servers

1 category

All 2 servers

Collected from a public index. Nobody has claimed this account, so nothing here was written by its author — claim it if it is yours.

Installation

Where are you running it?

Every route below installs the same thing and ends at the same approval screen. This one runs on your machine: your client starts EODHD Guard as a process under your own user, with your files and your network, so the tool surface below is what it can do to your computer rather than to a server somewhere else. Its scan result is on the Security tab — read the surface before you approve it.

Claude Codedeclared by this listing

This is a public server: you run it yourself and this marketplace is not in the path. You need uv (docs.astral.sh/uv): uvx comes with it. Claude Code registers it in one command; --scope user makes it available in every project. Claude Code reads EODHD_API_KEY (Your EODHD API key. You need your own EODHD subscription) from your environment each time it starts the server, so the value stays out of its config: export it in your shell profile (macOS, Linux), or run setx EODHD_API_KEY … and open a new terminal (Windows). The '--' is in quotes so that PowerShell passes it on.

claude mcp add --scope user --env 'EODHD_API_KEY=${EODHD_API_KEY}' --transport stdio eodhd-guard-mcp '--' uvx eodhd-guard-mcp

Reconnect, or start a new session, and the tools appear in the model’s tool list.

Free on mcprush, and it runs from its publisher’s own package: this marketplace is not in the path, so there is no key of ours to hold and no card to add.

What it asks of you

It reaches a system of yours, so it needs your own credential rather than the publisher’s: EODHD_API_KEY — Your EODHD API key. You need your own EODHD subscription.. You set it in your own client’s config, on your machine — this marketplace never holds it.

What it writes

One config entry your client uses to start the process locally. A local server runs with your file system and your network, which is why it is priced without metering.

What you approve

17 tools, with what each one reads, writes and reaches shown before you agree — the same list on every route above. Read the tool surface.

Tool surface

What the model actually sees. Descriptions are diffed on every release — see version history.

Only tools that write or reach the network

Read from its source code. A server that builds its tool list when it starts can list more tools than this.

Earnings report dates in a window, with EPS actual, estimate and surprise once a company has reported. Costs 1 API call whatever the window or the number of symbols: the tool fetches the whole-market calendar once (cached for 6 hours) and filters it by symbols and exchange itself, because…

Parameter	Type	Required	Notes
start	string	no	First report date, YYYY-MM-DD. Default: today (UTC). May be in the past, to see reported results.
end	string	no	Last report date, YYYY-MM-DD. Default: start plus 14 days. The window spans at most 90 days.
symbols	array/string	no	Only these symbols, CODE.EXCHANGE, at most 100, as a list or a comma-separated string. Filtered here: it does not change the cost of 1 call.
exchange	string	no	Only rows on this exchange code, for example US, LSE, SW or NSE. With symbols, a row must match both.
max_rows	integer	no	Rows per page, 1 to 1000. Default 200.
offset	integer	no	Rows to skip, to read the next page. Default 0.

Dividend history for one symbol: ex-date, declaration, record and payment dates and the amount per share, oldest first, with future ex-dates flagged as upcoming. Costs 1 API call, cached for 24 hours. value is adjusted for splits and unadjusted_value is the amount as declared; London lines are…

Parameter	Type	Required	Notes
symbol	string	yes	The line as CODE.EXCHANGE, for example AAPL.US, VOD.LSE or NESN.SW.
start	string	no	First ex-date to include, YYYY-MM-DD. Default: the full history.
end	string	no	Last ex-date to include, YYYY-MM-DD. Default: no limit, so declared future dividends are included.
max_rows	integer	no	Most rows to return, 1 to 1000; the newest are kept. Default 100.

The symbols that have a dividend dated on one day. Costs 1 API call, cached for 6 hours. The calendar carries only the symbol and the date, with no amounts: call get_dividends for a symbol to get them. Results are paged with max_rows and offset.

Parameter	Type	Required	Notes
date	string	yes	The day to list, YYYY-MM-DD.
max_rows	integer	no	Rows per page, 1 to 1000. Default 200.
offset	integer	no	Rows to skip, to read the next page. Default 0.

Split history for one symbol, each ratio parsed into new shares, old shares and a factor (new divided by old: 4 is a 4-for-1 split, 0.1 a 1-for-10 reverse split). Costs 1 API call, cached for 24 hours. EODHD also lists spin-off and rights adjustments among the splits; ratios that are not whole…

Parameter	Type	Required	Notes
symbol	string	yes	The line as CODE.EXCHANGE, for example AAPL.US, NVDA.US or NESN.SW.
start	string	no	First split date to include, YYYY-MM-DD. Default: all.
end	string	no	Last split date to include, YYYY-MM-DD. Default: all.

Splits announced or executed in a window, for the whole market. Costs 1 API call whatever the window (cached for 6 hours); symbols and exchange are filtered here and cost nothing extra. The window defaults to the next 30 days and spans at most 90. Each row has old and new shares, the factor…

Parameter	Type	Required	Notes
start	string	no	First split date, YYYY-MM-DD. Default: today (UTC).
end	string	no	Last split date, YYYY-MM-DD. Default: start plus 30 days. At most 90 days.
symbols	array/string	no	Only these symbols, CODE.EXCHANGE, at most 100, as a list or a comma-separated string. Filtered here, at no extra cost.
exchange	string	no	Only rows on this exchange code, for example US, LSE or NSE.
max_rows	integer	no	Rows per page, 1 to 1000. Default 200.
offset	integer	no	Rows to skip, to read the next page. Default 0.

Financial news for 1 to 5 symbols or one topic tag such as earnings: headlines, excerpts, tickers, tags and sentiment scores. Costs 5 API calls per ticker (5 for a topic); cached 15 minutes if the window reaches today, else 6 hours. Defaults to 7 days and 10 articles; include_content returns…

Parameter	Type	Required	Notes
symbols	array/string	no	Tickers as CODE.EXCHANGE, for example ["AAPL.US", "VOD.LSE"], as a list or a comma-separated string: 1 to 5, billed 5 API calls each. Give either symbols or topic.
topic	string	no	One EODHD topic tag instead of symbols, for example earnings, ipo or balance sheet (case does not matter; letters, digits, spaces, hyphens and underscores, at most 40 characters). Billed 5 API calls.
start	string	no	First day of the window, YYYY-MM-DD (UTC). Default: 7 days before end. The window spans at most 90 days.
end	string	no	Last day of the window, YYYY-MM-DD (UTC), included. Default: today; a later date is clamped to today.
max_items	integer	no	Most articles to return, 1 to 50, newest first. Default 10; at most 10 with include_content. TRUNCATED gives the offset of the next page.
offset	integer	no	Articles to skip, 0 to 9000, to read the next page. Default 0.
include_content	boolean	no	Return up to about 4,000 characters of each article instead of a 400-character excerpt. Limits max_items to 10. Default false.

Daily news-sentiment scores for 1 to 10 symbols, oldest first, with the article count behind each day and an article-weighted average. Costs 5 API calls per symbol; cached 15 minutes if the window reaches today, else 6 hours. Scores run from -1 to 1; days with fewer than 3 articles are flagged,…

Parameter	Type	Required	Notes
symbols	array/string	yes	Tickers as CODE.EXCHANGE, for example ["AAPL.US", "VOD.LSE"], as a list or a comma-separated string: 1 to 10, billed 5 API calls each.
start	string	no	First day of the window, YYYY-MM-DD (UTC). Default: 30 days before end. The window spans at most 366 days.
end	string	no	Last day of the window, YYYY-MM-DD (UTC), included. Default: today; a later date is clamped to today.

Economic releases and events in a window, sorted by time in UTC, with actual, estimate and previous values. Costs 1 API call whatever the window, country, event filter or page: the window is fetched once (up to 1,000 rows; cached 15 minutes if it includes today, else 6 hours) and filtered and…

Parameter	Type	Required	Notes
start	string	no	First day of the window, YYYY-MM-DD (UTC). Default: today. May be in the past, to see published results.
end	string	no	Last day of the window, YYYY-MM-DD (UTC), included. Default: start plus 7 days. The window spans at most 90 days.
country	string	no	Only this country, an ISO 3166 alpha-2 code such as US, GB, DE, JP or CN (GB, not UK). It is sent to EODHD, so it also keeps a busy window under the 1,000-row cap. Default: all countries.
comparison		no	Only events compared week on week (wow), month on month (mom), quarter on quarter (qoq) or year on year (yoy). Default: all.
event	string	no	Only events whose name contains this text, ignoring case, for example payrolls or cpi. Filtered here, at no extra cost.
max_rows	integer	no	Events per page, 1 to 1000, sorted by time. Default 100.
offset	integer	no	Events to skip, 0 to 1000, to read the next page. Default 0.

List the exchanges EODHD knows, with code, country, currency and a coverage note. Costs 1 API call, or 0 when cached (the list is kept for 7 days). Tokyo and the UAE have no usable prices and are missing or empty, so being listed is not proof of coverage; the result carries PARTIAL_COVERAGE. An…

Parameter	Type	Required	Notes
query	string	no	Words to look for in the exchange code, name or country, for example 'india' or 'swiss'. Every word must match. Leave out to list all exchanges.

List the symbols on one exchange, active or delisted, filtered and paged here. Costs 1 API call for the whole list (cached 24 hours), so more pages and other filters on the same exchange and delisted flag cost 0. Narrow it with query (words from the code, name or ISIN) and type (common_stock, etf,…

Parameter	Type	Required	Notes
exchange	string	yes	Exchange code as in a symbol's suffix, for example US, LSE, SW or NSE.
query	string	no	Words to look for in the code, name or ISIN, in any order, for example 'nestle'. Leave out for no filter.
type	string	no	Only this type of instrument, matched ignoring case with spaces written as underscores: common_stock, etf, fund, preferred_stock, mutual_fund, index and so on. Leave out for all types.
delisted	boolean	no	True lists delisted lines instead of active ones. Search never finds them.
max_rows	integer	no	Rows per page, 1 to 500. TRUNCATED reports the total.
offset	integer	no	Position of the first row of the page, to page on.

Find symbols by company name or code. Costs 1 API call (cached 24 hours). Each row has the previous close and its date, and possibly_inactive marks a line whose previous close is old: it may be delisted or renamed, so run check_symbol before relying on it. Delisted lines are not searchable; use…

Parameter	Type	Required	Notes
query	string	yes	A company name or a code, such as 'Acme Corp' or 'ACME'. A '/' is read as a space.
exchange	string	no	Only lines on this exchange, for example SW or LSE. Leave out to search all.
type		no	Kind of instrument: all, stock, etf, fund, bonds, index or crypto.
max_results	integer	no	Most rows to return, 1 to 50.

Check whether a symbol is alive, and look for its successor if it is not. EODHD keeps answering HTTP 200 with frozen data for delisted or renamed codes, so this compares the newest of the last 14 days of bars with the latest session expected. Costs 1 API call, plus 1 for a quote with…

Parameter	Type	Required	Notes
symbol	string	yes	The symbol to check, as CODE.EXCHANGE, for example ROG.SW.
include_quote	boolean	no	Also ask for a real-time quote (1 more API call); 'NA' fields mean no_quote.
find_successor	boolean	no	When the code looks dead, find the line's name (in search, else in the exchange's delisted list) and search that name for a successor (up to 3 more API calls).

Parameter	Type	Required	Notes
symbol	string	yes	The line as CODE.EXCHANGE, for example AAPL.US, NESN.SW or VOD.LSE.
sections	array/string	no	Sections to return, as a list or a comma-separated string, from {_SECTIONS_ACCEPTED}. Leave out for the defaults of the instrument (stock, ETF or fund). Pass [] for no sections when only statements ar
statements	array/string	no	Financial statements to add: any of income, balance, cashflow, as a list or a comma-separated string. None by default. Each returns the newest periods periods without empty fields.
period	string	no	Whether the statements use quarterly or yearly periods.
periods	integer	no	How many of the newest periods to keep in each statement and in each Earnings list (History, Trend, Annual), from 1 to 40. Default 4.

End-of-day bars (daily, weekly or monthly) for one symbol. Costs 1 API call; cached for 6 hours when the range ends within a day of today, otherwise 24 hours. close is as EODHD reports it: not adjusted for splits or dividends, and sometimes back-adjusted for spin-offs, so use adjusted_close for…

Parameter	Type	Required	Notes
symbol	string	yes	The symbol as CODE.EXCHANGE, for example AAPL.US, VOD.LSE, NESN.SW or RELIANCE.NSE. A code without an exchange is refused. US share classes use a hyphen, as in BRK-B.US.
start	string	no	First day of the range, as YYYY-MM-DD. Defaults to 30 days before end.
end	string	no	Last day of the range, as YYYY-MM-DD. Defaults to today (UTC); a later date is clamped to today.
period		no	Bar length: d (daily), w (weekly) or m (monthly).
price_basis		no	both returns close and adjusted_close; raw returns only the reported open, high, low and close; adjusted scales open, high, low and close by adjusted_close / close, for returns.
include_filler_bars	boolean	no	Keep holiday filler bars (zero volume, open = high = low = close). They are dropped by default.
max_rows	integer	no	Most bars to return, 1 to 5000. When there are more, the most recent are kept (TRUNCATED).

Intraday bars (1m, 5m or 1h) for one symbol, timestamped in UTC. Costs 5 API calls; cached for 15 minutes when the window includes today, otherwise 24 hours. EODHD publishes intraday bars after the session, never during it, so today's bars are usually missing (INTRADAY_NOT_SAME_DAY): use get_quote…

Parameter	Type	Required	Notes
symbol	string	yes	The symbol as CODE.EXCHANGE, for example AAPL.US, VOD.LSE, NESN.SW or RELIANCE.NSE. A code without an exchange is refused. US share classes use a hyphen, as in BRK-B.US.
interval		no	Bar length: 1m, 5m or 1h. The default window is 1 day for 1m, 3 days for 5m and 14 days for 1h; the longest window is 120, 600 and 7200 days.
start	string	no	Start of the window: YYYY-MM-DD (00:00 UTC) or an ISO 8601 time such as 2026-10-28T13:30:00Z; a time without an offset is UTC. Defaults to the end minus the default window for the interval.
end	string	no	End of the window, in the same formats. A bare date means the end of that UTC day (every bar up to 23:59:59), so end=2026-10-30 includes the 30th; a time is used exactly. Defaults to now, rounded up t
max_rows	integer	no	Most bars to return, 1 to 5000. When there are more, the most recent are kept (TRUNCATED).

Delayed quotes for 1 to 20 symbols in one request. Costs 1 API call per symbol sent; cached for 60 seconds. Quotes are 15 to 20 minutes behind the market: as_of and age_seconds say how old each one is. For an unknown, delisted or renamed code EODHD answers HTTP 200 with every field set to "NA";…

Parameter	Type	Required	Notes
symbols	array/string	yes	The symbols as CODE.EXCHANGE, for example ["AAPL.US", "VOD.LSE", "NESN.SW"], or one comma-separated string. 1 to 20 symbols; a repeated symbol is sent once. A code without an exchange is refused.

Show what this server has spent: the local call ledger (per day, and today per endpoint), the daily budget, EODHD's own account counters and the price of each endpoint. Costs 0 API calls. EODHD and this ledger both count per GMT day, but the account counter includes other apps that share the key…

Parameter	Type	Required	Notes
days	integer	no	How many GMT days of the ledger to total, today included, 1 to 90.
include_account	boolean	no	Also read EODHD's account counters (free, no API call is charged). False makes no network request.

Free

$0 forever

Every tool, no call limit
No card, and mcprush charges nothing for it
Source published under MIT
Runs on your machine — nothing of it reaches our gateway
Nothing to cap, because mcprush bills nothing

Nothing here is billable: mcprush charges nothing to install EODHD Guard or to call it, at any volume.

ATrust score 100 / 100

Release 0.2.0 · scanned 4 Nov 2026

Two independent axes, because powerful and malicious are different questions. The grade is threat only. The capability level is blast radius, and it is never a penalty on the grade — it is priced as one subtract-only term in the score, where you can see it.

Threat score100

Client score100

Findings1 threat · 0 capability

Capabilityminimal

Coveragesource

Verificationsource

Surface digestd8d3978ef060fbff924f4a9ddab7e7886c6df10bbab83737ed82160399ca5e93

Score vectorthreat 100 → client 100

Term	Level	What it prices	Points
capability-exposure	minimal	capability blast radius (minimal) — client exposure if the model is manipulated	−0
verification-discount	source	publisher verification (provenance) — cryptographic build provenance ties the artifact to its source	−0
coverage-honesty	source	inspection depth (source) — how much of the target the scan could see	−0

score = clamp(round(threatScore − E_cap − E_ver − E_cov), 0, 100). No model, no opinion, no network call at scoring time: the same methodology version against the same bytes always produces this number, and every line above is a field of the report rather than a summary of it.

What the scan could actually read

A grade is only as meaningful as its coverage, so the scanner publishes its own depth before it publishes its result.

Tool surfaceread

Implementation sourceread

Package metadataread

Live transportnot available

Tools were statically extracted from the published source (17 recovered), not enumerated from a running server. Tool-poisoning, Unicode-smuggling, capability and toxic-flow analysis ran on this inferred surface, but a mis-parsed registration could be missed or mis-attributed, so tool-derived findings are capped below “confirmed”. To grade the real runtime surface, scan the running server: --command "npx -y <package>".

Capability — what it could do if the model were manipulated

Tags derived from each tool’s schema and the implementation, not from what the tool calls itself. minimal is the level these add up to.

Tool	Capability tags	Why the tag was assigned
get_earnings_calendar	no tags
get_dividends	no tags
get_dividend_calendar	no tags
get_splits	no tags
get_split_calendar	no tags
get_fundamentals	no tags
get_news	no tags
get_sentiment	no tags
get_economic_events	no tags
get_eod_prices	no tags
get_intraday_prices	no tags
get_quote	no tags
list_exchanges	no tags
list_exchange_symbols	no tags
search_symbols	no tags
check_symbol	no tags
get_usage	no tags

Toxic-flow graph

The lethal trifecta, checked as a graph rather than as a checklist: untrusted input, a sensitive source and an external sink have to meet before there is a path worth worrying about.

The public result for this release does not print the flow graph, so there is nothing to show here. That is not the same as "no paths were found": what the scan did read is above, under coverage.

Supply chain and provenance

Integrityfirst-seen

Surface digestd8d3978ef060fbff

Scanned2026-11-04

This is the first scan of this surface here, so there is nothing yet to compare it against.

Every result on this tab comes from one deterministic pass over the published package — offline, rule by rule, and auditable line by line above. Same methodology version, same bytes, same score.