AllRatesToday MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ALLRATES_API_KEY | No | Your AllRatesToday API key. Required for `get_rates_authenticated`. | |
| ALLRATES_BASE_URL | No | Override for self-hosted or staging environments. | https://allratestoday.com/api |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_exchange_rateA | 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 |
| get_historical_ratesA | 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 |
| get_rates_authenticatedA | 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 ( |
| list_currenciesA | 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. |
| list_central_banksA | 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 |
| get_official_ratesA | 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 |
| get_reference_rateA | 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 |
| get_bank_ratesA | 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 |
| request_trial_keyA | 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. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
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.