Skip to main content
Glama
Central Bank Rates MCP Server

Central Bank Rates MCP Server

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

npm version npm downloads license MCP TypeScript

Geben Sie Ihrem KI-Assistenten die offiziellen Wechselkurse, die Compliance, Steuer und Buchhaltung tatsächlich benötigen. Ein Model-Context-Protocol-Server, der Claude Code, Cursor, Claude Desktop, Windsurf und jeden MCP-kompatiblen Client in die Lage versetzt, veröffentlichte Zentralbank- und Steuerbehördenkurse von über 60 Institutionen abzurufen — EZB, Fed, Bank of Japan, HMRC, US-Finanzministerium und mehr — über die AllRatesToday-API.

Nach der Installation kann Ihr Assistent Fragen beantworten wie:

  • „Wie lautet der offizielle USD/EUR-Kurs der EZB heute?"

  • „Welchen HMRC-Kurs soll ich für diese März-Rechnung verwenden?"

  • „Zeig mir den offiziellen Kurs der Bank of Japan für jeden Tag des ersten Quartals."

  • „Vergleiche den offiziellen USD/LKR-Kurs über alle Zentralbanken, die einen veröffentlichen."

⚖️ Offizielle Kurse vs. Mittelkurse

Alles, was dieser Server zurückgibt, ist ein offiziell veröffentlichter Kurs: festgelegt, sobald die Institution ihn veröffentlicht, mit dem eigenen Veröffentlichungsdatum der Institution — die Zahl, die Steuerbehörden, Wirtschaftsprüfer und Zoll benötigen. Es ist nicht der Live-Marktkurs. Für Live-Mittelkurse (Preisanzeige, Umrechnung, alles, was dem Markt folgen soll), verwenden Sie den Begleitserver @allratestoday/mcp-server. Die beiden können um mehrere Prozent voneinander abweichen — wählen Sie je nach Anwendungsfall. Methodik: allratestoday.com/official-rates-methodology.

Related MCP server: plinth-fx-mcp

🚀 Warum dieser Server?

  • 🏛️ Über 60 offizielle Quellen — Zentralbanken (EZB, Fed, BOJ, SNB, RBI, …) plus Steuerbehörden (HMRC, US-Finanzministerium, …), jede aus ihren eigenen veröffentlichten Tabellen

  • 📅 Stichtagsgenauigkeit — fragen Sie nach einem beliebigen Datum; Wochenenden und Feiertage werden auf den rechtlich gültigen Kurs zurückgesetzt, und die Antwort teilt Ihnen mit, welches Veröffentlichungsdatum angewendet wurde

  • 📊 Bankenübergreifender Vergleich — ein einziger Aufruf liefert den Kurs jeder Institution für ein Währungspaar, mit Min/Max/Median und Spread-Statistiken

  • 🧮 Ehrliche Ableitungen — Paare, die eine Bank nicht direkt veröffentlicht, werden nur innerhalb der eigenen Tabelle dieser Bank kreuzberechnet und als derived gekennzeichnet; Banken werden niemals vermischt

  • 🧰 Fünf fokussierte Tools — kleine Oberfläche, leicht für das Modell korrekt zu verwenden

  • 🔌 Funktioniert überall, wo MCP funktioniert — stdio-Transport, MCP 1.x; Claude Code, Cursor, Claude Desktop, Windsurf oder jeder generische Host

🔑 Holen Sie sich Ihren API-Schlüssel

Der Server startet nicht ohne einen gültigen ALLRATES_API_KEY. Ein kostenloser Schlüssel deckt die neuesten veröffentlichten Tabellen ab — keine Kreditkarte erforderlich. Datierte Tabellen und Verlauf benötigen einen kostenpflichtigen Plan.

  1. Registrieren Sie sich unter allratestoday.com/register — 30 Sekunden

  2. Bestätigen Sie Ihre E-Mail-Adresse

  3. Kopieren Sie Ihren Schlüssel aus dem Dashboard (Format: art_live_xxxxx)

  4. Verwenden Sie ihn als ALLRATES_API_KEY in den folgenden Konfigurationen

📦 Installation

# Run without installing (recommended)
npx -y @allratestoday/central-bank-mcp
# Or install globally
npm install -g @allratestoday/central-bank-mcp
central-bank-mcp

Beide Befehle starten den stdio-MCP-Server und warten auf eine Client-Verbindung — Ihr MCP-Client startet sie als Unterprozess.

🏁 Schnellstart pro 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

Starten Sie Claude Code neu. Überprüfen Sie, indem Sie fragen: „Welche Zentralbanken können Sie abrufen?"

Cursor

Bearbeiten Sie ~/.cursor/mcp.json (oder .cursor/mcp.json in Ihrem Projekt):

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

Claude Desktop

Bearbeiten Sie claude_desktop_config.json (Einstellungen → Entwickler → Konfiguration bearbeiten) und fügen Sie denselben mcpServers-Block wie im Cursor-Beispiel oben hinzu, und starten Sie dann Claude Desktop neu.

🧰 Werkzeuge

Werkzeug

Funktion

Plan

get_central_banks

Alle abgedeckten Institutionen mit Codes, Metadaten, neuestem Datum

Kostenlos

