{
  "markdown": "# ecb-mcp\n\nEuropean Central Bank data for AI agents. Exchange rates, interest rates, yield curves, inflation, money supply, and 100+ more datasets from the ECB — directly inside Claude, Cursor, Windsurf, or any MCP client.\n\nNo API key. No registration. No config. Just `npx ecb-mcp`.\n\n[![npm version](https://img.shields.io/npm/v/ecb-mcp.svg)](https://www.npmjs.com/package/ecb-mcp)\n[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)\n\n## Why\n\nThe ECB publishes 100+ statistical datasets via a free, public API — exchange rates for 40+ currencies, key interest rates, yield curves, HICP inflation, monetary aggregates, banking statistics, and much more.\n\nBut the API uses SDMX, a format nobody memorizes. You need to know dataflow IDs, dimension key structures, and query syntax just to get a single number.\n\necb-mcp translates natural questions into the right SDMX queries. Your AI agent asks \"What's the current EUR/USD rate?\" and gets a clean answer from live ECB data. No SDMX knowledge required.\n\n## Quick Start\n\nAdd to your MCP client config:\n\n```json\n{\n  \"mcpServers\": {\n    \"ecb\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"ecb-mcp\"]\n    }\n  }\n}\n```\n\nThat's it. No API key, no environment variables, no account creation.\n\n### Where to add this config\n\n- **Claude Desktop:** `~/Library/Application Support/Claude/claude_desktop_config.json` (macOS) or `%APPDATA%\\Claude\\claude_desktop_config.json` (Windows)\n- **Claude Code:** `claude mcp add ecb-mcp -- npx -y ecb-mcp`\n- **Cursor:** Settings > MCP Servers\n- **Windsurf:** `~/.windsurf/config.json`\n\n## What you can ask\n\nOnce installed, just ask your AI agent questions in natural language:\n\n> \"What's the current EUR/USD exchange rate?\"\n>\n> \"Show me ECB interest rate changes since 2022\"\n>\n> \"What's the eurozone inflation rate?\"\n>\n> \"Convert 5000 USD to GBP using ECB rates\"\n>\n> \"What's the 10-year euro area government bond yield?\"\n>\n> \"How has M3 money supply grown over the past year?\"\n>\n> \"What ECB datasets are available about bank lending?\"\n>\n> \"Explain the structure of the EXR dataset\"\n\n## Tools\n\n### get_exchange_rates\n\nEUR reference rates for 40+ currencies. Daily, monthly, or annual. The same rates used by European institutions and businesses.\n\n```\n\"What's the EUR/USD rate?\"\n\"Show me EUR/GBP rates for the last 30 days\"\n\"EUR/JPY monthly averages for 2024\"\n```\n\n### get_interest_rates\n\nThe ECB's key policy rates — the ones that move markets and drive eurozone monetary policy.\n\n```\n\"What is the current ECB deposit facility rate?\"\n\"Show me the history of ECB rate changes\"\n\"When did the ECB last change the main refinancing rate?\"\n```\n\n### get_yield_curve\n\nEuro area government bond yield curve. AAA-rated sovereign spot rates from 3 months to 30 years.\n\n```\n\"What's the 10-year euro area yield?\"\n\"Show me the 2-year yield over the past 6 months\"\n\"Compare 5Y and 10Y yields since January\"\n```\n\n### get_inflation\n\nHICP inflation — the official eurozone inflation measure. Available for the euro area as a whole or individual countries.\n\n```\n\"What's the current eurozone inflation rate?\"\n\"Germany's inflation over the past year\"\n\"Compare inflation in France vs Spain\"\n```\n\n### get_money_supply\n\nEuro area monetary aggregates (M1, M2, M3). Outstanding amounts or annual growth rates.\n\n```\n\"What's the current M3 money supply?\"\n\"M1 growth rate over the past year\"\n\"How has M3 evolved since 2020?\"\n```\n\n### convert_currency\n\nConvert any amount between currencies using official ECB reference rates. Supports EUR-direct, inverse, and cross-currency conversions (e.g., USD to GBP via EUR triangulation).\n\n```\n\"Convert 1000 EUR to USD\"\n\"How much is 500 GBP in JPY?\"\n\"What was 10000 USD worth in CHF on 2025-01-15?\"\n```\n\n### search_datasets\n\nSearch across all 100+ ECB statistical datasets by keyword. The ECB publishes far more than exchange rates — banking statistics, balance of payments, government debt, payment systems, insurance data, and much more.\n\n```\n\"What ECB datasets are about bank lending?\"\n\"Find datasets related to government debt\"\n\"What data does the ECB publish about payments?\"\n```\n\n### explain_dataset\n\nUnderstand any ECB dataset's structure — its dimensions, valid values, and how to query it. This is the key to unlocking the full 100+ datasets beyond the built-in tools.\n\n```\n\"Explain the EXR dataset structure\"\n\"What dimensions does the BSI dataset have?\"\n\"What are the valid currency codes?\"\n```\n\n## Data Source\n\nAll data comes directly from the [ECB Data Portal API](https://data.ecb.europa.eu/help/api/overview) (SDMX 2.1 REST).\n\n- No intermediary, no proxy — live data from the European Central Bank\n- No authentication or API key required\n- Exchange rates updated daily at 16:00 CET\n- Other datasets updated at various frequencies (monthly, quarterly)\n\n## Configuration\n\necb-mcp works with zero configuration. Optional settings:\n\n| Environment Variable | Default | Description |\n|---|---|---|\n| `ECB_API_URL` | `https://data-api.ecb.europa.eu/service` | API base URL. Only change this if you're proxying the ECB API. |\n| `DEBUG` | — | Set to any value to enable debug logging to stderr. |\n\n## Development\n\n```bash\ngit clone https://github.com/scka-de/ecb-mcp.git\ncd ecb-mcp\nnpm install\nnpm test                      # unit tests (fixtures, no API calls)\nINTEGRATION=true npm test     # integration tests (live ECB API)\nnpm run build                 # compile to dist/\nnpm run dev                   # run in dev mode\nnpm run lint                  # check code style\n```\n\n## How It Works\n\necb-mcp translates your AI agent's natural language questions into SDMX series key queries against the ECB API. For example, when Claude asks for the EUR/USD rate, ecb-mcp:\n\n1. Builds the SDMX key: `D.USD.EUR.SP00.A`\n2. Fetches CSV from `https://data-api.ecb.europa.eu/service/data/EXR/D.USD.EUR.SP00.A?format=csvdata`\n3. Parses the response and returns clean, human-readable data\n\nFor dataset discovery, ecb-mcp fetches and parses XML metadata from the ECB's structure definition endpoints, letting your agent explore all 100+ datasets without knowing SDMX.\n\n## License\n\nMIT\n",
  "bytes": 6118,
  "sha": "f8bedfdf6574692a0a19972ff1e827f5b354103d9259cbd15eb81ed9984f6ddf",
  "repo_slug": "scka-de/ecb-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_io_github_scka_de_ecb_mcp_03d8d3b8/readme"
}