Zum Inhalt springen
IBANforge
Für KI-Agenten

Für autonome Agenten gebaut.

Prüfen Sie eine IBAN aus Ihrem Agenten: Format, erkannte Bank, verfügbare Quellen und Daten. Starten Sie mit Remote MCP ohne Installation und wählen Sie danach einen wiederverwendbaren Schlüssel oder einen Zahlungsclient.

Drei Wege für einen Agenten, IBANforge zu nutzen

Weg 1 · MCP

Nativer MCP-Server

11 Tools auf dem entfernten HTTP-Server, 13 im installierten npm-Paket. Die zwei zusätzlichen Tools analysieren eine Kreditorendatei und verfolgen ihren Bericht.

Stdio oder HTTP · npm oder Remote

Weg 2 · Kostenloser Schlüssel

Kostenloser API-Schlüssel

POSTen Sie ganz ohne Body und erhalten Sie einen Schlüssel mit 25 Aufrufen pro Monat auf allen Endpunkten. Keine E-Mail, keine Verifizierung, kein Captcha. POST /v1/keys/claim mit einem Postfach, das Sie lesen können, hebt denselben Schlüssel auf 200 pro Monat. Ideal für Prototypen oder Agenten mit geringem Volumen.

Header: Authorization: Bearer ifk_…

Weg 3 · x402

Pay-per-call x402

Nutzen Sie ein Wallet auf Base L2, der Agent zahlt USDC autonom. Keine Anmeldung, kein Kontingent. Ideal für hohes Volumen und reibungslose Integrationen.

USDC auf Base · Coinbase CDP Facilitator

Weg 1 · MCP

In Claude Desktop, Cursor oder Cline installieren

11 Tools auf dem entfernten HTTP-Server, 13 im installierten npm-Paket. Die zwei zusätzlichen Tools analysieren eine Kreditorendatei und verfolgen ihren Bericht.

Agent ohne Installation verbinden

Fügen Sie diesen HTTP-Server in einem Client mit Remote-MCP-Unterstützung hinzu. Für den Test benötigen Sie weder Wallet noch Schlüssel.

URL des entfernten MCP-Servers

text
https://api.ibanforge.com/mcp
  1. Fügen Sie diese URL als entfernten MCP-Server in Ihrem Client hinzu.
  2. Fragen Sie: „Prüfe die Dokumentations-IBAN DE89370400440532013000 und nenne Registerergebnis, Quelle und Datum.“
  3. Lesen Sie bank_code_check und die Quellen. unknown bestätigt nichts; die Prüfung belegt weder die Existenz des Kontos noch dessen Inhaber.

10 Tool-Einheiten pro Netzwerkadresse und Tag ohne Schlüssel; jede IBAN eines Batches zählt als Einheit. Ein API-Schlüssel erhöht dieses entfernte Kontingent nicht. 11 entfernte Tools, 13 im lokalen Paket: Die beiden Dateiaudit-Tools benötigen das installierte Paket.

MCP-Anleitung und Kontingente

Benötigt Ihr Client einen lokalen Prozess? Nutzen Sie diese Konfiguration.

Stdio · Claude Desktop

Hinzufügen zu ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) oder %APPDATA%/Claude/claude_desktop_config.json (Windows).

json
{
  "mcpServers": {
    "ibanforge": {
      "command": "npx",
      "args": ["-y", "ibanforge-mcp"]
    }
  }
}

HTTP · Remote-Endpunkt

Verbinden Sie jeden MCP-kompatiblen Client mit:

https://api.ibanforge.com/mcp

11 Remote-Tools · 13 mit npm

validate_iban$0.005

Remote-HTTP + npm-Paket

IBAN-Struktur, Bankcode, Bank und BIC mit dem Umfang jedes Ergebnisses. Kein Nachweis des Kontoinhabers oder der Kontoexistenz.

batch_validate_iban$0.002 / IBAN

Remote-HTTP + npm-Paket

Bis zu 100 IBANs pro Aufruf mit denselben Prüfungen wie bei einer einzelnen Validierung.

lookup_bic$0.003

Remote-HTTP + npm-Paket

Bank und öffentliche Institutsdaten anhand eines BIC/SWIFT-Codes suchen.

lookup_ch_clearing$0.003

Remote-HTTP + npm-Paket

Schweizer Clearingnummer und Zahlungsnetze der Bank nachschlagen.

validate_payment_referenceKostenlos

Remote-HTTP + npm-Paket

RF-, QRR-, OGM- und finnische Zahlungsreferenzen mit der Quelle jeder Regel prüfen.

check_swiss_qr_billKostenlos

Remote-HTTP + npm-Paket

Schweizer QR-Rechnung prüfen: IBAN, Referenz, Betrag und Adressen.

check_postal_addressKostenlos

Remote-HTTP + npm-Paket

Strukturierte Adresse nach SPS-, T2- oder Fedwire-Regeln prüfen.

check_compliance$0.02

Remote-HTTP + npm-Paket

Sanktionen auf Bankebene, Jurisdiktion und SEPA-Erreichbarkeit. Keine Kontoinhaberprüfung.

audit_creditor_fileKostenlose Vorschau / kostenpflichtiger Bericht

Nur im npm-Paket

CSV/XLSX-Datei analysieren: kostenlose Vorschau, kostenpflichtiger Gesamtbericht.

audit_statusKostenlos

Nur im npm-Paket

Fortschritt und Berichtslink einer bereits hochgeladenen Datei abfragen.