get_official_rates

Veröffentlichte Tabelle (oder ein Paar), aktuell oder für ein Datum

Kostenlos (aktuell) / Bezahlt (datumsgenau)

get_rate_history

Datumsgenaue offizielle Serie für ein Paar

Bezahlt (~1 Aufruf pro Monat)

compare_rates_across_banks

Ein Paar über alle Banken, mit Verteilung

Kostenlos

get_publication_calendar

Veröffentlichungskalender (Daten ohne Kurse)

Kostenlos

🔒 Datenschutz

Nur die Anfrageparameter und Ihr API-Schlüssel erreichen jemals allratestoday.com — niemals Gesprächskontext.

📚 Mehr von AllRatesToday

Lizenz

MIT © AllRatesToday

Available Tools

6 tools
compare_official_ratesCompare one pair across every bankA
Read-only

Use this when the user wants one currency pair across ALL institutions at once — 'what does each central bank say USD/EUR is?', 'spread between official USD/LKR rates', 'which bank has the highest official rate for X?'. One call returns every covered bank's latest official rate for the pair plus spread stats { min, max, median, spread_bps } over fresh sources (stale quarterly publishers are returned but excluded from stats). Rates a bank doesn't publish directly are cross-computed within that bank's own table only — banks are never mixed. Methodology: https://allratestoday.com/official-rates-methodology/

Inputs: source (required), target (required).

get_official_rate_historyGet a bank's official rate historyA
Read-only

Use this for a date-by-date series of one bank's OFFICIAL rates — 'ECB USD rate for every day of 2025', 'how did the CBSL official rate move last quarter'. Returns one row per published date: { series: [{ date, rate, rate_type, derived, method }] }. Give either symbol (matches either side of the pair vs the bank's home currency) or a source+target pair. Defaults to the last year when from/to omitted. Paid plans only, and BILLED BY VOLUME: one API call per month of history covered (a year-long series costs ~12 calls) — keep ranges as narrow as the question needs. For publication dates without values (free) use get_publication_calendar.

Inputs: bank (required), to, from, source, +2 more.

get_official_ratesGet a bank's official published ratesA
Read-only

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.

Inputs: bank (required), date, source, target.

get_publication_calendarGet a bank's publication calendarA
Read-only

Use this to see WHICH dates a bank actually published a rate table — 'did the ECB publish on 2026-01-01?', 'how often does the US Treasury publish?'. Returns dates only, no rate values, so it is available on every plan (unlike history). Gaps reveal weekends, holidays, and weekly/quarterly publication cadence. Give ?year=YYYY or a from/to range; large ranges are capped and flagged truncated.

Inputs: bank (required), to, from, year.

list_central_banksList covered central banks & tax authoritiesA
Read-only

Call this FIRST when you need a bank code, or when the user asks 'which central banks do you cover?' or 'do you have rates from X?'. Returns { banks: [{ code, name, country, home_ccy, rate_types, latest date, ... }], disclaimer } for 130+ central banks and tax authorities (plus a composite) — central banks (ECB, Fed, BOJ, ...) plus tax authorities (HMRC, US Treasury, ...). The code field is what every other tool takes as its bank parameter. Cheap to call.

Inputs: no named parameters.

request_trial_keyRequest a trial API 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 a dated central-bank table, a history series, a cross-bank comparison or a publication calendar 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.

Inputs: agent, purpose. Returns: key, note, calls, adopted, +1 more

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.6/5.0

    Scored across 6 tools

    Disambiguation5/5

    Each tool has a clearly distinct axis: enumerating banks, fetching a bank's official table, fetching a per-date series, comparing across banks for one pair, and listing publication dates only. The descriptions explicitly disambiguate the riskiest overlaps (get_official_rates vs compare_official_rates, history vs calendar) and even steer users to a different package for live market rates.

    Naming Consistency5/5

    All names follow a strict snake_case verb_noun pattern (list_central_banks, get_official_rates, get_official_rate_history, compare_official_rates, get_publication_calendar, request_trial_key). The single auth-related tool still fits the same convention, so there is no style drift.

    Tool Count5/5

    Six tools is tight and well-scoped for a rates data server: one discovery tool, three rate-query tools at different granularity, one comparison aggregator, and one key-bootstrap tool. Nothing looks redundant or padded.

    Completeness4/5

    The core lifecycle is covered: discover banks, get latest/dated official tables, get history series, cross-bank comparison, and publication cadence, plus a way to obtain a key. Minor gaps remain — no tool to inspect key status/quota usage, no explicit currency-conversion or bulk multi-pair fetch, so an agent hitting billing limits must infer state from errors.

    Maintenance

    ActivityNo data
    ResponsivenessOutdated data

    Related MCP Connectors

    Related MCP Servers

    • A
      license
      Not graded
      quality
      D
      maintenance
      Real-time currency exchange rates and crypto prices via MCP. Convert between 60+ fiat currencies and 30+ cryptocurrencies with multi-source failover. No API keys needed for upstream data.
      ISC
    • -
      license
      Not graded
      quality
      Not graded
      maintenance
      MCP server that provides real exchange-rate data from the European Central Bank, including latest rates, currency conversion, historical rates, and time series.
      -