cahthuranag/mcp-server

Website: https://allratestoday.com · Hosted endpoint (no install): https://allratestoday.com/api/mcp · Docs: https://allratestoday.com/mcp/
English | 简体中文
**Give your AI assistant a live window into the foreign-exchange market. A Model Context Protocol server that lets Claude Code, Cursor, Claude Desktop, Windsurf, and any MCP-compatible client fetch real-time currency rates, historical series, and multi-currency lookups from the AllRatesToday API.**
After installation, your assistant can answer questions like:
- *"What's the current USD to EUR rate?"*
- *"Show me how GBP/JPY moved over the last 30 days."*
- *"Convert 250 USD into CAD at a real rate."*
- *"Compare USD against EUR, GBP, and JPY simultaneously."*
🚀 Why this server?
- 📡 **Live mid-market rates** — 150+ ISO 4217 currencies, refreshed every ~60 seconds
- 📈 **Historical series built in** — 1d / 7d / 30d / 1y windows with sensible granularity per period
- 🧰 **Eight focused tools** — get_exchange_rate, get_historical_rates, get_rates_authenticated, list_currencies, list_central_banks, get_official_rates, get_reference_rate, request_trial_key; small surface, easy for the model to use correctly
- 🔌 **Works everywhere MCP does** — stdio transport, MCP 1.x; Claude Code, Cursor, Claude Desktop, Windsurf, or any generic host
- 🔓 **Works with no API key** — installs and answers out of the box from the open ECB reference table; a free key unlocks real-time rates for 160+ currencies
- 🛡️ **Honest about what it returned** — every keyless answer says which rate it is and when it was published; API errors map to clear, actionable messages
- 🔒 **Nothing leaks** — only the request parameters and your API key ever reach allratestoday.com; never conversation context
⚖️ Mid-market vs official central-bank rates
Everything this server returns is a **mid-market rate**, refreshed every ~60 seconds — the right number for price display, conversion, and anything that should track the market. It is *not* the official rate a tax authority or auditor may require. For those, call **get_official_rates**: the latest table published by any of 121 central banks and 3 tax authorities (ECB, Fed, HMRC, US Treasury, Swiss BAZG, …), fixed once published and carrying the institution's own rate_date, no key needed. list_central_banks gives the codes. Dated tables and history sit behind the free key — see the central bank REST API and per-bank npm SDKs. The two can diverge by several percent, so pick by use case, not convenience.
🔓 Keyless mode — what works with no setup
Install it with no configuration at all and it starts, connects, and answers:
| Tool | Keyless | What you get |
|---|---|---|
| get_exchange_rate | ✅ | Official **ECB daily reference rate**, ~30 major currencies. The response carries rate_date and a note saying so, so the assistant never passes it off as a live quote. |
| list_currencies | ✅ | All 160+ supported ISO 4217 codes. |
| list_central_banks | ✅ | Codes, names and latest publication date of all 121 central banks + 3 tax authorities. |
| get_official_rates | ✅ | Latest **official table** (or one pair) published by any of them. A dated table needs the key. |
| get_reference_rate | ✅ | The **Daily Reference Rate**: one never-revised table per business day, fixed at 16:00 London. A past date needs the key. |
| request_trial_key | ✅ | Self-issues a 100-call, 7-day key with no account and adopts it for the session. |
| get_historical_rates | 🔑 | Returns one sentence explaining how to get a free key. |
| get_rates_authenticated | 🔑 | Same. |
The keyless path reads the open, edge-cached /api/open/central-bank/ecb
endpoint — no upstream cost, no rate limit to trip over, nothing to sign up for.
🔑 Get your API key (free)
A key unlocks **real-time mid-market rates across 160+ currencies**, historical
series, and multi-target / point-in-time lookups. The free tier is enough for
development and personal use — **no credit card required**.
1. Register at allratestoday.com/register — 30 seconds
2. Verify your email
3. Copy your key from the dashboard (format: art_live_xxxxx)
4. Use it as ALLRATES_API_KEY in the configs below
Without one the server prints a short summary of keyless mode on stderr and