# AllRatesToday exchange rates (hosted) [Health: Active]

**Category:** 💰 Finance & Fintech  
**Repository:** https://github.com/AllRates-Today/mcp-server  
**GitHub Stars:** 4  
**npm Downloads (last month):** 3154  
**Views:** 1  
**Installs:** 0  
**Upvotes:** 0  
**Directory Page:** https://allmcps.com/mcp/allratestoday-exchange-rates-hosted

## Description
Live FX + official central-bank rates, 110+ sources. Hosted, keyless, nothing to install.

## Tools
Capabilities this server exposes over MCP:

- **get_exchange_rate** — 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_rates** — 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_authenticated** — 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_currencies** — 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_banks** — 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 — 121 central banks plus 3 tax authorities (HMRC, US Treasury, Swiss BAZG) — 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_rates** — 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_rate** — 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`.
- **request_trial_key** — 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.

## Claude Desktop Quick Installation
Install path detected from listing signals. Uses `npx` (confidence: high):

```json
"mcpServers": {
  "allratestoday-exchange-rates-hosted": {
    "command": "npx",
    "args": ["-y","@allratestoday/mcp-server"]
  }
}
```

## Documentation

## What AllRatesToday exchange rates (hosted) MCP server does

AllRatesToday exchange rates (hosted) exposes foreign-exchange data through the hosted MCP endpoint at `https://allratestoday.com/api/mcp`. It is intended for MCP-compatible applications that need fiat currency information without running a local process. The service covers more than 160 ISO 4217 currencies and distinguishes between several kinds of rates:

- Live mid-market rates for market-oriented quotes and conversions.
- Official rates published by named central banks or tax authorities.
- A once-daily reference rate designed for reproducible reporting and research.
- Historical series over fixed periods or rates at specified past times.

The response identifies relevant dates and, where applicable, whether a value was derived or came from an official table. Applications displaying keyless rates must include a visible, followable AllRatesToday attribution link.

## How it works

Add the hosted URL to an MCP client that supports remote MCP. The endpoint works without an API key for currency discovery, institution discovery, latest official tables, the latest reference table, and eligible central-bank-based lookups. It also offers a trial-key tool that issues a key limited to 100 calls over seven days; the key is adopted for the current session and can then be placed in client configuration.

With a key, live mid-market tools can query a broader set of currency pairs, compare one source against several targets, and request historical or point-in-time data according to the account plan. When a client supports authorization headers, send the key as a bearer token. A URL query parameter is available for clients that only accept credentials in the endpoint URL, but that form can expose the key through configuration files, logs, or screenshots.

The hosted endpoint is a Streamable HTTP MCP service. The package also has a separate stdio form, which clients launch as a subprocess through `npx` or a global npm installation.

## Setup and configuration

Use the following endpoint in a remote-MCP client:

```text
https://allratestoday.com/api/mcp
```

Claude Code can add it with:

```bash
claude mcp add --transport http allratestoday https://allratestoday.com/api/mcp
```

For authenticated access, configure `ALLRATES_API_KEY` where the client supports environment variables, or pass `Authorization: Bearer <key>`. Registering at AllRatesToday provides a lasting key; the server also supports the in-session trial-key flow.

## Tools and capabilities

The core exchange-rate tools include:

- `get_exchange_rate` for one current fiat pair.
- `get_historical_rates` for 1-day, 7-day, 30-day, or 1-year windows ending now, with period-specific sampling.
- `get_rates_authenticated` for multiple targets or a specified historical time and bucket.
- `list_currencies` for supported codes, names, and symbols.
- `list_central_banks` for institution codes and publication metadata.
- `get_official_rates` for the latest or dated table from a named institution.
- `get_reference_rate` for the daily, never-revised reference table.
- `request_trial_key` for a temporary API key.

The hosted service also lists additional central-bank functions from the related server, including official-rate history, rate comparisons, and publication-calendar access.

## Limitations and notes

This service handles fiat currencies; it does not provide cryptocurrency or commodity rates. `get_exchange_rate` does not perform arithmetic on user-supplied amounts. Keyless exchange-rate results may be official central-bank values rather than live market quotes, and some currency crosses are unavailable without a key. Historical series, point-in-time lookups, and dated official or reference tables require a paid plan. Always relay the returned `rate_date`, and choose official or reference data when compliance, accounting, or reproducibility matters instead of treating a live mid-market quote as an official rate.

_Full upstream README: https://allmcps.com/mcp/allratestoday-exchange-rates-hosted/readme_