Get a bank's official published rates
get_official_ratesFetch official central bank and tax authority exchange rates for compliance, invoicing, and accounting, with optional date-specific lookup.
Instructions
Use this for OFFICIAL rates a specific institution published — 'what is the ECB rate for USD?', 'Bank of Japan official rate on 2026-03-14', 'HMRC rate for invoicing'. These are the fixed rates in force for compliance, tax, customs, and accounting — NOT live market rates. Omit date for the newest published table; give date (paid plans) for the table in force on that day (weekends/holidays roll back to the last published date — the response's rate_date says which). Omit source/target for the bank's full table { rates: [{ base, quote, type, value }] }; give both for one pair — with an API key, pairs not directly published are cross-computed via the bank's own home currency and flagged derived; keyless serves only published pairs and their inverses. For live mid-market rates use the @allratestoday/mcp-server package instead.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"bank": "<bank>"
},
"name": "get_official_rates"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bank | Yes | Bank/authority code as returned by list_central_banks (lowercase, e.g. 'ecb', 'fed', 'boj', 'hmrc', 'cbsl'). Call list_central_banks first if unsure — codes are short abbreviations of the institution, not country codes. | |
| date | No | Optional YYYY-MM-DD. Omit for the latest published table (all plans). A specific date requires a paid plan. | |
| source | No | Optional. With target, narrows to one pair. | |
| target | No | Optional. With source, narrows to one pair. |