# Central Bank Rates (AllRatesToday)

An MCP server that hands your agent official central-bank and tax-authority rates. Useful when you need a rate with its publication date, not a market quote.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 1
- Author: AllRates-Today
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/AllRates-Today/central-bank-mcp
- Updated: 2026-10-23
- HTML: https://affpapa.org/en/nevibecode/mcp/central-bank-rates-allratestoday

## What it does

The server talks to the AllRatesToday API and exposes six tools. An agent can pull the latest published table from any source, a single pair out of it, history, a cross-bank comparison, and the publication calendar. Every figure is an official published rate: it is fixed when the institution publishes it and carries that publication date, which is what reporting and compliance work needs.

Without a key the server still starts and answers. The institution list and the latest table of any source are open. Cross-bank comparison, dated tables and the calendar need a key. A free key covers comparison and cross-computed pairs; dated tables and time series sit behind a paid plan, and a free or trial key gets a 403 on those. The key goes into `ALLRATES_API_KEY`. Keyless use requires a visible link to AllRatesToday wherever the rates appear.

These are official rates, not market rates. For live mid-market figures there is a separate server, `@allratestoday/mcp-server`; the two can differ by several percent, so pick by use case. A hosted option exists too: the same tools run at `https://allratestoday.com/api/mcp` with nothing to install.

## Requirements
- Needs: Node.js (commands run via npx)
- Environment variables: `ALLRATES_API_KEY`, `ALLRATES_BASE_URL` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add --env ALLRATES_API_KEY=<ALLRATES_API_KEY> --env ALLRATES_BASE_URL=<ALLRATES_BASE_URL> --transport stdio central-bank-rates-allratestoday -- npx -y @allratestoday/central-bank-mcp
```
Replace <…> with your own values

### Codex

**Platform CLI**
```bash
codex mcp add central-bank-rates-allratestoday --env ALLRATES_API_KEY=<ALLRATES_API_KEY> --env ALLRATES_BASE_URL=<ALLRATES_BASE_URL> -- npx -y @allratestoday/central-bank-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "central-bank-rates-allratestoday": {
            "command": "npx",
            "args": [
                "-y",
                "@allratestoday/central-bank-mcp"
            ],
            "env": {
                "ALLRATES_API_KEY": "<ALLRATES_API_KEY>",
                "ALLRATES_BASE_URL": "<ALLRATES_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "central-bank-rates-allratestoday": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@allratestoday/central-bank-mcp"
            ],
            "env": {
                "ALLRATES_API_KEY": "<ALLRATES_API_KEY>",
                "ALLRATES_BASE_URL": "<ALLRATES_BASE_URL>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e ALLRATES_API_KEY=<ALLRATES_API_KEY> -e ALLRATES_BASE_URL=<ALLRATES_BASE_URL> central-bank-rates-allratestoday npx -y @allratestoday/central-bank-mcp
```
Replace <…> with your own values

## When to use it
- look up the ECB official rate for a given date
- put the HMRC rate into a March invoice
- compare one currency pair across several central banks
- pull a quarter of published rate history
- check which publication date applied over a weekend

## Example prompts
- What is the ECB official USD/EUR rate today?
- List the Bank of Japan rate for each day of Q1

## Similar
- [macro-rates-monitor](https://affpapa.org/en/nevibecode/skills/macro-rates-monitor.md) — skill · 2300 installs
- [llmquant-rates-fx](https://affpapa.org/en/nevibecode/skills/llmquant-rates-fx.md) — skill · 471 installs
- [Banco Central do Brasil (BCB) — SGS Time Series MCP Server](https://affpapa.org/en/nevibecode/mcp/banco-central-do-brasil-bcb-sgs-time-series-mcp-server.md) — MCP server · ★ 10
- [T-Bank MCP](https://affpapa.org/en/nevibecode/mcp/t-bank-mcp.md) — MCP server · ★ 38
- [Cambio Uruguay](https://affpapa.org/en/nevibecode/mcp/cambio-uruguay.md) — MCP server · ★ 8
- [Currency Exchange](https://affpapa.org/en/nevibecode/mcp/currency-exchange.md) — MCP server · ★ 1

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md