send_feedbackKostenlos

Remote-HTTP + npm-Paket

Falsche Daten melden oder eine x402-Erstattung anfordern.

request_api_keyKostenlos

Remote-HTTP + npm-Paket

Einen Schlüssel anfordern, den eine Person im Browser genehmigt.

poll_api_keyKostenlos

Remote-HTTP + npm-Paket

Den Schlüssel nach Genehmigung genau einmal abholen.

Weg 2 · Kostenloser Schlüssel

25 kostenlose Aufrufe pro Monat — ohne E-Mail, ohne Registrierung

POSTen Sie mit leerem Body und erhalten Sie den Schlüssel. Er wird nur einmal angezeigt. Fügen Sie ihn als Authorization: Bearer ifk_… bei jedem Aufruf hinzu. Für 200 pro Monat rufen Sie /v1/keys/claim mit einer Adresse auf, die Sie lesen können.

bash
curl -X POST https://api.ibanforge.com/v1/keys/generate

# → { "api_key": "ifk_...", "monthly_limit": 25 }

Wenn das monatliche Kontingent erschöpft ist, wechselt die API automatisch auf x402: derselbe Agent kann weiter aufrufen und zahlt $0.005 pro Request, ohne zusätzliches Setup, bis das Kontingent am 1. des nächsten Monats zurückgesetzt wird.

SDKs

Mit einem SDK integrieren

Speichern Sie den oben erhaltenen Schlüssel für Python in der serverseitigen Umgebungsvariablen IBANFORGE_API_KEY oder ersetzen Sie ifk_... in der TypeScript-Konfiguration. SDKs melden Kontingent- und Zahlungsfehler; sie signieren Zahlungen nicht automatisch.

python
# pip install ibanforge
import os
from ibanforge import IBANforge

with IBANforge(api_key=os.environ["IBANFORGE_API_KEY"]) as client:
    out = client.validate_iban("DE89370400440532013000")
    print(out["valid"])
    print(out.get("bank_code_check"))
    print(out.get("bic"))
typescript
// npm install @ibanforge/sdk
import { IBANforge } from "@ibanforge/sdk";

const ibanforge = new IBANforge({ apiKey: "ifk_..." });

const out = await ibanforge.validateIban("CH1000230000000012345");

console.log(out.country?.code);          // CH
console.log(out.bic?.bank_name);         // UBS Switzerland AG
console.log(out.sepa?.member);           // true
Weg 3 · x402

Pay-per-call in USDC auf Base

Kein Kontingent, keine Anmeldung, keine E-Mail. Das Wallet Ihres Agenten signiert eine Autorisierung, der Coinbase CDP Facilitator wickelt die Zahlung ab, die API liefert die Antwort. Hin- und Rücklauf in ~1-2 Sekunden.

typescript
import { wrapFetchWithPayment } from "@x402/fetch";
import { x402Client } from "@x402/fetch";
import { ExactEvmScheme, toClientEvmSigner } from "@x402/evm";
import { createPublicClient, http } from "viem";
import { privateKeyToAccount } from "viem/accounts";
import { base } from "viem/chains";

const account = privateKeyToAccount(process.env.WALLET_KEY as `0x${string}`);
const publicClient = createPublicClient({ chain: base, transport: http() });
const evmSigner = toClientEvmSigner(account, publicClient);

const client = new x402Client()
  .register("eip155:8453", new ExactEvmScheme(evmSigner));

const paid = wrapFetchWithPayment(fetch, client);

const r = await paid("https://api.ibanforge.com/v1/iban/validate", {
  method: "POST",
  headers: { "Content-Type": "application/json" },
  body: JSON.stringify({ iban: "CH1000230000000012345" }),
});
// pays $0.005 USDC autonomously, returns 200 with the response

Der Tarif wird an jedem kostenpflichtigen Endpunkt via 402-Antworten mit vollständigen Zahlungsanforderungen angekündigt (network: base, asset: USDC, payTo, amount, schema). Im Coinbase Bazaar für autonome Entdeckung gelistet.

5 kostenpflichtige Endpunkte, alle über MCP + x402 + API-Schlüssel verfügbar

Gleiche Daten, drei Integrationswege.

POST/v1/iban/validate$0.005
POST/v1/iban/batch$0.002 / IBAN
GET/v1/bic/:code$0.003
GET/v1/ch/clearing/:iid$0.003
POST/v1/iban/compliance$0.02
Auto-Entdeckung

Maschinenlesbare Metadaten

Standard-Discovery-Endpunkte für Agenten, die das Web nach nutzbaren APIs durchsuchen:

Nutzen Sie die Prüfungen für Ihren Anwendungsfall

Wählen Sie den ersten Schritt für Ihre Software oder Ihre Lieferantendatei.

IBAN-Prüfungen in Ihre Software integrieren

Testen Sie eine Validierung, sehen Sie sich die Antwort an und verbinden Sie Ihre Anwendung über die API oder eine vorhandene Integration.

API-Ablauf ansehen

Eine Lieferantendatei prüfen

Laden Sie eine CSV- oder Excel-Datei hoch und sehen Sie die Ergebnisse kostenlos in der Vorschau. Bei Bedarf kaufen Sie die kommentierte Arbeitsmappe. Ohne Konto oder Abonnement.

Dateiprüfung kennenlernen

Die verfügbaren Bankinformationen hängen von Land und Quelle ab. Diese Prüfungen bestätigen weder den Kontoinhaber noch die erfolgreiche Ausführung einer Zahlung.