Conçu pour les agents autonomes.

Trois façons pour un agent d'utiliser IBANforge

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.

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

5 outils disponibles

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.

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.

Drop-in libraries

Skip the HTTP wiring. Type-safe clients with sync + async, retry-aware exception classes, and a free-tier quota fallback to x402 baked in.

# pip install ibanforge
from ibanforge import IBANforge

# Generate a free key in one line
key = IBANforge.generate_api_key("agent@yourdomain.com")

with IBANforge(api_key=key["api_key"]) as client:
    out = client.validate_iban("CH9300762011623852957")
    print(out["country"]["code"])              # CH
    print(out["bic"]["bank_name"])            # UBS Switzerland AG
    print(out["sepa"]["member"])              # True
    print(out["risk_indicators"]["country_risk"])  # "standard"

    # Compliance triage in one call ($0.02)
    out = client.check_compliance("GB29NWBK60161331926819")
    print(out["compliance"]["risk_score"])    # 0-100
    print(out["compliance"]["risk_level"])    # "low" | "medium" | "elevated" | "high" | "critical"

# Async path (FastAPI / LangChain async / fan-out)
import asyncio
from ibanforge import AsyncIBANforge

async def main():
    async with AsyncIBANforge(api_key=key["api_key"]) as client:
        results = await asyncio.gather(*[
            client.validate_iban(iban) for iban in many_ibans
        ])

// npm install @ibanforge/sdk
import { IBANforge } from "@ibanforge/sdk";

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

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

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

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.

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.

Métadonnées lisibles par machine

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

• api.ibanforge.com/.well-known/x402
• api.ibanforge.com/.well-known/agents.json
• api.ibanforge.com/.well-known/mcp.json
• api.ibanforge.com/openapi.json
• api.ibanforge.com/llms.txt