How do I install Central Bank Rates (AllRatesToday)?

Copy the stdio config for Cursor, Claude Desktop, Claude Code, or VS Code on this page. It uses the publisher's install, not a PlugMCP proxy.

Does Central Bank Rates (AllRatesToday) need an API key?

The publisher lists these environment variables: ALLRATES_API_KEY, ALLRATES_BASE_URL.

What transport does Central Bank Rates (AllRatesToday) use?

Central Bank Rates (AllRatesToday) runs locally over stdio.

When was Central Bank Rates (AllRatesToday) last checked?

Last checked 2026-11-08. Official central-bank & tax-authority rates from 100+ sources. No API key needed to start.

Central Bank Rates (AllRatesToday) MCP server

Power your agent

Add this server

The publisher's own command. Not a PlugMCP endpoint.

Add to Cursor Add to VS Code Run on PlugMCP

Host a copy with our keys and logs.

Local command

npx -y @allratestoday/[email protected]

Credentials from the publisher

ALLRATES_API_KEY — Optional. Without it the server runs keyless: the latest published table of any source plus the source catalogue. A free key (https://allratestoday.com/register) unlocks historical dates, time series, cross-bank comparison and publication calendars.
ALLRATES_BASE_URL — Override API base URL (default: https://allratestoday.com/api).

Claude Code has no install link for a local command. Copy the command below and run it in a terminal.

shClaude Code

1ALLRATES_API_KEY=<secret> ALLRATES_BASE_URL=<value> claude mcp add com.allratestoday-central-bank-mcp -- npx -y @allratestoday/central-bank-mcp@0.3.2

Run in a terminal.

jsonClaude Desktop

1{2  "mcpServers": {3    "com.allratestoday-central-bank-mcp": {4      "command": "npx",5      "args": [6        "-y",7        "@allratestoday/[email protected]"8      ],9      "env": {10        "ALLRATES_API_KEY": "<secret>",11        "ALLRATES_BASE_URL": "<value>"12      }13    }14  }15}

claude_desktop_config.json

Local · npmPublisher installStep-by-step: add this in Claude

Remote URL or a command on your machine? How the two installs differ

Run on PlugMCP

Host a copy with our keys and logs.

A new server you create. It is not this listing's official endpoint. Use the publisher install when you want their URL and their credentials.

Launch

Server facts

Local

Transport: stdio
Version: 0.3.2

Tools

No tool list yet. Remote servers get one after the first health check.

FAQ

Questions

Central Bank Rates MCP Server — @allratestoday/central-bank-mcp

Website: https://allratestoday.com/central-bank-rates-api/ · Hosted endpoint (no install): https://allratestoday.com/api/mcp · Docs: https://allratestoday.com/mcp/

Give your AI assistant the official exchange rates that compliance, tax, and accounting actually require. A Model Context Protocol server that lets Claude Code, Cursor, Claude Desktop, Windsurf, and any MCP-compatible client fetch published central-bank and tax-authority rates from 122 central banks and 4 tax authorities — ECB, Fed, Bank of Japan, HMRC, US Treasury, and more — via the AllRatesToday API.

After installation, your assistant can answer questions like:

"What is the ECB's official USD/EUR rate today?"
"What HMRC rate should I use for this March invoice?"
"Show me the Bank of Japan's official rate for every day of Q1."
"Compare the official USD/LKR rate across every central bank that publishes one."

⚖️ Official rates vs mid-market rates

Everything this server returns is an official published rate: fixed once the institution publishes it, carrying that institution's own publication date — the number tax authorities, auditors, and customs require. It is not the live market rate. For live mid-market rates (price display, conversion, anything that should track the market), use the companion server @allratestoday/mcp-server. The two can diverge by several percent — pick by use case. Methodology: allratestoday.com/official-rates-methodology.

🚀 Why this server?

🏛️ 122 central banks and 4 tax authorities — central banks (ECB, Fed, BOJ, SNB, RBI, …) plus tax authorities (HMRC, US Treasury, …), each served from its own published tables
📅 Point-in-time correctness — ask for any date; weekends and holidays roll back to the rate legally in force, and the response tells you which publication date applied
📊 Cross-bank comparison — one call returns every institution's rate for a pair, with min/max/median and spread stats
🧮 Honest derivations — with an API key, pairs a bank doesn't publish directly are cross-computed only within that bank's own table and flagged derived; banks are never mixed. Keyless serves only published pairs and their inverses
🔓 Works with no API key — installs and answers out of the box; the latest published table of every source is open
🧰 Six focused tools — small surface, easy for the model to use correctly
🔌 Works everywhere MCP does — stdio transport, MCP 1.x; Claude Code, Cursor, Claude Desktop, Windsurf, or any generic host

🔑 Get your API key (free)

A free key adds cross-bank comparison, cross-computed pairs and publication calendars — 300 lifetime calls, no credit card required. Dated (historical) tables and time series need a paid plan: free and trial keys get a 403 for them.

Register at allratestoday.com/register — 30 seconds
Verify your email
Copy your key from the dashboard (format: art_live_xxxxx)
Use it as ALLRATES_API_KEY in the configs below

Without one the server prints a short summary of keyless mode (below) on stderr and keeps running — it never exits, because an MCP server that exits breaks the host client's whole configuration.

🔓 Keyless mode — what works with no setup

Install it with no configuration at all and it starts, connects, and answers:

Tool	Keyless	What you get
`list_central_banks`	✅	Every covered institution (122 central banks, 4 tax authorities and the composite), from a catalogue bundled with the package (no coverage dates).
`get_official_rates`	✅	The latest published table of any source, or one published pair (or its inverse) from it, with the publisher's own `rate_date`. Cross pairs need a key.
`get_official_rates` with a `date`	🔑	One sentence explaining that dated tables need a paid plan.
`get_official_rate_history`	🔑	Same (paid plan).
`compare_official_rates`	🔑	One sentence explaining how to get a free key.
`get_publication_calendar`	🔑	Same.
`request_trial_key`	✅	Self-issues a 100-call, 7-day key with no account and adopts it for the session.

The keyless path reads the open, edge-cached /api/open/central-bank/{bank} endpoint (the exact attribution wording also ships in each response's attribution field).

Attribution. Keyless use requires a visible, followable link to AllRatesToday wherever the rates are shown (a footer, an about page, a README). With an API key it is appreciated but not required.

<a href="https://allratestoday.com">Exchange rates by AllRatesToday</a>

Markdown: Exchange rates by [AllRatesToday](https://allratestoday.com). Full wording: https://allratestoday.com/terms/#attribution.

🧩 Easiest install: the Claude Code plugin

If you use Claude Code, install the plugin instead of configuring this server by hand — it bundles both AllRatesToday MCP servers, two skills, and five slash commands (/rate, /convert, /official-rate, /fx-history, /add-currency-support):

/plugin marketplace add AllRates-Today/claude-code-plugin
/plugin install allratestoday@allratestoday

Everything below still applies for other MCP clients.

☁️ Hosted endpoint — nothing to install

The same six tools also run as a hosted Streamable HTTP MCP server, together with the five tools of the sibling AllRatesToday server — eleven in total on the hosted endpoint (this npm package itself exposes six). Paste the URL into any client that supports remote MCP — Claude.ai and Claude Desktop connectors, ChatGPT, Cursor, VS Code, Codex, Gemini CLI:

https://allratestoday.com/api/mcp

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

Works keyless. With a key, send Authorization: Bearer art_live_… or, where the client only takes a URL, connect to https://allratestoday.com/api/mcp?api_key=art_live_…. Registry name: com.allratestoday/mcp. One-click Cursor / VS Code buttons: https://allratestoday.com/mcp/#hosted

📦 Installation

# Run without installing (recommended)
npx -y @allratestoday/central-bank-mcp

# Or install globally
npm install -g @allratestoday/central-bank-mcp
central-bank-mcp

Both commands launch the stdio MCP server and wait for a client to connect — your MCP client launches them as a subprocess.

🏁 Quick setup per client

Claude Code

claude mcp add central-bank-rates -- npx -y @allratestoday/central-bank-mcp
claude mcp env central-bank-rates ALLRATES_API_KEY=art_live_xxxxx

Restart Claude Code. Verify by asking: "Which central banks can you fetch official rates from?"

Cursor

Edit ~/.cursor/mcp.json (or .cursor/mcp.json inside your project):

{
  "mcpServers": {
    "central-bank-rates": {
      "command": "npx",
      "args": ["-y", "@allratestoday/central-bank-mcp"],
      "env": {
        "ALLRATES_API_KEY": "art_live_xxxxx"
      }
    }
  }
}

Claude Desktop

Edit claude_desktop_config.json (Settings → Developer → Edit Config) and add the same mcpServers block as the Cursor example above, then restart Claude Desktop.

🧰 Tools

Tool	What it does	Plan
`list_central_banks`	All covered institutions with codes, metadata, latest date	Free (keyless: bundled catalogue)
`get_official_rates`	A bank's published table (or one pair), latest or for a given date	Keyless (latest) / Paid (dated)
`get_official_rate_history`	Date-by-date official series for one pair	Paid, billed ~1 call per month covered
`compare_official_rates`	One pair across every bank, with spread stats	Free (key required)
`get_publication_calendar`	Dates a bank actually published (no values)	Free (key required)
`request_trial_key`	Self-issue a 100-call, 7-day trial key (no account) and use it for the rest of the session	Keyless, 3 per IP per day

🔒 Privacy

Only the request parameters and your API key ever reach allratestoday.com — never conversation context.

📚 More from AllRatesToday

Central bank REST API docs
Per-bank npm SDKs
@allratestoday/mcp-server — live mid-market rates MCP server
Open data archive — the same published tables mirrored daily: Hugging Face · Kaggle (CC BY-NC 4.0)

Central Bank Rates (AllRatesToday)

Add this server

Host a copy with our keys and logs.

Server facts

Tools

Questions

How do I install Central Bank Rates (AllRatesToday)?

Does Central Bank Rates (AllRatesToday) need an API key?

What transport does Central Bank Rates (AllRatesToday) use?

When was Central Bank Rates (AllRatesToday) last checked?

Documentation

Central Bank Rates MCP Server — @allratestoday/central-bank-mcp

⚖️ Official rates vs mid-market rates

🚀 Why this server?

🔑 Get your API key (free)

🔓 Keyless mode — what works with no setup

🧩 Easiest install: the Claude Code plugin

☁️ Hosted endpoint — nothing to install

📦 Installation

🏁 Quick setup per client

Claude Code

Cursor

Claude Desktop

🧰 Tools

🔒 Privacy

📚 More from AllRatesToday

🔗 Links

License