ibanforge-mcp

Official Model Context Protocol (MCP) server for IBANforge — IBAN validation, BIC/SWIFT lookup, Swiss BC-Nummer (1,190 SIX entries), EMI/vIBAN classification, SEPA + VoP reachability and compliance risk scoring.

Tools

| Tool | Description | Cost (USDC) | | --------------------- | ------------------------------------------------------------------------------------------------------------------------ | ----------- | | validate_iban | Validate a single IBAN (ISO 13616 mod-97), resolve BIC, classify issuer (bank/EMI/vIBAN), SEPA + VoP flags | 0.005 | | batch_validate_iban | Validate up to 100 IBANs in one call | 0.002 each | | lookup_bic | Lookup BIC/SWIFT against 121,197 GLEIF entries with LEI enrichment | 0.003 | | lookup_ch_clearing | Lookup Swiss BC-Nummer / IID against 1,190 SIX BankMaster entries (SIC, euroSIC, QR-IID) | 0.003 | | check_compliance | Full compliance check: IBAN + sanctions (OFAC/EU/UN) + SEPA Instant + VoP + risk score (0-100) | 0.02 |

Installation

Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS) or %APPDATA%\Claude\claude_desktop_config.json (Windows):

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

Cursor

Settings → MCP → Add server, or paste the same JSON above.

Claude Code (CLI)

claude mcp add ibanforge npx -- -y ibanforge-mcp

Cline / Continue.dev / Windsurf

Same JSON config — drop into the respective mcp.json.

Authentication

Three modes, in order of precedence:

1. API key (free tier) — set IBANFORGE_API_KEY=ifk_… in the env config. 200 free requests/month.
2. x402 micropayments (USDC on Base L2) — automatic when an x402-capable wallet is configured. See x402 discovery.
3. Anonymous — only the demo endpoint and rate-limited public surface are accessible.

Get a free API key:

curl -X POST https://api.ibanforge.com/v1/keys/generate \
  -H "Content-Type: application/json" \
  -d '{"email":"[email protected]"}'

Examples

After adding the server, ask your AI agent:

• "Validate the IBAN CH93 0076 2011 6238 5295 7"
• "Look up BIC UBSWCHZH80A"
• "Look up Swiss BC-Nummer 762"
• "Run a compliance check on IBAN GB29 NWBK 6016 1331 9268 19"
• "Validate these 5 IBANs in batch: …"

Configuration

| Env var | Default | Description | | --------------------- | ----------------------------- | ---------------------------------------------------------- | | IBANFORGE_API_BASE | https://api.ibanforge.com | Override for self-hosted or staging instances | | IBANFORGE_API_KEY | (unset) | Bearer ifk_* API key for the free tier or paid plans |

Data sources

• 121,197 BIC entries from GLEIF (Global Legal Entity Identifier Foundation), enriched with LEI codes
• 1,190 BC-Nummern from the official SIX BankMaster CSV
• EMI / vIBAN classification from a curated dataset of 30+ known issuer prefixes
• VoP participants from the EBA RT1 / SCT Inst directories

Links

• Website
• API documentation
• OpenAPI 3.1 spec
• x402 discovery
• Issue tracker

License

Apache-2.0