IBANforge
Pour les agents IA

Conçu pour les agents autonomes.

IBANforge est la seule API IBAN/BIC/compliance qui combine un serveur MCP natif, des micropaiements x402 et une clé API gratuite — sans aucun onboarding humain. Trois voies d'intégration, 60 secondes de setup.

Trois façons pour un agent d'utiliser IBANforge

Voie 1 · MCP

Serveur MCP natif

Branchez-le sur Claude Desktop, Cursor ou Cline. 5 outils auto-découverts. Idéal pour les agents desktop et les assistants IDE.

Stdio ou HTTP · npm ou distant

Voie 2 · Clé gratuite

Clé API gratuite

POST avec un email, vous recevez une clé avec 200 appels gratuits/mois. Pas de vérification, pas de captcha. Parfait pour prototyper ou les agents à faible volume.

Header : Authorization: Bearer ifk_…

Voie 3 · x402

Paiement à l'appel x402

Utilisez un wallet sur Base L2, l'agent paie en USDC de façon autonome. Pas d'inscription, pas de quota. Idéal pour les gros volumes et les intégrations zéro-friction.

USDC sur Base · facilitator Coinbase CDP

Voie 1 · MCP

Installer dans Claude Desktop, Cursor ou Cline

Le serveur MCP IBANforge expose 5 outils à votre client IA. Deux transports : stdio via package npm ou HTTP streamable distant.

Stdio · Claude Desktop

Ajouter à ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) ou %APPDATA%/Claude/claude_desktop_config.json (Windows).

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

HTTP · endpoint distant

Pointez n'importe quel client MCP compatible vers :

https://api.ibanforge.com/mcp

5 outils disponibles

validate_iban$0.005

Validate any IBAN. Returns BIC, country, EMI/vIBAN flag, SEPA + VoP, risk score, Swiss BC-Nummer for CH/LI.

batch_validate_iban$0.002 / IBAN

Up to 100 IBANs in one call — CSV cleanup, payout list triage.

lookup_bic$0.003

Resolve a BIC/SWIFT into bank name, country, city, LEI, address. 121,197 GLEIF entries.

lookup_ch_clearing$0.003

Resolve a Swiss BC-Nummer / IID. Only API exposing SIC, euroSIC, QR-IID — 1,190 SIX entries.

check_compliance$0.02

Pre-flight risk triage: sanctions (OFAC/EU/UN), FATF, SEPA Instant, VoP. Returns risk_score 0-100.

Voie 2 · Clé gratuite

200 appels gratuits/mois — sans inscription

POST l'email de votre agent, recevez la clé. La clé n'est affichée qu'une fois. Ajoutez-la dans Authorization: Bearer ifk_… à chaque appel.

bash
curl -X POST https://api.ibanforge.com/v1/keys/generate \
  -H "Content-Type: application/json" \
  -d '{"email":"agent@yourdomain.com"}'

# → returns { "api_key": "ifk_...", "monthly_limit": 200 }

Quand le quota mensuel est épuisé, l'API bascule automatiquement sur x402 : le même agent peut continuer à appeler, en payant 0,005 $ par requête, sans setup supplémentaire jusqu'au reset du quota le 1er du mois suivant.

Voie 3 · x402

Paiement à l'appel en USDC sur Base

Pas de quota, pas d'inscription, pas d'email. Le wallet de votre agent signe une autorisation, le facilitator Coinbase CDP settle le paiement, l'API renvoie la réponse. Aller-retour en ~1-2 secondes.

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: "CH9300762011623852957" }),
});
// pays $0.005 USDC autonomously, returns 200 with the response

Le tarif est annoncé sur chaque endpoint payant via les réponses 402 avec les exigences de paiement complètes (network: base, asset: USDC, payTo, amount, schema). Référencé sur le Bazaar Coinbase pour la découverte autonome.

5 endpoints payants, tous accessibles via MCP + x402 + clé API

Mêmes données, trois voies d'intégration.

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-découverte

Métadonnées lisibles par machine

Endpoints de découverte standards pour les agents qui scannent le web à la recherche d'APIs utilisables :

Prêt quand votre agent est prêt.

Clé gratuite en 1 ligne. Install MCP en 30 secondes. x402 settle en 2 secondes.

Ouvrir le playground