IBANforge

API für IBAN-Validierung & BIC/SWIFT-Suche mit SEPA-Konformitätsdaten, Emittentenklassifizierung, Risikoindikatoren, x402-Mikrozahlungen und MCP-Integration für KI-Agenten.

Funktionen

• IBAN-Validierung — Vollständige Mod-97-Prüfsummenverifizierung, BBAN-Struktur-Parsing, 84 Länder

• BIC/SWIFT-Suche — Über 121.000 Einträge von GLEIF mit LEI-Anreicherung

• SEPA-Konformität — Mitgliedschaftsstatus, Zahlungssysteme (SCT/SDD/SCT_INST), VoP-Anforderung pro Land

• Emittentenklassifizierung — Erkennt traditionelle Banken, Neobanken, E-Geld-Institute (Wise, Revolut, N26...) und Zahlungsinstitute für die vIBAN-Erkennung

• Risikoindikatoren — Zusammengesetztes Risikosignal: Emittententyp, Länderrisiko (basierend auf FATF), Test-BIC, SEPA-Erreichbarkeit, VoP-Abdeckung

• Stapelverarbeitung — Validierung von bis zu 100 IBANs in einem Aufruf

• x402-Mikrozahlungen — Pay-per-Call mit USDC (ab 0,002 $/Anfrage)

• MCP-Server — Native KI-Agenten-Integration über das Model Context Protocol

• Selbst gehostet — Docker-Bereitstellung, SQLite-Datenbank, keine externen Abhängigkeiten

Schnellstart

git clone https://github.com/cammac-creator/ibanforge.git
cd ibanforge
npm install
cp .env.example .env
npm run dev

API-Endpunkte

Beispiele

IBAN validieren

curl -X POST https://api.ibanforge.com/v1/iban/validate \
  -H "Content-Type: application/json" \
  -d '{"iban": "CH93 0076 2011 6238 5295 7"}'

BIC suchen

curl https://api.ibanforge.com/v1/bic/UBSWCHZH80A

MCP-Integration

Zur Konfiguration von Claude Desktop oder KI-Agenten hinzufügen:

{
  "mcpServers": {
    "ibanforge": {
      "command": "npx",
      "args": ["tsx", "src/mcp/server.ts"],
      "cwd": "/path/to/ibanforge"
    }
  }
}

Verfügbare Tools: validate_iban, batch_validate_iban, lookup_bic

Entwicklung

npm run dev          # Dev server (hot reload)
npm run test         # Run tests
npm run check        # Typecheck + lint + test
npm run db:seed      # Rebuild BIC database from GLEIF

Bereitstellung

Docker

docker build -t ibanforge .
docker run -p 3000:3000 --env-file .env ibanforge

Railway

Push auf main — Railway führt die Bereitstellung automatisch über das Dockerfile durch.

Umgebungsvariablen

Datenquellen

• BIC/SWIFT-Einträge: GLEIF BIC-LEI-Mapping

• LEI-Anreicherung: GLEIF API

• Ländernamen: Node.js Intl.DisplayNames API

Lizenz

MIT