Für autonome Agenten gebaut.

Drei Wege für einen Agenten, IBANforge zu nutzen

In Claude Desktop, Cursor oder Cline installieren

Der IBANforge MCP-Server stellt 5 Tools für Ihren KI-Client bereit. Zwei Transporte: stdio über npm-Paket oder remote streamable-HTTP.

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

5 verfügbare Tools

200 kostenlose Aufrufe/Monat — ohne Registrierung

POSTen Sie die E-Mail Ihres Agenten und erhalten Sie einen Schlüssel. Der Schlüssel wird nur einmal angezeigt. Fügen Sie ihn als Authorization: Bearer ifk_… bei jedem Aufruf hinzu.

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 }

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.

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

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.

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

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.

Maschinenlesbare Metadaten

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

• 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