Skip to main content
Glama
AllRatesToday MCP Server

AllRatesToday MCP Server

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ALLRATES_API_KEYNoYour AllRatesToday API key. Required for `get_rates_authenticated`.
ALLRATES_BASE_URLNoOverride 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

CapabilityDetails
tools
{
  "listChanged": true
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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 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.

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 time. For a single live rate use get_exchange_rate.

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 (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.

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 code (what get_official_rates takes as bank), name, latest publication date and whether it is behind schedule. No API key needed.

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 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.

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 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.

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 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).

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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

A4.4/5.0

Scored across 9 tools

Disambiguation3/5

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.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness4/5

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

ActivityActive
ResponsivenessNo recent community issues