IBANforge

MCP-Integration

IBANforge liefert einen offiziellen MCP-Server für KI-Agenten: ibanforge-mcp auf npm, plus einen gehosteten Endpoint ganz ohne Installation. Claude, Cursor oder jeder MCP-kompatible Client kann IBANs validieren, BICs auflösen, Schweizer Clearing-Nummern prüfen und eine Compliance-Vorprüfung als Tool-Aufrufe ausführen.

Was ist MCP?

Das Model Context Protocol ist ein offener Standard, der KI-Assistenten die Nutzung externer Tools erlaubt. Statt den Nutzer API-Ergebnisse kopieren zu lassen, ruft der Agent das Tool direkt auf und erhält strukturierte Daten zurück.

Option 1 — das npm-Paket (stdio)

Claude Desktop — IBANforge in die Konfigurationsdatei eintragen:

macOS: ~/Library/Application Support/Claude/claude_desktop_config.json

Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "ibanforge": {
      "command": "npx",
      "args": ["-y", "ibanforge-mcp"],
      "env": { "IBANFORGE_API_KEY": "ifk_ihr_schluessel" }
    }
  }
}

Claude Code — ein einziger Befehl:

claude mcp add ibanforge -e IBANFORGE_API_KEY=ifk_ihr_schluessel -- npx -y ibanforge-mcp

Der Schlüssel ist optional und kostenlos: hier erstellen mit einer E-Mail-Adresse (200 Anfragen/Monat, ohne Karte). Ohne Schlüssel startet der Server trotzdem, und kostenpflichtige Tools antworten mit x402-Zahlungsanweisungen, die ein Agent mit USDC auf Base pro Aufruf begleichen kann.

Nach dem Speichern den Client neu starten. Fünf IBANforge-Tools erscheinen im Tool-Menü.

Option 2 — der gehostete Endpoint (nichts zu installieren)

https://api.ibanforge.com/mcp

Streamable-HTTP-Transport, 10 kostenlose Tool-Aufrufe pro IP und Tag, ganz ohne Schlüssel: der schnellste Weg für einen Agenten, die Daten zu prüfen, bevor Sie sich festlegen. Für dauerhafte Nutzung das npm-Paket mit dem kostenlosen Schlüssel betreiben.

Im offiziellen MCP-Registry ist der Server als io.github.cammac-creator/ibanforge gelistet.

Die fünf Tools

validate_iban

Validiert eine einzelne IBAN: Struktur und Prüfziffer, ausgebende Bank (BIC), Bankcode-Prüfung gegen das Nationalregister, EMI/vIBAN-Klassifikation, SEPA/VoP-Erreichbarkeit und Risikoindikatoren — dieselben Daten wie POST /v1/iban/validate.

{ "iban": "CH1000230000000012345" }

batch_validate_iban

Bis zu 100 IBANs in einem Aufruf, jedes Ergebnis strukturgleich zu validate_iban — wie POST /v1/iban/batch.

{ "ibans": ["CH1000230000000012345", "DE89370400440532013000"] }

lookup_bic

Institutsdetails zu einem BIC/SWIFT-Code: Name, Land, Stadt, Filiale, LEI wo vorhanden — wie GET /v1/bic/:code.

{ "code": "UBSWCHZH80A" }

lookup_ch_clearing

Schweizer BC-Nummer / IID nachschlagen: Institut, Typ, Ort, SIC/euroSIC-Teilnahme und QR-IID-Zuteilung — wie GET /v1/ch/clearing/:iid.

{ "iid": "230" }

check_compliance

Vollständige Vorprüfung in einem Aufruf: Sanktionsprüfung auf dem aufgelösten Bank-BIC, FATF-Status, SEPA-Instant-Erreichbarkeit, VoP-Teilnahme und ein zusammengesetzter Risikoscore von 0 bis 100 — wie POST /v1/iban/compliance.

{ "iban": "CH1000230000000012345" }

Ergebnisse, die sagen, was als Nächstes zu tun ist

Jedes Validierungsergebnis trägt ein geordnetes Feld next_steps: Was eine Zahlung blockiert, kommt zuerst, was sie nur anreichert, danach. Jeder Eintrag hat einen stabilen code zum Verzweigen, einen do-Satz, den der Agent weitergeben kann, und ein because, das das Antwortfeld nennt, aus dem der Rat entstand — der Rat ist prüfbar statt geglaubt. bank_code_not_allocated heißt Stopp; verify_payee_name heißt weitermachen und eine Empfängernamen-Prüfung entscheiden lassen.

Beispielkonversation mit einem Agenten

Sie: Ist diese IBAN gültig? CH10 0023 0000 0000 1234 5

Claude: Ich validiere die IBAN. [ruft validate_iban auf]

Ja, die IBAN ist gültig — und der Bankcode ist im SIX-Register bestätigt: UBS Switzerland AG in Zürich, BIC UBSWCHZH, BC-Nummer 00230, SIC-Teilnehmer mit CHF-Echtzeitzahlungen.

Sie: Kannst du diese 3 IBANs aus der Lieferantenrechnung prüfen?

Claude: Ich validiere alle drei auf einmal. [ruft batch_validate_iban auf]

2 von 3 sind gültig. Die dritte (FR76...) hat einen Prüfziffernfehler — vermutlich wurden zwei Ziffern vertauscht.

Funktioniert gut mit

PayQR — npx -y @czagents/payqr, gehostetes MCP https://payqr.cz-agents.dev/mcp, Registry dev.cz-agents/payqr. Erzeugt und prüft selbst einen europäischen Zahlungs-QR aus einer IBAN und den Zahlungsdetails: SPAYD für CZ/SK-Konten, EPC/GiroCode (nur EUR) für andere SEPA-Konten; EPC verlangt recipient_name. PayQR validiert die IBAN-Prüfziffer, verifiziert aber weder Kontoinhaberschaft noch Empfängernamen und erzeugt keine nativen Schweizer QR-Rechnungen — Registerprüfung, VoP-Bereitschaft und Risikoindikatoren sind genau das, was IBANforge obendrauf liefert.

Unterstützte Clients

  • Claude Desktop und Claude Code — natives MCP
  • Cursor und Continue.dev — über deren MCP-Konfiguration
  • n8n — besser den dedizierten Community-Node nutzen
  • Eigene Agenten — jede App mit dem MCP SDK

Hinweise

  • Das npm-Paket ist ein schlanker Client für api.ibanforge.com: Die Daten leben serverseitig, nichts herunterzuladen, und Ergebnisse spiegeln stets die letzte Registeraktualisierung.
  • Alle fünf Tools liefern dasselbe JSON wie die REST-API, als Text und als MCP-structuredContent.
  • Releases erscheinen auf npm und werden ins MCP-Registry gespiegelt.

Siehe auch: Rezepte · Was „verified" bedeutet · Datenquellen