io.github.offx366/ibangen-mcp

Official

by offx366 · Python

Validate IBANs, generate synthetic test IBANs and look up banks (SWIFT/BIC) via IBANgen.

io.github.offx366/ibangen-mcp MCP Server

The io.github.offx366/ibangen-mcp Model Context Protocol (MCP) server provides IBAN-related utilities. It can validate IBANs, generate synthetic test IBANs, and look up banks using IBANgen, including SWIFT/BIC information. This supports workflows that require payment-identifier checks and bank identification.

🛠️ Key Features

Validate IBANs
Generate synthetic test IBANs
Look up banks via IBANgen (SWIFT/BIC)

🚀 Use Cases

Input validation for payment workflows
Test data generation for IBAN-based systems
Resolving bank identifiers from IBANs (SWIFT/BIC)

⚡ Developer Benefits

Centralizes IBAN validation and test IBAN generation
Enables bank lookup workflows using IBAN-derived data

Topics

bicfintechibaniban-validatormcpmcp-servermodel-context-protocolsepaswifttest-data

README.md1 KBView on GitHub

ibangen-mcp

Official MCP server for IBANgen, the IBAN generator and validator for payment testing.

MCP server that gives AI agents three IBANgen tools:

Tool	Key needed	What it does
`validate_ibans`	No (10 IBANs per call, small daily allowance per IP)	Country format, length and MOD-97 checksum. Paid keys add bank, BIC and SEPA Instant / VoP reachability.
`generate_test_ibans`	Yes	Synthetic, checksum-valid test IBANs; optional `seed` and bank targeting.
`lookup_bank`	Yes (bank-intelligence plan)	BIC or domestic identifier to registry records with sources.

Generated IBANs are test data only. A valid IBAN does not prove that an account exists.

Install

bash

pip install ibangen-mcp

Claude Desktop / Claude Code

json

{
  "mcpServers": {
    "ibangen": {
      "command": "ibangen-mcp",
      "env": { "IBANGEN_API_KEY": "your_key_optional_for_validation" }
    }
  }
}

Cursor uses the same block in .cursor/mcp.json. Get a key at https://ibangen.com/apidoc#auth.

The same API is also sold on RapidAPI (IBAN plus US bank account and routing test data).

IBANGEN_API_BASE_URL overrides the default https://ibangen.com/api/v1.

Install

Configuration

Environment variables

IBANGEN_API_KEYsecret

IBANgen API key; optional for validation, required for generation and bank lookup

Add to VS Code Add to Cursor

claude_desktop_config.json

json

{
  "mcpServers": {
    "ibangen-mcp": {
      "command": "uvx",
      "args": [
        "ibangen-mcp"
      ],
      "env": {
        "IBANGEN_API_KEY": "<YOUR_IBANGEN_API_KEY>"
      }
    }
  }
}

io.github.offx366/ibangen-mcp MCP Server

🛠️ Key Features

🚀 Use Cases

⚡ Developer Benefits

Topics

ibangen-mcp

Install

Claude Desktop / Claude Code

Install

Configuration

Related servers