Ibanforge

cammac-creator/ibanforge

Validates IBANs with full BIC/SWIFT lookup, SEPA Instant reachability, and Swiss BC-Nummer resolution in under 50ms. Exposes five MCP tools covering single and batch validation, BIC lookup across 121,000 entries with LEI enrichment from GLEIF, Swiss clearing number lookups from SIX BankMaster, and compliance scoring that checks sanctions lists, FATF status, and Verification of Payee support. Works over stdio or streamable HTTP. Runs without an API key using x402 micropayments on Base, or grab a free tier key for 200 requests per month. Reach for this when your agent needs to triage payment lists, classify EMI/vIBAN issuers like Wise or Revolut, or run pre-flight compliance checks before SEPA transfers.

GitHub stars: 3
tools: 11
auth: Secret needed
transport: STDIO, HTTP
env vars: 2
last updated: Nov 10, 2026

View on GitHub

Install

From registry metadata

$ npx add-mcp https://api.ibanforge.com/mcp --name ibanforge --header 'X-API-Key: ${X_API_KEY}'

Run in your terminal. add-mcp asks which agents to add it to, then asks for each value it needs. Add -g to install it for every project.

Review the command, arguments and environment values before installing. MCP servers run with your local permissions.

Other ways

Claude Code

$ claude mcp add --transport http ibanforge https://api.ibanforge.com/mcp --header 'X-API-Key: YOUR_X_API_KEY'

Run in your terminal. Add --scope user to make it available in every project.

Tools

Verified live · 11 tools

Verified live against the running server on Nov 6, 2026.

validate_ibanVerify whether an IBAN from any of the 89 IBAN countries is valid AND enrich it with bank, compliance and routing data. USE WHEN: the user mentions an IBAN, asks to validate an IBAN and identify the issuing bank, asks to detect a typo in an IBAN, asks who the bank is behind an...1 params

Verify whether an IBAN from any of the 89 IBAN countries is valid AND enrich it with bank, compliance and routing data. USE WHEN: the user mentions an IBAN, asks to validate an IBAN and identify the issuing bank, asks to detect a typo in an IBAN, asks who the bank is behind an...

Parameters* required

iban*string

IBAN to validate (spaces/hyphens stripped automatically)

batch_validate_ibanValidate up to 100 IBANs in a single call. Paid per call in USDC via x402, it costs $0.002 per IBAN instead of $0.005 per validate_iban call; on an API key or a credit pack each IBAN uses one request or credit, the same as one validate_iban call. USE WHEN: the user pastes a li...1 params

Validate up to 100 IBANs in a single call. Paid per call in USDC via x402, it costs $0.002 per IBAN instead of $0.005 per validate_iban call; on an API key or a credit pack each IBAN uses one request or credit, the same as one validate_iban call. USE WHEN: the user pastes a li...

Parameters* required

ibans*array

Array of IBANs (1-100)

lookup_bicResolve a BIC / SWIFT code into the underlying bank: name, country, city, LEI, and registered head-office address (where available). USE WHEN: the user already has a BIC/SWIFT (8 or 11 chars, alphanumeric, e.g., "UBSWCHZH80A", "DEUTDEFF") and asks which bank it belongs to, whe...1 params

Resolve a BIC / SWIFT code into the underlying bank: name, country, city, LEI, and registered head-office address (where available). USE WHEN: the user already has a BIC/SWIFT (8 or 11 chars, alphanumeric, e.g., "UBSWCHZH80A", "DEUTDEFF") and asks which bank it belongs to, whe...

Parameters* required

bic*string

BIC/SWIFT code (8 or 11 chars)

check_complianceRun a pre-flight compliance triage on an IBAN before sending a SEPA / cross-border payment. USE WHEN: the user is about to send a payment / payout / refund and wants to triage risk first, asks whether the payee's bank or its country is under sanctions, asks if a SEPA Instant t...1 params

Run a pre-flight compliance triage on an IBAN before sending a SEPA / cross-border payment. USE WHEN: the user is about to send a payment / payout / refund and wants to triage risk first, asks whether the payee's bank or its country is under sanctions, asks if a SEPA Instant t...

Parameters* required

iban*string

IBAN to check

validate_payment_referenceValidate a structured payment reference and, when an IBAN is supplied, decide whether the two may legally travel together. USE WHEN: assembling a payment instruction from an invoice, a QR-bill or a remittance advice; whenever a Swiss IBAN and a reference appear together (the p...3 params

Validate a structured payment reference and, when an IBAN is supplied, decide whether the two may legally travel together. USE WHEN: assembling a payment instruction from an invoice, a QR-bill or a remittance advice; whenever a Swiss IBAN and a reference appear together (the p...

Parameters* required

ibanstring

Optional creditor IBAN — supply it to get the pairing verdict

reference*string

The reference as printed; spaces, slashes and the +++…+++ wrapper are stripped

reference_typestring

Optional hint: rf | scor | qrr | ogm | vcs | viitenumero | kid | ocr

check_swiss_qr_billCheck a Swiss QR-bill payload, the text a QR-bill's code carries (starts with SPC), rule by rule, each finding citing the SIX document it comes from. USE WHEN: an agent, an ERP or an accounting tool holds a scanned or generated QR-bill and must know before paying or issuing it...1 params

Check a Swiss QR-bill payload, the text a QR-bill's code carries (starts with SPC), rule by rule, each finding citing the SIX document it comes from. USE WHEN: an agent, an ERP or an accounting tool holds a scanned or generated QR-bill and must know before paying or issuing it...

Parameters* required

payload*string

The Swiss QR Code text with real line breaks: SPC, 0200, 1, IBAN, creditor (7 lines), ultimate creditor (7 empty lines), amount, currency, ultimate debtor (7 lines), reference type, reference, mess...

check_postal_addressCheck a structured ISO 20022 postal address against a payment rail's published address rules, rule by rule, each verdict citing the document it comes from. USE WHEN: assembling a payment instruction (pain.001, a Fedwire message, a T2 transfer) with a creditor or debtor address...2 params

Check a structured ISO 20022 postal address against a payment rail's published address rules, rule by rule, each verdict citing the document it comes from. USE WHEN: assembling a payment instruction (pain.001, a Fedwire message, a T2 transfer) with a creditor or debtor address...

Parameters* required

address*object

The ISO 20022 PostalAddress under test, in ISO tag vocabulary (snake_cased).

scheme*string

Which rail's rules to check against: sps | hvps_plus | fedwireone of sps · hvps_plus · fedwire

lookup_ch_clearingResolve a Swiss BC-Nummer / IID (1 to 5 digits) into the underlying institution. USE WHEN: the user mentions a Swiss bank by BC-Nummer or IID, pastes a CH or LI IBAN clearing code, asks routing details for a Swiss instant transfer (SIC, euroSIC), asks about QR-bill QR-IID reso...1 params

Resolve a Swiss BC-Nummer / IID (1 to 5 digits) into the underlying institution. USE WHEN: the user mentions a Swiss bank by BC-Nummer or IID, pastes a CH or LI IBAN clearing code, asks routing details for a Swiss instant transfer (SIC, euroSIC), asks about QR-bill QR-IID reso...

Parameters* required

iid*string

Swiss IID (1-5 digit number)

send_feedbackReport a problem or a need directly to the IBANforge operators: incorrect validation result, stale or missing BIC/bank data, latency, or anything blocking you from using or PAYING for the service (missing network, unclear pricing, quota shape). USE WHEN: a result looks wrong,...7 params

Report a problem or a need directly to the IBANforge operators: incorrect validation result, stale or missing BIC/bank data, latency, or anything blocking you from using or PAYING for the service (missing network, unclear pricing, quota shape). USE WHEN: a result looks wrong,...

Parameters* required

agentstring

Which agent/model is reporting, e.g. "claude-sonnet-5 via MCP".

contactstring

Where we may answer you (e-mail) — optional, reports can be anonymous.

endpointstring

Endpoint or tool concerned, e.g. /v1/iban/batch.

error_type*string

Category of the report. Use "other" for product feedback, pricing/payment blockers or feature needs.one of wrong_validation · stale_bic · missing_data · incorrect_classification · latency · other

expectedstring

What you expected (for data errors).

gotstring

What you received instead (for data errors).

notes*string

What happened, what you needed, or what blocked you — free text.

request_api_keyStart the process that gives your human a free IBANforge API key, without any e-mail address. The key does not unlock this session: it works once your human puts it in the MCP client configuration and reconnects, or sends it to the REST API, so tell them where it goes when you...2 params

Start the process that gives your human a free IBANforge API key, without any e-mail address. The key does not unlock this session: it works once your human puts it in the MCP client configuration and reconnects, or sends it to the REST API, so tell them where it goes when you...

Parameters* required

client_namestring

Optional. Who is asking, shown to the human on the approval page.

reasonstring

Optional. What the key is for, shown to the human on the approval page.

poll_api_keyCollect the API key once a human has approved the request opened by request_api_key. USE WHEN: you have called request_api_key and shown the code to your human. HOW TO CALL IT: leave `device_code` empty to reuse the last request from this session. The server usually waits up t...1 params

Collect the API key once a human has approved the request opened by request_api_key. USE WHEN: you have called request_api_key and shown the code to your human. HOW TO CALL IT: leave `device_code` empty to reuse the last request from this session. The server usually waits up t...

Parameters* required

device_codestring

Optional. Leave it empty to reuse the last request from this session.