Conçu pour les agents autonomes.

Trois façons pour un agent d'utiliser IBANforge

Installer dans Claude Desktop, Cursor ou Cline

11 outils sur le serveur HTTP distant, 13 dans le module npm installé. Les deux outils supplémentaires analysent un fichier de créanciers et suivent son rapport.

https://api.ibanforge.com/mcp

Votre client nécessite un processus local ? Utilisez cette configuration.

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

11 outils à distance · 13 avec npm

25 appels gratuits par mois — sans e-mail, sans inscription

POSTez un corps vide, recevez la clé. Elle n'est affichée qu'une fois. Ajoutez-la dans Authorization: Bearer ifk_… à chaque appel. Pour atteindre 200 par mois, appelez /v1/keys/claim avec une adresse que vous pouvez lire.

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

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

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.

Intégrer avec un SDK

Conservez la clé obtenue ci-dessus dans la variable d’environnement IBANFORGE_API_KEY côté serveur pour Python, ou remplacez ifk_... dans la configuration TypeScript. Les SDK exposent les erreurs de quota et de paiement ; ils ne signent pas de paiement automatiquement.

# 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"))

// 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

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: "CH1000230000000012345" }),
});
// 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