Metadata-Version: 2.5
Name: ibangen-mcp
Version: 0.1.2
Summary: MCP server for IBANgen: validate IBANs, generate synthetic test IBANs and US bank account test data, and look up banks.
Project-URL: Homepage, https://ibangen.com
Project-URL: Documentation, https://ibangen.com/apidoc
Project-URL: Repository, https://github.com/offx366/ibangen-mcp
Project-URL: Issues, https://github.com/offx366/ibangen-mcp/issues
License: MIT
License-File: LICENSE
Keywords: bic,fintech,iban,iban-validation,mcp,qa,sepa,swift,test-data
Classifier: License :: OSI Approved :: MIT License
Classifier: Operating System :: OS Independent
Classifier: Programming Language :: Python :: 3
Classifier: Topic :: Office/Business :: Financial
Classifier: Topic :: Software Development :: Testing
Requires-Python: >=3.10
Requires-Dist: mcp<3,>=1.2
Description-Content-Type: text/markdown

# ibangen-mcp

<!-- mcp-name: io.github.offx366/ibangen-mcp -->

Official MCP server for [IBANgen](https://ibangen.com), the IBAN generator and validator for payment testing.

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

| 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` | No for country-level IBANs (10 a day per IP); a key for more and for bank targeting | Synthetic, checksum-valid test IBANs; optional `seed` and bank targeting (paid key). |
| `lookup_bank` | Yes (bank-intelligence plan) | BIC or domestic identifier to registry records with sources. |
| `generate_us_test_accounts` | Yes (free key is sufficient) | 1–10 US routing/account test rows; optional reproducible seed; no paid reveal or targeting. |
| `validate_us_routing_numbers` | Yes (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_number` | Yes (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.

## Install

```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](https://rapidapi.com/offx366/api/iban-us-bank-account-test-data-api) (IBAN plus US bank account and routing test data).

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