# Ibangen MCP

> Ibangen MCP is a freemium MCP server for finance and payments. Validate IBANs, generate checksum-valid test IBANs and look up bank codes. It can run locally on your machine or as a hosted remote server.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** API, CLI, Web, macOS, Windows, Linux
- **Website:** https://ibangen.com
- **Repository:** https://github.com/offx366/ibangen-mcp
- **MCP Registry name:** io.github.offx366/ibangen-mcp
- **Categories:** finance and payments, developer tools
- **Listing updated:** 2026-11-14

## About

IBANgen is aimed at developers and QA staff who need realistic banking test data without touching real accounts. Its generated numbers are synthetic and pass the MOD-97 checksum, covering 119 countries according to the site. The validator checks country structure, length, allowed characters and checksum, and the site is clear that a passing check does not prove an account exists.

The hosted endpoint works without a key to start and offers validate_ibans, generate_test_ibans, bank_test_ibans for sample IBANs with BIC and bank code, iban_format and calculate_iban. The PyPI package adds bank lookup and US routing and account test tools that need an API key. Country-level generation is limited to 10 a day per IP without a key; a free key allows 100 calls a month, while bank targeting and bank lookup need paid plans.

The two US routing tools are metered and require explicit approval of an API credit, and they are never retried automatically after a transport failure. Generated data is for QA and staging, not production payments.

## Features

- **IBAN validation:** Checks country format, length, characters and the MOD-97 checksum.
- **Test IBAN generation:** Creates synthetic checksum-valid IBANs, optionally with a seed.
- **Bank targeting:** Paid keys can aim generation at a chosen bank.
- **US test accounts:** Generates routing and account test rows and checks routing numbers.
- **Bank lookup:** Resolves a BIC or domestic identifier to registry records with sources.
- **Two ways to connect:** Use the hosted endpoint or install the Python package for stdio.

## Good for

- Fill payment-form tests with valid IBANs
- Check IBANs in a batch for format and checksum
- Generate reproducible test data using a seed
- Look up a bank's BIC and code
- Create US routing and account fixtures

## Install

### Claude Code (Terminal)

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

### Claude Desktop (Settings → Connectors → Add custom connector)

```sh
https://ibangen.com/api/mcp
```

### Cursor (~/.cursor/mcp.json)

```json
{
  "mcpServers": {
    "ibangen-mcp": {
      "url": "https://ibangen.com/api/mcp"
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```json
{
  "servers": {
    "ibangen-mcp": {
      "type": "http",
      "url": "https://ibangen.com/api/mcp"
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```json
{
  "mcpServers": {
    "ibangen-mcp": {
      "serverUrl": "https://ibangen.com/api/mcp"
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

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

## Tools

- `validate_ibans`: Country format, length and MOD-97 checksum for up to 10 IBANs.
- `generate_test_ibans`: Synthetic checksum-valid test IBANs with optional seed and bank targeting.
- `lookup_bank`: BIC or domestic identifier to registry records with sources.
- `generate_us_test_accounts`: 1 to 10 US routing and account test rows.
- `validate_us_routing_numbers`: Checks 1 to 10 US routing numbers through the metered registry API.
- `lookup_us_routing_number`: Source-backed routing number lookup.
- `bank_test_ibans`: Free sample IBANs, BIC and bank code of one bank.
- `iban_format`: IBAN format details.
- `calculate_iban`: Calculates an IBAN.

## FAQ

### Are generated IBANs real accounts?

No. They are synthetic test data, and a valid checksum does not prove an account exists.

### Do I need a key?

Not to start. Validation and 10 country IBANs a day work without one; a free key gives 100 calls a month.

### Which features need a paid plan?

Bank targeting and bank lookup need paid access.

### How do I install the local server?

Run pip install ibangen-mcp and set IBANGEN_API_KEY if you have a key.

### Is Ibangen MCP free?

Ibangen MCP has a free plan, with paid plans for more usage or features.

### How do I add Ibangen MCP to Claude Code?

Run this command in your terminal: claude mcp add --transport http ibangen-mcp https://ibangen.com/api/mcp

### What are the best alternatives to Ibangen MCP?

The closest alternatives to Ibangen MCP are REA, Codebase Memory, GitHub, Serena MCP: the IDE for your agent and XERJ.

## Alternatives

- [REA](https://ai-powered.com/mcp/rea): REA is an open-source MCP server for developer tools.
- [Codebase Memory](https://ai-powered.com/mcp/codebase-memory): Codebase Memory is an open-source MCP server for knowledge and memory.
- [GitHub](https://ai-powered.com/mcp/github-2): GitHub is an open-source MCP server for developer tools.
- [Serena MCP: the IDE for your agent](https://ai-powered.com/mcp/serena-mcp-the-ide-for-your-agent): Serena MCP: the IDE for your agent is an open-source MCP server for developer tools.
- [XERJ](https://ai-powered.com/mcp/xerj): XERJ is an open-source MCP server for knowledge and memory.
- [Ouroboros](https://ai-powered.com/mcp/ouroboros): Ouroboros is an open-source MCP server for developer tools.
- [Claude Code Ultimate Guide](https://ai-powered.com/mcp/claude-code-ultimate-guide): Claude Code Ultimate Guide is an open-source MCP server for ai models and llm tooling.
- [Concord MCP](https://ai-powered.com/mcp/concord-mcp): Concord MCP is a freemium MCP server for developer tools.

---
Source: https://ai-powered.com/mcp/ibangen-mcp
