AllRatesToday MCP Server
Query live, historical, official, reference, and commercial-bank foreign-exchange rates plus related metadata via MCP tools.
Get current fiat-to-fiat exchange rates for a pair (live mid-market with a key; official central-bank fallback keyless).
Retrieve historical rate time series for 1d, 7d, 30d, or 1y windows (paid-plan key needed).
Fetch multiple target currencies in one call, with optional point-in-time or bucketed historical rates.
List supported ISO 4217 currencies with codes, names, and symbols.
List covered central banks and tax authorities with codes and latest publication dates.
Get official published rates from a named institution; dated tables need a paid-plan key.
Get AllRatesToday's daily 16:00 London reference rate; latest table is keyless, past dates need a paid plan.
Get commercial bank retail buy/sell board rates by country, bank, currency, or date (requires an API key; free key works).
Request and adopt a 7-day, 100-call trial API key without creating an account.
Fiat currencies only; no cryptocurrency or commodity support.
This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions:
AllRatesToday MCP Server — @allratestoday/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 — 160+ ISO 4217 currencies, refreshed every ~60 seconds
📈 Historical series built in —
1d/7d/30d/1ywindows with sensible granularity per period🧰 Nine focused tools —
get_exchange_rate,get_historical_rates,get_rates_authenticated,list_currencies,list_central_banks,get_official_rates,get_reference_rate,get_bank_rates,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 open official central-bank tables (ECB first, else the bank that issues one of the two currencies); 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
Related MCP server: xe-mcp
⚖️ Mid-market vs official central-bank rates
With a key, get_exchange_rate, get_historical_rates and get_rates_authenticated return 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 130+ central banks and 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 official tables (a past date) need an API key on a paid plan — a free key gets 403 Historical central bank rates require a paid plan. Mid-market history (get_historical_rates, and time on get_rates_authenticated) is paid-plan too — free and trial keys get 403. 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.
🔑 Get your API key (free)
A key unlocks real-time mid-market rates across 160+ currencies and multi-target lookups. The free tier is enough for development and trying it out — no credit card required. Historical series, point-in-time lookups and dated official and reference-rate tables need a paid plan from €4.99/month.
Register at allratestoday.com/register — 30 seconds
Verify your email
Copy your key from the dashboard (format:
art_live_xxxxx)Use it as
ALLRATES_API_KEYin the configs below
Without one the server prints a short summary of keyless mode (below) on stderr and keeps running — it never exits, because an MCP server that exits breaks the host client's whole configuration.
🔓 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 |
| ✅ | An official central-bank rate: the ECB reference table first, else the central bank that issues the target or source currency (USD/GBP → Bank of England, USD/INR → Reserve Bank of India). The response carries |
| ✅ | All 160+ supported ISO 4217 codes. |
| ✅ | Codes, names and latest publication date of all 130+ central banks and tax authorities. |
| ✅ | Latest official table (or one pair) published by any of them. A dated table needs a paid-plan key. |
| ✅ | The Daily Reference Rate: one never-revised table per business day, fixed at 16:00 London. A past date needs a paid-plan key. |
| ✅ | Self-issues a 100-call, 7-day key with no account and adopts it for the session. |
| 🔑 | Returns one sentence explaining how to get a key. Needs a paid plan. |
| 🔑 | Same. |
The keyless path reads the open, edge-cached /api/open/central-bank/{bank}
endpoints — no upstream cost, no rate limit to trip over, nothing to sign up for.
Attribution. Keyless use requires a visible, followable link to AllRatesToday wherever the rates are shown (a footer, an about page, a README). With an API key it is appreciated but not required.
<a href="https://allratestoday.com">Exchange rates by AllRatesToday</a>Markdown: Exchange rates by [AllRatesToday](https://allratestoday.com). Full wording: https://allratestoday.com/terms/#attribution.
🧩 Easiest install: the Claude Code plugin
If you use Claude Code, install the plugin instead of configuring this server by
hand — it bundles both AllRatesToday MCP servers, two skills, and five slash
commands (/rate, /convert, /official-rate, /fx-history,
/add-currency-support):
/plugin marketplace add AllRates-Today/claude-code-plugin
/plugin install allratestoday@allratestodayEverything below still applies for other MCP clients.
☁️ Hosted endpoint — nothing to install
The same tools also run as a hosted Streamable HTTP MCP server, which lists 11 tools: 8 of this stdio package's 9 (all except get_bank_rates) plus get_official_rate_history, compare_official_rates and get_publication_calendar from the sibling central-bank server. Paste the URL into any client that supports remote MCP — Claude.ai and Claude Desktop connectors, ChatGPT, Cursor, VS Code, Codex, Gemini CLI:
https://allratestoday.com/api/mcpclaude mcp add --transport http allratestoday https://allratestoday.com/api/mcpWorks 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_…. That puts the key in the URL, where client configs, logs and screenshots can expose it: prefer the header when your client supports it, never share or commit that URL, and rotate the key at https://allratestoday.com/profile if it leaks. Registry name: com.allratestoday/mcp. One-click Cursor / VS Code buttons: https://allratestoday.com/mcp/#hosted
📦 Installation
The simplest install is zero-install via npx, which is what every config below uses:
# Run without installing (recommended)
npx -y @allratestoday/mcp-server# Or install globally
npm install -g @allratestoday/mcp-server
allratestoday-mcpBoth commands launch the stdio MCP server and wait for a client to connect — they're not meant to be run interactively from your shell; your MCP client launches them as a subprocess.
🏁 Quick setup per client
Each client reads MCP servers from a different config file. Pick yours below.
Claude Code
The fastest path uses the built-in CLI:
claude mcp add allratestoday -e ALLRATES_API_KEY=art_live_xxxxx -- npx -y @allratestoday/mcp-serverRestart Claude Code. Verify by asking it: "What's the current USD to EUR rate?"
Cursor
Edit ~/.cursor/mcp.json (or .cursor/mcp.json inside your project for project-scoped servers):
{
"mcpServers": {
"allratestoday": {
"command": "npx",
"args": ["-y", "@allratestoday/mcp-server"],
"env": {
"ALLRATES_API_KEY": "art_live_xxxxx"
}
}
}
}Restart Cursor. The nine tools should appear in the MCP tool picker.
Claude Desktop
Edit the config file (path depends on OS):
OS | Path |
macOS |
|
Windows |
|
Linux |
|
{
"mcpServers": {
"allratestoday": {
"command": "npx",
"args": ["-y", "@allratestoday/mcp-server"],
"env": {
"ALLRATES_API_KEY": "art_live_xxxxx"
}
}
}
}Fully quit and reopen Claude Desktop (Cmd+Q on macOS, right-click tray icon → Exit on Windows). Closing the window alone keeps the old config loaded.
Windsurf
Edit ~/.codeium/windsurf/mcp_config.json with the same mcpServers block as above, then restart Windsurf.
Generic stdio MCP client
Any MCP host that supports stdio transport works. The launch command is:
npx -y @allratestoday/mcp-server…with the environment variable ALLRATES_API_KEY set. The protocol version is MCP 1.x.
✅ Verify it works
After configuring your client, test in this order:
Server starts — open the client. The server starts with or without a key (no key ⇒ keyless mode), so a red dot or "failed to connect" means the client could not launch it — usually
npxor Node ≥18 (see Troubleshooting below). A wrong key does not stop it starting; calls then returnInvalid AllRatesToday API key.Tools are listed — most clients have a "tools" or "MCP" panel showing the nine tools.
A live call returns a number — ask: "What's the current USD to EUR rate?" The assistant should call
get_exchange_rate(source: "USD", target: "EUR")and reply with a real rate. If it fabricates a number without a tool call, the server isn't connected.
More prompts that exercise the other tools:
"What was the ECB's official USD rate on the latest published table?" →
get_official_rates"Give me today's 16:00 London reference rate for EUR, GBP and JPY." →
get_reference_rate"Which central banks can you get official rates from?" →
list_central_banks"Convert 250 USD to CAD." →
get_exchange_rate
🧪 Test with MCP Inspector
To check the server on its own, without any AI client in the way, run it under the official MCP Inspector:
npx @modelcontextprotocol/inspector npx -y @allratestoday/mcp-serverOpen the URL it prints and click Connect. The Tools tab should list the nine tools.
Call
get_exchange_ratewithsource: USD,target: EUR— it answers keyless with an official rate.Set
ALLRATES_API_KEYin the Inspector's environment panel, reconnect, and call it again — now it returns the live mid-market rate.
If this works but your client doesn't, the problem is the client's config (path to npx, Node version, JSON syntax), not the server.
📚 Tools reference
get_exchange_rate— current rate for one pairget_historical_rates— time series over a preset periodget_rates_authenticated— multiple targets in one call, optional point-in-timelist_currencies— all supported currency codes, names, symbolslist_central_banks— every covered central bank / tax authority with its code and latest publication dateget_official_rates— the official table (or one pair) a named institution publishedget_reference_rate— the Daily Reference Rate, one fixed mid-market table per business day (16:00 London)request_trial_key— self-issue a 100-call, 7-day trial key, no account needed
get_historical_rates, get_rates_authenticated and get_bank_rates require ALLRATES_API_KEY; the other six of the nine work keyless. History (get_historical_rates, and time on get_rates_authenticated) needs a paid plan.
get_exchange_rate
Current mid-market rate between two currencies.
Input
Field | Type | Required | Description |
| string | yes | 3-letter ISO 4217 code, e.g. |
| string | yes | 3-letter ISO 4217 code, e.g. |
Example call
{ "source": "USD", "target": "EUR" }Response (with a key):
{ "rate": 0.888889, "source": "mid-market" }Response (keyless — USD → GBP, not in the ECB table, so the Bank of England table answers):
{
"rate": 0.7598784195,
"source": "Bank of England official rate (keyless mode)",
"bank": "boe",
"rate_date": "2026-10-14",
"derived": true,
"note": "Keyless mode: this is the Bank of England official rate published on 2026-10-14, not a live mid-market quote. For real-time rates across 160+ currencies set ALLRATES_API_KEY — free tier at https://allratestoday.com/register."
}derived: true means the bank publishes the inverse (GBP→USD) and the rate was inverted. A pair no single bank publishes is refused keyless with No keyless official source covers … and a pointer to the key.
get_historical_rates
Time-series data points for a currency pair over a fixed period. Needs an API key on a paid plan (free and trial keys get a 403).
Input
Field | Type | Required | Description |
| string | yes | Source currency code |
| string | yes | Target currency code |
| string | no (default | One of |
Granularity by period
| Data points |
| Hourly (24 points) |
| Daily (7 points) |
| Daily (30 points) |
| Weekly (52 points) |
Example call
{ "source": "USD", "target": "INR", "period": "30d" }Response (truncated):
{
"source": "USD",
"target": "INR",
"period": "30d",
"data": [
{ "date": "2026-09-17", "rate": 96.1006, "timestamp": 1789603200000 },
{ "date": "2026-09-18", "rate": 95.8142, "timestamp": 1789689600000 },
"...",
{ "date": "2026-10-16", "rate": 94.9643, "timestamp": 1792108800000 }
]
}get_rates_authenticated
Multiple targets in one call, with optional historical timestamp or grouping window.
Input
Field | Type | Required | Description |
| string | yes | Source currency code |
| string | yes | One or more codes, comma-separated ( |
| string (ISO 8601) | no | Historical point in time (paid plans) |
| string | no | One of |
Example call
{ "source": "USD", "target": "EUR,GBP,JPY" }Response:
{
"rates": [
{ "rate": 0.888889, "source": "USD", "target": "EUR", "time": "2026-10-16T12:16:01+0000" },
{ "rate": 0.749766, "source": "USD", "target": "GBP", "time": "2026-10-16T12:16:01+0000" },
{ "rate": 157.985, "source": "USD", "target": "JPY", "time": "2026-10-16T12:16:01+0000" }
]
}list_currencies
All supported currencies with codes, names, and symbols. Cached upstream for 24 hours — cheap to call for validating user input before the other tools.
Input — none.
Response (truncated):
{
"currencies": [
{ "code": "USD", "name": "US Dollar", "symbol": "$" },
{ "code": "EUR", "name": "Euro", "symbol": "€" },
{ "code": "GBP", "name": "British Pound", "symbol": "£" },
"..."
],
"count": 163
}list_central_banks
Every official source the server can quote — 120+ central banks plus HMRC, the US Treasury, Swiss BAZG, India's CBIC and Peru's SUNAT — with the code that get_official_rates takes as bank, the institution's name, its latest publication date, age_days, its publication cadence and a stale flag when it is behind its own schedule. Keyless.
Input — none.
Response (truncated):
{
"sources": [
{ "code": "ecb", "name": "European Central Bank", "latest": "2026-10-15", "age_days": 1, "stale": false, "cadence": "daily" },
{ "code": "fed", "name": "US Federal Reserve (H.10)", "latest": "2026-10-09", "age_days": 7, "stale": false, "cadence": "weekly" },
"..."
],
"stale_count": 3,
"checked_at": "2026-10-16T12:16:46.232Z"
}get_official_rates
The fixed, citable rate an institution published — for invoices, VAT and tax returns, customs, transfer pricing and audit. Not a live market rate.
Input:
Field | Type | Required | Description |
| string | yes | Source code from |
| string | no |
|
| string | no | With |
| string | no | With |
Response (one pair):
{
"bank": "ecb",
"rate_date": "2026-10-15",
"source": "EUR",
"target": "USD",
"rate": 1.1208,
"rate_type": "reference",
"derived": false,
"method": "published",
"age_days": 1,
"stale": false,
"cadence": "daily",
"attribution": { "source": "Official rates published by ECB, served by AllRatesToday", "url": "https://allratestoday.com/central-bank-rates-api/ecb/", "terms": "Free to use with visible attribution linking to allratestoday.com" }
}Omit source/target for the whole table as rates: [{ base, quote, type, value }]. Keyless, only pairs the bank publishes and their inverses (flagged derived: true) are served; other crosses are refused. With a key, pairs the bank does not publish directly are cross-computed inside its own table and flagged derived: true. Always cite rate_date.
get_reference_rate
AllRatesToday's Daily Reference Rate: the per-currency median of samples taken in a five-minute window centred on 16:00 London, published once per business day and never revised. Use it when a report, index or research series needs one reproducible rate per day. It is not the WM/Refinitiv fix and not a registered benchmark; every response carries a disclaimer and the rate_date.
Input
Field | Type | Required | Description |
| string | no | With |
| string | no | See above |
| string | no | Past business day |
Output — { rate_date, base, time, rates } for the table, or { rate_date, source, target, rate, derived } for a pair, plus method and disclaimer. Keyless for the latest table. Docs: https://allratestoday.com/reference-rate/
get_bank_rates
Retail buy and sell board rates that commercial banks display on their own websites, read hourly: SBI's TT buying rate, an Emirates NBD or HSBC Hong Kong board. 1,200+ commercial banks in 120+ countries. These are bank prices, not official or mid-market rates. Requires ALLRATES_API_KEY (the free key works).
Input
Field | Type | Required | Description |
| string | yes | Two-letter country code: |
| string | no | Bank code within the country, e.g. |
| string | no | One currency of that bank's board, e.g. |
| string | no | Stored board for a past day |
Output — { country, quote_ccy, banks: [{ bank, name, bank_updated_at, basis, captured_at, rates }] } for a country; one bank returns its rates (ccy, buy, sell, mid, spread_pct, official); with ccy, that row's fields at the top level. Every response carries a disclaimer. Bank codes: https://allratestoday.com/bank-exchange-rate-api/
request_trial_key
Self-issues an API key with 100 lifetime calls, valid 7 days, with no account and no email, and switches this server to it for the rest of the session. The reply tells the user to copy the key into the MCP config as ALLRATES_API_KEY to keep it across restarts. Capped at 3 keys per IP per day.
Input — agent (string, optional), purpose (string, optional).
Output — { key, calls, expires_at, adopted, note }.
⚙️ Environment variables
Variable | Default | Required | Purpose |
| — | no | Your API key, sent as |
|
| no | Override for self-hosted or staging deployments. |
Set these in your MCP client's config (in the env block) — not in your shell — because MCP servers are launched as subprocesses with isolated environments.
💳 Plans
A free tier and paid plans are available — see allratestoday.com/pricing for current quotas. The free tier covers real-time rates and multi-target lookups. All history and dated rates — mid-market history, point-in-time lookups, dated official and reference-rate tables — need a paid plan (free and trial keys get 403 historical_requires_paid_plan). The Official Rates plan covers official central-bank and tax-authority rates only (no market rates).
🛠️ Troubleshooting
Symptom | Likely cause | Fix |
Client shows "MCP server failed to start" or red dot | Not a missing key — 0.5.0+ starts fine without one. Usually | Run |
Rates look like yesterday's, response mentions "keyless mode" | No key set, so answers come from an official central-bank table (see | Set |
| Keyless mode, and no single central bank publishes that pair or its inverse | Set |
|
| Upgrade at /pricing — history is paid-only |
|
| Omit |
Every call returns "Invalid AllRatesToday API key" | Key is malformed (missing prefix, truncated, or revoked) | Copy a fresh key from the dashboard |
Tools return "AllRatesToday API quota exceeded" | Quota used up — the free tier does not reset; paid plans are monthly | Upgrade at /pricing |
Historical tool returns "Bad request" | Invalid period or unknown currency code | Period must be |
Server starts but tools never appear | Client didn't reload after config change | Fully quit (not just close) and reopen the client |
| The server is waiting for an MCP client to connect — normal when run from a shell | Let your MCP client launch it |
To inspect what the server is doing, run it manually with the key set:
ALLRATES_API_KEY=art_live_xxxxx npx -y @allratestoday/mcp-serverNo output means healthy (stdio is reserved for the MCP protocol); errors print to stderr.
🛡️ Error reference
The server maps API errors to clear, actionable messages the assistant can relay to the user:
HTTP status | Meaning | Tool error message |
200 | Success | (rate returned) |
400 | Bad request — usually unknown currency code |
|
401 | Invalid API key (a missing key does not cause this — the server runs keyless) |
|
403 | Plan does not include it (e.g. a dated official table on a free key) |
|
404 (keyless) | No keyless official source covers the pair |
|
429 | Quota exceeded |
|
5xx | Server-side issue at allratestoday.com |
|
❓ FAQ
Is the free plan really enough for normal use? For trying it out and light dev use. It does not reset monthly; regular use or production needs a paid tier. Keyless mode costs nothing and has no quota.
Do you store my conversation or query data? No. Only your API key and the request parameters (source, target, period, time) are sent to allratestoday.com — never the LLM's conversation context.
What happens to my API key?
It's only sent as a Bearer token in the Authorization header on requests to the AllRatesToday API. It's never logged or transmitted elsewhere.
Why is my first call slow?
Cold-start of npx (first run downloads the package) plus the initial cache miss. Subsequent calls are typically <200ms.
Can I run this without npm/Node? Not currently — Node ≥18 is required. If a standalone binary matters to you, open an issue.
Is there a self-hosted option?
Set ALLRATES_BASE_URL to your own AllRatesToday instance. Contact support@allratestoday.com for self-hosted licensing.
Does this work with ChatGPT?
Yes, through the hosted endpoint: add https://allratestoday.com/api/mcp as a connector (custom MCP / remote server) in ChatGPT. This npm package is the local stdio server, for clients that launch a command — Claude Code, Cursor, Claude Desktop, Windsurf.
👩💻 Development
git clone https://github.com/AllRates-Today/mcp-server.git
cd mcp-server
npm install
npm run build
ALLRATES_API_KEY=art_live_xxxxx node dist/index.jsThe server runs on stdio and waits for an MCP client to connect; Ctrl+C to exit. npm run dev watches and rebuilds. To test against a local AllRatesToday instance:
ALLRATES_BASE_URL=http://localhost:8080/api ALLRATES_API_KEY=test_key node dist/index.jsProject structure
src/
├── index.ts # MCP server, tool registration, request handlers
├── client.ts # HTTP client for AllRatesToday API + error mapping
└── home-banks.ts # currency → issuing central bank, for the keyless get_exchange_rate fallback
dist/ # Compiled JS (gitignored)
server.json # MCP registry manifestContributing — issues and PRs welcome at github.com/AllRates-Today/mcp-server. Before opening a PR: npm run build must succeed, test against a real API key, and update the tool descriptions in src/index.ts plus this README's tools reference if you change tool behavior.
📝 Changelog
Recent changes. Full history: GitHub Releases.
0.7.9 — README: changelog trimmed to the 0.7.x line
0.7.8 — README: MCP Inspector test guide, example prompts for every tool, hosted
?api_key=security note, ChatGPT FAQ and 401 row corrected, history consistently paid-plan0.7.6 — Keyless
get_rates_authenticatedwithtimenow says a paid plan is needed; README: free tier no longer listed as covering history,sourceexample ismid-market0.7.4 — Keyless
get_exchange_ratefalls back from the ECB table to the central bank that issues the target or source currency (USD/GBP, GBP/JPY, USD/INR now answer keyless), same as the hosted endpoint; response addsbank. Dated-table errors say a paid plan is needed. README: real response shapes, tool counts, lifetime free tier0.7.0 —
get_reference_rate(Daily Reference Rate, 16:00 London, keyless latest table) andrequest_trial_key(self-issued 100-call trial key adopted for the session)
🔗 Links
Bank Exchange Rate API — live buy and sell rates from 1,200+ commercial banks in 120+ countries · npm · GitHub
Support: support@allratestoday.com
ChatGPT app — ask ChatGPT for live and official central bank rates
OpenAPI reference on Bump.sh — also on SwaggerHub
📜 License
MIT — see LICENSE.
Available Tools
9 toolsget_bank_ratesCommercial bank buy/sell board ratesARead-onlyInspect
Retail buy and sell rates a commercial bank displays on its own website (e.g. SBI's TT buying rate, an Emirates NBD or HSBC Hong Kong board), read hourly. Use for 'what rate does bank X give for USD today?', remittance comparisons between banks in one country, or rules that name a bank's card rate (India Income-tax Rule 115 uses SBI's TT buying rate). These are bank prices, NOT official or mid-market rates: for those use get_official_rates or get_exchange_rate. Give country alone for every covered bank there, or add bank for one board; ccy narrows one bank to a currency and date returns the stored board for a past day. Covers 1,200+ commercial banks in 120+ countries (ae, lk, in, pk, bd, np, vn, id, ph, am, az, ge, kz, tw, jp, kr, hk, cn, au, cz, pl, hu, tr, eg, za, ke, us); codes are listed at https://allratestoday.com/bank-exchange-rate-api/. Requires ALLRATES_API_KEY (the free key works).
Inputs: country (required), ccy, bank, date. Returns: buy, ccy, bank, name, +10 more
get_exchange_rateGet live exchange rateARead-onlyInspect
Use this when the user asks 'what is X in Y?', 'convert X to Y', 'current rate of EUR/USD', or any single fiat-to-fiat live exchange rate question. Returns the latest mid-market rate as a JSON object like { rate: 0.9234, source } meaning 1 source = 0.9234 target. Without an API key it answers from an official central-bank table instead (ECB first, else the bank that issues one of the two currencies) and says so in note — relay the rate_date; pairs no single bank publishes (or inverts) need a key. Does NOT support cryptocurrencies, commodities, or arithmetic on amounts. For multiple targets in one call use get_rates_authenticated; for a past date or fixed lookback (7d/30d/1y) use get_historical_rates.
Inputs: source (required), target (required). Returns: bank, note, rate, source, +2 more
get_historical_ratesGet historical rate time-seriesARead-onlyInspect
Use this for fixed-window time-series questions like 'how has EUR/USD moved this week', 'show me the last month of GBP/JPY', or 'chart 1-year history of AUD/USD'. Returns { source, target, period, data: [{ date, rate, timestamp }, ...] } — sampling is fixed per period (1d=hourly, 7d/30d=daily, 1y=weekly) and the window always ends NOW. Needs an API key on a paid plan; free and trial keys get a 403. For a specific past datetime use get_rates_authenticated with time. For a single live rate use get_exchange_rate.
Inputs: source (required), target (required), period. Returns: data, period, source, target, +1 more
get_official_ratesGet a bank's official published ratesARead-onlyInspect
OFFICIAL rates a named institution published — 'what is the ECB rate for USD?', 'Bank of Japan rate today', 'HMRC rate for invoicing'. These are the fixed, citable rates for compliance, tax, customs and accounting — NOT live market rates (use get_exchange_rate for those). Omit date for the newest published table (no API key needed); give date (API key, paid plan) for the table in force that day — weekends/holidays roll back to the last published date and the response's rate_date says which. Omit source/target for the full table; give both for one pair — cross-computed inside the bank's own table when not directly published, flagged derived. Always cite the returned rate_date.
Inputs: bank (required), date, source, target. Returns: bank, rate, rates, stale, +6 more
get_rates_authenticatedGet multi-target or point-in-time ratesARead-onlyInspect
Use this for (a) one source against multiple targets in a single call ('USD vs EUR, GBP, JPY'), or (b) the rate at a specific past datetime ('EUR/USD at 2025-03-14T12:00Z'), optionally bucketed by hour/day/week/month. Returns { rates: [{ rate, source, target, time }, ...] } — one row per target × time bucket. Multi-target latest rates work on any key; a past datetime (time) needs a paid plan. For a single live pair use get_exchange_rate. For fixed lookback windows (1d/7d/30d/1y ending now) use get_historical_rates.
Inputs: source (required), target (required), time, group. Returns: rates
get_reference_rateGet the Daily Reference Rate (16:00 London)ARead-onlyInspect
AllRatesToday's once-a-day, never-revised mid-market rate: the per-currency median of samples in a five-minute window centred on 16:00 London, published each business day. Use it when the user needs ONE reproducible rate per day — index levels, return series, research datasets, month-end reports — rather than a live quote (get_exchange_rate) or an institution's official rate (get_official_rates). Omit source/target for the whole table; give both for one pair (crossed via USD, flagged derived). Omit date for the latest table (no key needed); give date (API key, paid plan) for a past business day. Not the WM/Refinitiv fix and not a registered benchmark — relay the disclaimer and the rate_date.
Inputs: date, source, target. Returns: base, rate, time, rates, +6 more
list_central_banksList covered central banks & tax authoritiesARead-onlyInspect
Call this FIRST when you need a bank code, or for 'which central banks do you cover?' / 'do you have rates from X?'. Returns every covered source — 130+ central banks and tax authorities (HMRC, US Treasury, Swiss BAZG, India CBIC, Peru SUNAT) — with code (what get_official_rates takes as bank), name, latest publication date and whether it is behind schedule. No API key needed.
Inputs: no named parameters. Returns: sources, checked_at, stale_count
list_currenciesList supported currenciesARead-onlyInspect
Call this BEFORE other tools when you are unsure whether a currency code is supported, or when the user asks 'what currencies do you support?', 'is X a valid currency?', or 'what is the symbol for X?'. Returns { currencies: [{ code: 'USD', name: 'US Dollar', symbol: '$' }, ...], count } covering 160+ ISO 4217 fiat currencies. Does NOT include cryptocurrencies. Cheap to call (cached 24h upstream) — use it to validate user input and prevent downstream errors in get_exchange_rate / get_rates_authenticated / get_historical_rates.
Inputs: no named parameters. Returns: count, currencies
request_trial_keyRequest a trial API keyAInspect
Self-issue an AllRatesToday API key with 100 lifetime calls, valid 7 days, with no account and no email. Use it when another tool answered "needs an API key" and the user wants real-time rates or history right now. The key is adopted by this server for the rest of the session and returned once — tell the user to put it in the MCP config as ALLRATES_API_KEY to keep it. Capped at 3 keys per IP per day. For a lasting key, register at https://allratestoday.com/register (free) or see https://allratestoday.com/pricing.
Inputs: agent, purpose. Returns: key, note, calls, adopted, +1 more
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 9 tools
The descriptions do heavy lifting with explicit 'use X instead' guidance, but three tools (get_exchange_rate, get_rates_authenticated, get_historical_rates) all answer 'what is the rate at/over time T' and differ mainly by cardinality, auth tier and window shape rather than by domain. The rate-concept family is even wider once get_official_rates and get_reference_rate are added, so an agent must read carefully to avoid picking a live quote when a citable official or daily-fixed rate was wanted.
Consistent snake_case verb_noun across the set: get_*_rates, list_central_banks, list_currencies, request_trial_key. The one deviation is get_rates_authenticated, where the qualifier is an auth attribute rather than a resource noun, which makes it read like a variant of the other rate tools instead of a multi-target/point-in-time operation.
Nine tools is well within a healthy scope for a rates API, and each maps to a distinct capability (live, historical, official, bank, reference, two enumerations, key issuance). Nothing appears redundant enough to drop.
Coverage is strong across the rate lifecycle: live quotes, fixed-window history, point-in-time, official/institutional, retail bank and a reproducible daily fix, plus currency and central-bank enumeration and self-service key issuance. The notable gap is that get_bank_rates needs a bank code for 1,200+ banks but there is no list_banks tool (codes are pushed to an external URL), and amount conversion is explicitly unsupported, forcing the agent to do arithmetic itself.
Maintenance
Related MCP Connectors
Live and historical FX rates (ECB via Frankfurter) — paid per call (x402/credits), 2 tools
Live FX rates, conversion, IMF PPP, and historical currency analytics.
Free, source-labeled FX rates: 10,296 pairs across 144 currencies, all update ~60s intraday.
Free, keyless real-time currency conversion and exchange rates for any currency pair.
Related MCP Servers
- AlicenseNot gradedqualityDmaintenanceReal-time currency exchange rates and crypto prices via MCP. Convert between 60+ fiat currencies and 30+ cryptocurrencies with multi-source failover. No API keys needed for upstream data.ISC
- AlicenseAqualityCmaintenanceAn MCP server for the Xe Currency Data API that brings live FX rates, historical analysis, and quant-flavored tools into AI tools, working out of the box with zero credentials via Frankfurter/ECB data.123 npm1MIT
- AlicenseAqualityCmaintenanceEnables AI coding tools to access real-time and historical currency exchange rates for 160+ currencies, sourced from Reuters/Refinitiv.434 npmMIT
- AlicenseAqualityBmaintenanceRead-only tools for published currency buy and sell quotes from more than 40 Uruguayan exchange houses and banks, rate comparisons, conversion, historical data, and economic news. Open-source TypeScript server with stdio and remote HTTP transports; no API key required.74 npm9MIT