{"_id":"@allratestoday/central-bank-mcp","_rev":"4-31ee3ce99497456bec00bd28f54a7204","name":"@allratestoday/central-bank-mcp","dist-tags":{"latest":"0.2.1"},"versions":{"0.1.0":{"name":"@allratestoday/central-bank-mcp","version":"0.1.0","keywords":["mcp","model-context-protocol","claude","cursor","central-bank","official-rates","exchange-rate","ecb","tax","allratestoday"],"license":"MIT","_id":"@allratestoday/central-bank-mcp@0.1.0","maintainers":[{"name":"chathurangac8","email":"basnayakac8@gmail.com"}],"homepage":"https://allratestoday.com/central-bank-rates-api/","bugs":{"url":"https://github.com/AllRates-Today/central-bank-mcp/issues"},"bin":{"central-bank-mcp":"dist/index.js"},"dist":{"shasum":"882147d08f0e8abc439d28a9372fc265ecfba87a","tarball":"https://registry.npmjs.org/@allratestoday/central-bank-mcp/-/central-bank-mcp-0.1.0.tgz","fileCount":9,"integrity":"sha512-/Kd5GeGt24PMCS7gLFW9ZzIiCCw80HeL8IrCejnpYxf2eZZSCxHoaDpHhqOBt6k6i+iSs0hPoaTXIGPRzifzoA==","signatures":[{"sig":"MEYCIQCsJE07iAvTLZGCNoqLN0wxZFy6+PZR7oSI/1qvtrBIDwIhAJn8ZtlVuEx/hut49jT8nx9+4lLS6HC4dv8M4Ig6YSht","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22454},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"mcpName":"io.github.cahthuranag/central-bank-mcp","scripts":{"dev":"tsc --watch","test":"node --test test/*.test.mjs","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"chathurangac8","email":"basnayakac8@gmail.com"},"repository":{"url":"git+https://github.com/AllRates-Today/central-bank-mcp.git","type":"git"},"_npmVersion":"9.2.0","description":"MCP server for official central-bank and tax-authority exchange rates — let AI tools (Claude Code, Cursor, Claude Desktop) fetch published rates from 60+ institutions (ECB, Fed, HMRC, BOJ, ...) via the AllRatesToday API.","directories":{},"_nodeVersion":"22.22.1","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^7.0.2","@types/node":"^26.1.1"},"_npmOperationalInternal":{"tmp":"tmp/central-bank-mcp_0.1.0_1787263073537_0.9924281962313504","host":"s3://npm-registry-packages-npm-production"}},"0.1.1":{"name":"@allratestoday/central-bank-mcp","version":"0.1.1","keywords":["mcp","model-context-protocol","claude","cursor","central-bank","official-rates","exchange-rate","ecb","tax","allratestoday"],"license":"MIT","_id":"@allratestoday/central-bank-mcp@0.1.1","maintainers":[{"name":"chathurangac8","email":"basnayakac8@gmail.com"}],"homepage":"https://allratestoday.com/central-bank-rates-api/","bugs":{"url":"https://github.com/AllRates-Today/central-bank-mcp/issues"},"bin":{"central-bank-mcp":"dist/index.js"},"dist":{"shasum":"2c8d963d18d4e531e347eaaa0e09b8565c0fe0d8","tarball":"https://registry.npmjs.org/@allratestoday/central-bank-mcp/-/central-bank-mcp-0.1.1.tgz","fileCount":9,"integrity":"sha512-9ciu8Em6DV7VdtzdOwgFt9VfvnuSqkVCcbJe/FkSWhwcSJF/WWkZ/CMRZ71wbqPX5lI91xHjFJO/D73bfrTbAg==","signatures":[{"sig":"MEQCIA5uVdzCQpCzowbEJKm8VW0PpWwCMUENbVMAb7lDAXsWAiBiAfFC1pxjPgNFIITJsGvNVxpnK/NgUE7dgzh7aXdFVA==","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":22450},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"d2fc1e818033f5116963b4f9864cf92b421d70e4","mcpName":"com.allratestoday/central-bank-mcp","scripts":{"dev":"tsc --watch","test":"node --test test/*.test.mjs","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"chathurangac8","email":"basnayakac8@gmail.com"},"repository":{"url":"git+https://github.com/AllRates-Today/central-bank-mcp.git","type":"git"},"_npmVersion":"9.2.0","description":"MCP server for official central-bank and tax-authority exchange rates — let AI tools (Claude Code, Cursor, Claude Desktop) fetch published rates from 60+ institutions (ECB, Fed, HMRC, BOJ, ...) via the AllRatesToday API.","directories":{},"_nodeVersion":"22.22.1","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^7.0.2","@types/node":"^26.1.1"},"_npmOperationalInternal":{"tmp":"tmp/central-bank-mcp_0.1.1_1787263345644_0.7211124212232383","host":"s3://npm-registry-packages-npm-production"}},"0.2.0":{"name":"@allratestoday/central-bank-mcp","version":"0.2.0","keywords":["mcp","model-context-protocol","claude","cursor","central-bank","official-rates","exchange-rate","ecb","tax","allratestoday"],"license":"MIT","_id":"@allratestoday/central-bank-mcp@0.2.0","maintainers":[{"name":"chathurangac8","email":"basnayakac8@gmail.com"}],"homepage":"https://allratestoday.com/central-bank-rates-api/","bugs":{"url":"https://github.com/AllRates-Today/central-bank-mcp/issues"},"bin":{"central-bank-mcp":"dist/index.js"},"dist":{"shasum":"f50ffc0af608b72c7836c655925785def30ab0be","tarball":"https://registry.npmjs.org/@allratestoday/central-bank-mcp/-/central-bank-mcp-0.2.0.tgz","fileCount":11,"integrity":"sha512-95rBSQ6qPalT9xRFgyvjqIAK1AY9Uaw00TNY0LfLVLI4GQz0oqll/qJS88H8IPNgOB/GUcsVDP4Pkzb9pvuaqA==","signatures":[{"sig":"MEYCIQD5BJhEEJ6QsndE60bIim0qM/sClB3Y1E/gOJKl93K/1AIhAM1wojLN2U1YAVX1mx1NlRoTC7mu7NcBfmJTViGhjEPI","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"}],"unpackedSize":45813},"main":"dist/index.js","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"bfe6f63414e693c843998cf23d386019471495eb","mcpName":"com.allratestoday/central-bank-mcp","scripts":{"dev":"tsc --watch","test":"node --test test/*.test.mjs","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"_npmUser":{"name":"chathurangac8","email":"basnayakac8@gmail.com"},"repository":{"url":"git+https://github.com/AllRates-Today/central-bank-mcp.git","type":"git"},"_npmVersion":"9.2.0","description":"MCP server for official central-bank and tax-authority exchange rates — let AI tools (Claude Code, Cursor, Claude Desktop) fetch published rates from 60+ institutions (ECB, Fed, HMRC, BOJ, ...) via the AllRatesToday API.","directories":{},"_nodeVersion":"22.22.1","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^7.0.2","@types/node":"^26.1.1"},"_npmOperationalInternal":{"tmp":"tmp/central-bank-mcp_0.2.0_1788081520923_0.18497171237753673","host":"s3://npm-registry-packages-npm-production"}},"0.2.1":{"_id":"@allratestoday/central-bank-mcp@0.2.1","bin":{"central-bank-mcp":"dist/index.js"},"bugs":{"url":"https://github.com/AllRates-Today/central-bank-mcp/issues"},"dist":{"shasum":"199d5ee88ae730eaec8498512eb93b2fd8c4228b","tarball":"https://registry.npmjs.org/@allratestoday/central-bank-mcp/-/central-bank-mcp-0.2.1.tgz","fileCount":11,"integrity":"sha512-4Vrz/A6gQ1jpz+Sahzxzd4KCKd2Q4neDgq74xnHYLzhyBxqtIGp4zeYZq1Tw95tx8pEXYgJKG5QtbzzRTGo1Ng==","signatures":[{"sig":"MEUCIQD4ilJ2T3Cv7BB5GRTEil1dSDmNnP+MIc6Xx2h1apfGhAIgAJctzSCuHO2V9lVsi9BRCw0atcd6qXwvF7dQXE9rd2Y=","keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U"},{"keyid":"SHA256:DhQ8wR5APBvFHLF/+Tc+AYvPOdTpcIDqOhxsBHRwC7U","sig":"MEUCIE+pcSfQPBa+R5nFNCvn3FxOCs81i0JDCQ4mJnMSlkXiAiEAvNcz86rltOJAqeQblmSCcHVIjOMfLq9OSwJyPr12x3Y="}],"unpackedSize":46582},"main":"dist/index.js","name":"@allratestoday/central-bank-mcp","type":"module","types":"./dist/index.d.ts","engines":{"node":">=18"},"gitHead":"dad9db035a9a05ccad5baade84e1e0525bd1ebef","license":"MIT","mcpName":"com.allratestoday/central-bank-mcp","scripts":{"dev":"tsc --watch","test":"node --test test/*.test.mjs","build":"tsc","start":"node dist/index.js","prepublishOnly":"npm run build"},"version":"0.2.1","_npmUser":{"name":"chathurangac8","email":"basnayakac8@gmail.com"},"homepage":"https://allratestoday.com/central-bank-rates-api/","keywords":["mcp","model-context-protocol","claude","cursor","central-bank","official-rates","exchange-rate","ecb","tax","allratestoday"],"repository":{"url":"git+https://github.com/AllRates-Today/central-bank-mcp.git","type":"git"},"_npmVersion":"9.2.0","description":"MCP server for official central-bank and tax-authority exchange rates — let AI tools (Claude Code, Cursor, Claude Desktop) fetch published rates from 60+ institutions (ECB, Fed, HMRC, BOJ, ...) via the AllRatesToday API.","directories":{},"maintainers":[{"name":"chathurangac8","email":"basnayakac8@gmail.com"}],"_nodeVersion":"22.22.1","dependencies":{"zod":"^4.4.3","@modelcontextprotocol/sdk":"^1.29.0"},"_hasShrinkwrap":false,"devDependencies":{"typescript":"^7.0.2","@types/node":"^26.1.1"},"_npmOperationalInternal":{"host":"s3://npm-registry-packages-npm-production","tmp":"tmp/central-bank-mcp_0.2.1_1789324605769_0.02827163563353685"}}},"time":{"created":"2026-08-20T21:57:53.125Z","modified":"2026-09-13T18:36:46.012Z","0.1.0":"2026-08-20T21:57:53.666Z","0.1.1":"2026-08-20T22:02:25.795Z","0.2.0":"2026-08-30T09:18:41.125Z","0.2.1":"2026-09-13T18:36:45.851Z"},"bugs":{"url":"https://github.com/AllRates-Today/central-bank-mcp/issues"},"license":"MIT","homepage":"https://allratestoday.com/central-bank-rates-api/","keywords":["mcp","model-context-protocol","claude","cursor","central-bank","official-rates","exchange-rate","ecb","tax","allratestoday"],"repository":{"url":"git+https://github.com/AllRates-Today/central-bank-mcp.git","type":"git"},"description":"MCP server for official central-bank and tax-authority exchange rates — let AI tools (Claude Code, Cursor, Claude Desktop) fetch published rates from 60+ institutions (ECB, Fed, HMRC, BOJ, ...) via the AllRatesToday API.","maintainers":[{"name":"chathurangac8","email":"basnayakac8@gmail.com"}],"readme":"# 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## ☁️ Hosted endpoint — nothing to install\n\nThe same tools also run as a hosted **Streamable HTTP** MCP server (together with the tools of the sibling AllRatesToday server, nine in total). Paste the URL into any client that supports remote MCP — Claude.ai and Claude Desktop connectors, ChatGPT, Cursor, VS Code, Codex, Gemini CLI:\n\n```\nhttps://allratestoday.com/api/mcp\n```\n\n```bash\nclaude mcp add --transport http allratestoday https://allratestoday.com/api/mcp\n```\n\nWorks keyless. With a key, send `Authorization: Bearer art_live_…` or, where the client only takes a URL, connect to `https://allratestoday.com/api/mcp?api_key=art_live_…`. Registry name: `com.allratestoday/mcp`. One-click Cursor / VS Code buttons: https://allratestoday.com/mcp/#hosted\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","readmeFilename":"README.md"}