Ibangen Mcp

io.github.offx366Published by GitHub account offx366v0.2.0Updated Oct 31, 2026

Validate IBANs, generate test IBANs with real bank codes, look up BICs and bank codes (IBANgen).

VerifiedStreamable HTTPWeb executableFinanceDeveloper Tools

Overview

AI-generated overview

IBANgen MCP server that lets an assistant validate IBANs, generate synthetic test IBANs with real bank codes, and look up bank codes and BICs.

What you can do
  • Validate IBANs for country format, length, MOD-97 and national check digits, with a note that validity does not prove an account exists
  • Generate synthetic, checksum-valid test IBANs for 119 countries, optionally targeting a named bank, with optional seed
  • Look up a bank's BIC, domestic bank code and free sample test IBANs
  • Describe a country's IBAN format: length, structure, SEPA membership, currency, regex and an example
  • Build an IBAN from national bank details, adding IBAN and national check digits
When to use it
Useful when building or testing payment, checkout or onboarding flows that need realistic IBAN test data, or when an assistant must check IBAN formatting and bank codes during QA and development work.
Requirements
Either the remote endpoint (Streamable HTTP, no key needed to start) or the local PyPI package ibangen-mcp run with Python. An IBANGEN_API_KEY is optional for validation and a small daily allowance, and required for bank targeting, bank lookup and the US tools; a free key allows 100 calls a month. IBANGEN_API_BASE_URL can override the default API base.
Before you install
Generated IBANs and US account numbers are synthetic test data and must never be presented as real accounts or used for payments. A valid IBAN only means a well-formed number, not an existing account. Some US tools consume metered API credits and require explicit approval per number, and they do not retry transport failures because a credit may already be spent. The API key is a secret sent as a bearer token or environment variable.

Installation

In SourceWeft

  1. Open Ibangen Mcp in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.offx366%2Fibangen-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "ibangen": {
      "type": "http",
      "url": "https://ibangen.com/api/mcp"
    }
  }
}

README

ibangen-mcp

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

MCP server that gives AI agents IBANgen tools for IBAN and US bank account test data.

ToolKey neededWhat it does
validate_ibansNo (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_ibansNo for country-level IBANs (10 a day per IP); a key for more and for bank targetingSynthetic, checksum-valid test IBANs; optional seed and bank targeting (paid key).
lookup_bankYes (bank-intelligence plan)BIC or domestic identifier to registry records with sources.
generate_us_test_accountsYes (free key is sufficient)1–10 US routing/account test rows; optional reproducible seed; no paid reveal or targeting.
validate_us_routing_numbersYes (qualifying registry plan)1–10 routing numbers through the existing metered registry API; requires explicit approval of up to one API credit per distinct number.
lookup_us_routing_numberYes (existing API entitlement gates)Source-backed routing lookup; requires explicit approval of one API credit.

For assistants without MCP, the same product map is published as plain text at https://ibangen.com/llms.txt and https://ibangen.com/llms-full.txt.

Generated IBANs are test data only. A valid IBAN does not prove that an account exists. US account numbers are synthetic; routing references do not establish live ACH, Fedwire or account eligibility. The metered US tools do not replace the free web preview and do not bypass bank metadata gates. They never automatically retry a transport failure, because a credit may already have been consumed.

Remote server (nothing to install)

Add https://ibangen.com/api/mcp as a custom connector in ChatGPT, Claude, Cursor or VS Code (Streamable HTTP, no key needed to start; send Authorization: Bearer <API key> for paid-plan limits). It offers validate_ibans, generate_test_ibans, bank_test_ibans (free sample IBANs, BIC and bank code of one bank), iban_format and calculate_iban.

bash
claude mcp add --transport http ibangen https://ibangen.com/api/mcp

Install the local server

bash
pip install ibangen-mcp

Claude Desktop / Claude Code

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

Cursor uses the same block in .cursor/mcp.json. Get a free key (100 API calls a month) at https://ibangen.com/account?focus=api.

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.

Source: README.md at commit 7b40020

Tools

5

validate_ibans

Validate IBANs

Check IBANs: country format, length, MOD-97 check digits and, where the country has one, the national check digit of the account number. Up to 10 IBANs per call without an API key. A valid IBAN is well-formed; it does not prove the account exists.

Parametersibansrequired

generate_test_ibans

Generate test IBANs

Generate synthetic, checksum-valid test IBANs for a country (119 countries, real bank codes). Without an API key: up to 10 a day per user. Name a bank to get IBANs of that bank: free samples without a key, any number with a paid key. Test data only, never for payments.

Parametersbankcountryrequiredquantity

bank_test_ibans

Test IBANs for one bank

A bank's BIC, domestic bank code and free sample test IBANs that carry the bank's real code, plus the bank page and the Bank Target Pack link for up to 250 IBANs of that bank.

Parametersbankrequiredcountryrequired

iban_format

IBAN format of a country

A country's IBAN length, structure (bank code, branch, account and check digit positions), SEPA membership, currency, national check digit, regex and one example test IBAN.

Parameterscountryrequired

calculate_iban

Calculate an IBAN

Build an IBAN from national bank details (bank code, branch code, account number). Adds the IBAN check digits and, where the country has them, the national check digits such as the French RIB key or the Italian CIN. Use iban_format to see which parts a country needs.

Parameterscountryrequiredbank_codebranch_codecheck_digitsaccount_numberrequired

Version history

2
  1. v0.2.0LatestOct 31, 2026
  2. v0.1.1Sep 28, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts