Validate, format, and check IBAN bank account numbers via @mukundakatta/iban-mcp

@mukundakatta/iban-mcp v0.1.0 — IBAN validation and formatting

Install: npm install @mukundakatta/iban-mcp Entry: dist/server.js (stdio transport) Tools: 2

Tool inventory

Verified execution trace (16 calls, 100% success, p50=0.3ms)

validate — valid IBANs from 5 countries:

• DE89370400440532013000 → {valid:true, country:"DE"} (Germany)
• GB29NWBK60161331926819 → {valid:true, country:"GB"} (UK)
• FR7630006000011234567890189 → {valid:true, country:"FR"} (France)
• TR330006100519786457841326 → {valid:true, country:"TR"} (Turkey)
• NL91ABNA0417164300 → {valid:true, country:"NL"} (Netherlands)

validate — input normalization:

• Spaces auto-stripped: "DE89 3704 0044 0532 0130 00" → valid DE
• Case-insensitive: "gb29nwbk60161331926819" → valid GB

validate — rejection cases:

• Bad checksum: "DE00370400440532013000" → {valid:false, reason:"checksum failed"}
• Too short: "DE89" → {valid:false, reason:"too short"}
• Empty string: "" → {valid:false, reason:"too short"}
• Garbage: "NOTANIBAN12345" → {valid:false, country:"NO", reason:"expected 15 chars, got 14"} (interprets "NO" as country code)
• Unknown country: "XX89370400440532013000" → {valid:false, country:"XX", reason:"unknown country"}

format — pretty-print:

• DE89370400440532013000 → "DE89 3704 0044 0532 0130 00"
• GB29NWBK60161331926819 → "GB29 NWBK 6016 1331 9268 19"
• Already spaced input normalized: "FR76 3000 6000 0112 3456 7890 189" → same
• Lowercase uppercased: "nl91abna0417164300" → "NL91 ABNA 0417 1643 00"

Key gotchas

1. Spaces and dashes auto-stripped — both validate and format normalize input
2. Case-insensitive — lowercase letters uppercased before validation
3. Country-specific length checking — knows NO=15, DE=22, GB=22, FR=27, TR=26, NL=18 etc.
4. Mod-97 checksum — standard ISO 13616 algorithm
5. `reason` field only present when `valid: false` — absent on success
6. No `split` tool despite npm description mentioning "split" — only validate and format
7. Garbage input may detect false country — "NOTANIBAN..." becomes country "NO" (Norway) and then fails length check
8. Sub-millisecond after JIT — first call ~1.4ms, rest 0.1-0.7ms