io.github.mohammad-abbasi-sh/ecb-mcp
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@io.github.mohammad-abbasi-sh/ecb-mcp Show me the latest euro exchange rates for USD and GBP"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
ecb-mcp πΆ
mcp-name: io.github.mohammad-abbasi-sh/ecb-mcp
Unofficial read-only MCP server for data-api.ecb.europa.eu β European Central Bank data via the official ECB SDMX API (free, no key, no login): euro exchange rates, key ECB interest rates, HICP inflation, M3 money supply and euro-area bond yields. No key, no login.
Built by Mohammad Abbasi as part of the "Germany MCP factory". Not affiliated with data-api.ecb.europa.eu.
For AI agents
Add to your MCP client config (stdio):
{
"mcpServers": {
"ecb": {
"command": "uvx",
"args": ["ecb-mcp==0.1.0"]
}
}
}Or run locally: python -m ecb_mcp.server (needs mcp<2, httpx).
Related MCP server: NexusForge EU Finance
Tools
Tool | Description |
| Daily euro reference rates β |
| Current key ECB interest rates β no params; returns MRO, deposit facility and marginal lending rates with dates |
| HICP annual inflation rate β |
| Money supply outstanding amounts β |
| AAA-rated euro-area yield curve β |
| Reachability probe (ok / blocked / error) β one polite request |
Development
python3 -m venv .venv && .venv/bin/pip install "mcp<2" httpx pytest
.venv/bin/pip install -e .
.venv/bin/python -m pytest tests/ -qLicense
MIT
Built by Mohammad Abbasi β Almanibama Β· mabbasi.ir
Available Tools
6 toolsecb_bond_yieldsA
AAA-rated euro-area government bond spot yields (%). maturity: 1Y, 2Y, 5Y, 10Y (default), 20Y or 30Y. limit: 1..30 days (default 5).
Inputs: limit, maturity. Returns: result
ecb_exchange_ratesB
Daily euro reference exchange rates (ECB). currencies: ISO codes like ["USD", "GBP", "JPY"] β default: all major currencies (25). limit: 1..30 days of history per currency (default 5). Returns the latest rate per currency plus history.
Inputs: limit, currencies. Returns: result
ecb_healthA
Check whether the ECB SDMX API is reachable right now.
Returns status ok (HTTP 200), blocked (HTTP 403/429 β bot wall or rate limit) or error, plus the HTTP status and the probed URL. One polite request; it does not fetch any listings.
Inputs: no named parameters. Returns: result
ecb_inflationB
HICP annual inflation rate (%). area: "U2" (euro area, default) or "DE" (Germany). limit: 1..24 months (default 6).
Inputs: area, limit. Returns: result
ecb_interest_ratesA
Current key ECB interest rates: main refinancing operations, deposit facility and marginal lending facility β with the date each rate took effect (daily series, latest observation).
Inputs: no named parameters. Returns: result
ecb_money_supplyB
Euro-area money supply outstanding amounts (EUR millions). aggregate: "M1", "M2" or "M3" (default). limit: 1..24 months (default 6).
Inputs: limit, aggregate. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelogβ¦
TDQS
Scored across 6 tools
Each tool maps to a clearly distinct ECB dataset (exchange rates, interest rates, inflation, money supply, bond yields) with no overlapping scope, and ecb_health is unambiguously a connectivity probe. Parameter names (currencies, area, aggregate, maturity, limit) further separate the tools.
All six tools follow the same ecb_<domain_noun> snake_case pattern, and parameter names use consistent lowercase snake_case as well. The only slight outlier is ecb_health, but it still fits the prefix/pattern convention.
Six tools is well-scoped for a focused ECB statistical data server, with one tool per major dataset plus a diagnostic. Nothing feels padded or redundant.
The set covers the headline ECB datasets with sensible defaults and history limits, and includes a health check for failure diagnosis. Minor gaps exist: no discovery/metadata tool to enumerate valid currencies, areas, or aggregates, and no fallback beyond the health probe.
Maintenance
Related MCP Connectors
Query IMF SDMX 3.0 macroeconomic dataflows β WEO, BOP, CPI, exchange rates, 190 countries.
Exchange rates for about 150 currencies from central banks (ECB and others). Free, no key.
Official ECB euro reference rates for invoices and tax returns. $0.004/call via x402.
Search and query 1,500+ OECD statistical datasets via SDMX. Keyless.
Related MCP Servers
- AlicenseAqualityDmaintenanceECB data for AI agents β rates, yields, inflation, money supply, and 100+ datasets. No API key.861 npm4MIT
- AlicenseAqualityDmaintenanceEuropean financial data for AI agents β ECB interest rates, Eurostat inflation, GDP and unemployment by country. Zero API key needed.683 npm1MIT
- AlicenseNot gradedqualityBmaintenanceProvides access to European Central Bank statistical data through SDMX data flows, enabling querying and listing of data flows via natural language or direct tool calls.136 npmMIT
- AlicenseAqualityBmaintenanceProvides live and historical foreign-exchange rates from the European Central Bank via Frankfurter API, enabling currency conversion, rate lookup, and trend analysis without API keys.55 npmMIT