IBANforge

Intégration MCP

IBANforge fournit un serveur MCP officiel pour agents IA : ibanforge-mcp sur npm, plus un endpoint hébergé sans rien installer. Claude, Cursor ou tout client compatible MCP peut valider des IBAN, résoudre des BIC, vérifier des numéros de clearing suisses et lancer un pré-contrôle conformité sous forme d'appels d'outils.

Qu'est-ce que MCP ?

Le Model Context Protocol est un standard ouvert qui permet aux assistants IA d'utiliser des outils externes. Au lieu de demander à l'utilisateur de copier-coller des résultats d'API, l'agent appelle l'outil directement et reçoit des données structurées.

Option 1 — le paquet npm (stdio)

Claude Desktop — ajoutez IBANforge au fichier de configuration :

macOS : ~/Library/Application Support/Claude/claude_desktop_config.json

Windows : %APPDATA%\Claude\claude_desktop_config.json

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

Claude Code — une seule commande :

claude mcp add ibanforge -e IBANFORGE_API_KEY=ifk_votre_cle -- npx -y ibanforge-mcp

La clé est optionnelle et gratuite : créez-en une avec une adresse e-mail (200 requêtes/mois, sans carte). Sans clé, le serveur démarre quand même, et les outils payants répondent avec des instructions de paiement x402 qu'un agent détenant des USDC sur Base peut régler à l'appel.

Après enregistrement, redémarrez le client. Cinq outils IBANforge apparaissent dans le menu des outils.

Option 2 — l'endpoint hébergé (rien à installer)

https://api.ibanforge.com/mcp

Transport HTTP streamable, 10 appels d'outils gratuits par IP et par jour, sans aucune clé : le chemin le plus rapide pour qu'un agent évalue la donnée avant tout engagement. Pour un usage suivi, lancez le paquet npm avec votre clé gratuite.

Sur le registre MCP officiel, le serveur est listé sous io.github.cammac-creator/ibanforge.

Les cinq outils

validate_iban

Valide un IBAN : structure et clé, banque émettrice (BIC), contrôle du code banque au registre national, classification EMI/vIBAN, joignabilité SEPA/VoP et indicateurs de risque — les mêmes données que POST /v1/iban/validate.

{ "iban": "CH1000230000000012345" }

batch_validate_iban

Jusqu'à 100 IBAN en un appel, chaque résultat identique en structure à validate_iban — comme POST /v1/iban/batch.

{ "ibans": ["CH1000230000000012345", "DE89370400440532013000"] }

lookup_bic

Détails d'un code BIC/SWIFT : nom, pays, ville, agence, LEI le cas échéant — comme GET /v1/bic/:code.

{ "code": "UBSWCHZH80A" }

lookup_ch_clearing

Recherche d'un BC-Nummer / IID suisse : institution, type, localité, participation SIC/euroSIC et attribution QR-IID — comme GET /v1/ch/clearing/:iid.

{ "iid": "230" }

check_compliance

Pré-contrôle complet en un appel : filtrage sanctions sur le BIC bancaire résolu, statut FATF, joignabilité SEPA Instant, participation VoP et score de risque composite de 0 à 100 — comme POST /v1/iban/compliance.

{ "iban": "CH1000230000000012345" }

Des résultats qui disent quoi faire ensuite

Chaque résultat de validation porte un champ next_steps ordonné : ce qui bloque un paiement d'abord, ce qui l'enrichit ensuite. Chaque entrée a un code stable sur lequel brancher, une phrase do que l'agent peut relayer, et un because qui nomme le champ de la réponse qui l'a produite — le conseil est auditable au lieu d'être cru sur parole. bank_code_not_allocated veut dire stop ; verify_payee_name veut dire continuer et laisser trancher un contrôle du nom du bénéficiaire.

Exemple de conversation avec un agent

Vous : Cet IBAN est-il valide ? CH10 0023 0000 0000 1234 5

Claude : Je valide cet IBAN. [appelle validate_iban]

Oui, cet IBAN est valide — et le code banque est confirmé au registre SIX : UBS Switzerland AG à Zurich, BIC UBSWCHZH, BC-Nummer 00230, participant SIC avec paiements instantanés en CHF.

Vous : Peux-tu vérifier ces 3 IBAN de la facture fournisseur ?

Claude : Je valide les trois d'un coup. [appelle batch_validate_iban]

2 sur 3 sont valides. Le troisième (FR76...) a une erreur de clé — il semble que deux chiffres aient été inversés.

Fonctionne bien avec

PayQR — npx -y @czagents/payqr, MCP hébergé https://payqr.cz-agents.dev/mcp, registre dev.cz-agents/payqr. Génère et auto-vérifie un QR de paiement européen à partir d'un IBAN et des détails du paiement : SPAYD pour les comptes CZ/SK, EPC/GiroCode (EUR uniquement) pour les autres comptes SEPA ; EPC exige recipient_name. PayQR valide la clé de l'IBAN mais ne vérifie ni la titularité du compte ni le nom du bénéficiaire, et ne génère pas de QR-factures suisses natives — le contrôle au registre, la préparation VoP et les indicateurs de risque sont exactement ce qu'IBANforge ajoute par-dessus.

Clients compatibles

  • Claude Desktop et Claude Code — support MCP natif
  • Cursor et Continue.dev — via leur configuration MCP
  • n8n — préférez le node communautaire dédié
  • Agents sur mesure — toute application utilisant le SDK MCP

Notes

  • Le paquet npm est un client léger de api.ibanforge.com : la donnée vit côté serveur, rien à télécharger, et les résultats reflètent toujours le dernier rafraîchissement des registres.
  • Les cinq outils rendent le même JSON que l'API REST, en texte et en structuredContent MCP.
  • Les versions sont publiées sur npm et reflétées sur le registre MCP.

Voir aussi : Recettes · Ce que « verified » veut dire · Sources des données