{
  "markdown": "# Central Bank Rates MCP Server — @allratestoday/central-bank-mcp\n\n[![npm version](https://img.shields.io/npm/v/@allratestoday/central-bank-mcp.svg)](https://www.npmjs.com/package/@allratestoday/central-bank-mcp)\n[![npm downloads](https://img.shields.io/npm/dm/@allratestoday/central-bank-mcp.svg)](https://www.npmjs.com/package/@allratestoday/central-bank-mcp)\n[![license](https://img.shields.io/npm/l/@allratestoday/central-bank-mcp.svg)](./LICENSE)\n[![MCP](https://img.shields.io/badge/Model%20Context%20Protocol-1.x-blue.svg)](https://modelcontextprotocol.io)\n[![TypeScript](https://img.shields.io/badge/TypeScript-3178C6.svg)](https://www.typescriptlang.org/)\n\n**Give your AI assistant the official exchange rates that compliance, tax, and accounting actually require. A Model Context Protocol server that lets Claude Code, Cursor, Claude Desktop, Windsurf, and any MCP-compatible client fetch published central-bank and tax-authority rates from 60+ institutions — ECB, Fed, Bank of Japan, HMRC, US Treasury, and more — via the [AllRatesToday API](https://allratestoday.com/central-bank-rates-api/).**\n\nAfter installation, your assistant can answer questions like:\n\n- *\"What is the ECB's official USD/EUR rate today?\"*\n- *\"What HMRC rate should I use for this March invoice?\"*\n- *\"Show me the Bank of Japan's official rate for every day of Q1.\"*\n- *\"Compare the official USD/LKR rate across every central bank that publishes one.\"*\n\n## ⚖️ Official rates vs mid-market rates\n\nEverything this server returns is an **official published rate**: fixed once the institution publishes it, carrying that institution's own publication date — the number tax authorities, auditors, and customs require. It is *not* the live market rate. For **live mid-market rates** (price display, conversion, anything that should track the market), use the companion server [`@allratestoday/mcp-server`](https://www.npmjs.com/package/@allratestoday/mcp-server). The two can diverge by several percent — pick by use case. Methodology: [allratestoday.com/official-rates-methodology](https://allratestoday.com/official-rates-methodology/).\n\n## 🚀 Why this server?\n\n- 🏛️ **100+ official sources** — central banks (ECB, Fed, BOJ, SNB, RBI, …) plus tax authorities (HMRC, US Treasury, …), each served from its own published tables\n- 📅 **Point-in-time correctness** — ask for any date; weekends and holidays roll back to the rate legally in force, and the response tells you which publication date applied\n- 📊 **Cross-bank comparison** — one call returns every institution's rate for a pair, with min/max/median and spread stats\n- 🧮 **Honest derivations** — pairs a bank doesn't publish directly are cross-computed only within that bank's own table and flagged `derived`; banks are never mixed\n- 🔓 **Works with no API key** — installs and answers out of the box; the latest published table of every source is open\n- 🧰 **Five focused tools** — small surface, easy for the model to use correctly\n- 🔌 **Works everywhere MCP does** — stdio transport, MCP 1.x; Claude Code, Cursor, Claude Desktop, Windsurf, or any generic host\n\n## 🔓 Keyless mode — what works with no setup\n\nInstall it with no configuration at all and it starts, connects, and answers:\n\n| Tool | Keyless | What you get |\n|---|---|---|\n| `list_central_banks` | ✅ | Every covered institution, from a catalogue bundled with the package (no coverage dates). |\n| `get_official_rates` | ✅ | The **latest published table** of any source, or one pair from it, with the publisher's own `rate_date`. |\n| `get_official_rates` with a `date` | 🔑 | One sentence explaining how to get a key. |\n| `get_official_rate_history` | 🔑 | Same. |\n| `compare_official_rates` | 🔑 | Same. |\n| `get_publication_calendar` | 🔑 | Same. |\n\nThe keyless path reads the open, edge-cached `/api/open/central-bank/{bank}`\nendpoint — free to use with a visible attribution link back to allratestoday.com\n(the exact wording ships in each response's `attribution` field).\n\n## 🔑 Get your API key (free)\n\nA key adds historical dates, time series, cross-bank comparison and publication\ncalendars. The free tier covers the latest published tables and light historical\nuse — **no credit card required**. Deep history and dated tables need a paid plan.\n\n1. Register at [allratestoday.com/register](https://allratestoday.com/register) — 30 seconds\n2. Verify your email\n3. Copy your key from the dashboard (format: `art_live_xxxxx`)\n4. Use it as `ALLRATES_API_KEY` in the configs below\n\nWithout one the server prints a short summary of keyless mode on stderr and\nkeeps running — it never exits, because an MCP server that exits breaks the\nhost client's whole configuration.\n\n## 🧩 Easiest install: the Claude Code plugin\n\nIf you use Claude Code, install the plugin instead of configuring this server by\nhand — it bundles both AllRatesToday MCP servers, two skills, and five slash\ncommands (`/rate`, `/convert`, `/official-rate`, `/fx-history`,\n`/add-currency-support`):\n\n```\n/plugin marketplace add AllRates-Today/claude-code-plugin\n/plugin install allratestoday@allratestoday\n```\n\nEverything below still applies for other MCP clients.\n\n## 📦 Installation\n\n```bash\n# Run without installing (recommended)\nnpx -y @allratestoday/central-bank-mcp\n```\n\n```bash\n# Or install globally\nnpm install -g @allratestoday/central-bank-mcp\ncentral-bank-mcp\n```\n\nBoth commands launch the stdio MCP server and wait for a client to connect — your MCP client launches them as a subprocess.\n\n## 🏁 Quick setup per client\n\n### Claude Code\n\n```bash\nclaude mcp add central-bank-rates -- npx -y @allratestoday/central-bank-mcp\nclaude mcp env central-bank-rates ALLRATES_API_KEY=art_live_xxxxx\n```\n\nRestart Claude Code. Verify by asking: *\"Which central banks can you fetch official rates from?\"*\n\n### Cursor\n\nEdit `~/.cursor/mcp.json` (or `.cursor/mcp.json` inside your project):\n\n```json\n{\n  \"mcpServers\": {\n    \"central-bank-rates\": {\n      \"command\": \"npx\",\n      \"args\": [\"-y\", \"@allratestoday/central-bank-mcp\"],\n      \"env\": {\n        \"ALLRATES_API_KEY\": \"art_live_xxxxx\"\n      }\n    }\n  }\n}\n```\n\n### Claude Desktop\n\nEdit `claude_desktop_config.json` (Settings → Developer → Edit Config) and add the same `mcpServers` block as the Cursor example above, then restart Claude Desktop.\n\n## 🧰 Tools\n\n| Tool | What it does | Plan |\n|---|---|---|\n| `list_central_banks` | All covered institutions with codes, metadata, latest date | Free (keyless: bundled catalogue) |\n| `get_official_rates` | A bank's published table (or one pair), latest or for a given date | Keyless (latest) / Paid (dated) |\n| `get_official_rate_history` | Date-by-date official series for one pair | Paid, billed ~1 call per month covered |\n| `compare_official_rates` | One pair across every bank, with spread stats | Free (key required) |\n| `get_publication_calendar` | Dates a bank actually published (no values) | Free (key required) |\n\n## 🔒 Privacy\n\nOnly the request parameters and your API key ever reach allratestoday.com — never conversation context.\n\n## 📚 More from AllRatesToday\n\n- [Central bank REST API docs](https://allratestoday.com/central-bank-rates-api/)\n- [Per-bank npm SDKs](https://github.com/AllRates-Today)\n- [`@allratestoday/mcp-server`](https://www.npmjs.com/package/@allratestoday/mcp-server) — live mid-market rates MCP server\n\n## License\n\nMIT © AllRatesToday\n",
  "bytes": 7336,
  "sha": "893abca4afd3f3df19a7fdd12b5d1a10cf4346a256975b46445799f4c41eee0d",
  "repo_slug": "allrates-today/central-bank-mcp",
  "fonte": "repo",
  "truncated": false,
  "api": "https://agentalog.com/api/listings/mcp_com_allratestoday_central_bank_mcp_32197b19/readme"
}