ibanforge
IBANforge is an API server for IBAN validation, BIC/SWIFT lookup, and financial compliance checks, with micropayment billing and AI agent integration.
Validate a single IBAN (
validate_iban): Check validity with full mod-97 checksum and BBAN structure parsing across 84 countries, returning BIC/SWIFT, bank name, SEPA membership, payment schemes (SCT/SDD/SCT_INST), issuer classification (bank, neobank, EMI, payment institution), and risk indicators. ($0.005/call)Batch validate IBANs (
batch_validate_iban): Validate up to 100 IBANs in a single call with the same detailed results at a reduced cost ($0.002/IBAN) — ideal for payment files, supplier lists, or KYC checks.Look up a BIC/SWIFT code (
lookup_bic): Retrieve full institution details (name, country, city, branch, LEI identifier and regulatory status) from a database of 39,000+ institutions via GLEIF.Run a compliance check (
compliance_check): Full AML/KYC assessment including sanctions screening, SEPA reachability, Verification of Payee (VoP) participation, FATF country risk, and a composite risk score (0–100) with level (low/medium/elevated/high/critical) and detailed flags.Swiss clearing lookup (
lookup_ch_clearing): Retrieve Swiss BC-Nummer/IID data including SIC, euroSIC, Instant Payments, and QR-IID details for CH/LI IBANs (1,190 entries).AI agent integration: All tools are exposed via the Model Context Protocol (MCP) for automated use in AI agent workflows.
Micropayment billing: Pay-per-call using x402 micropayments (USDC on Base L2), ranging from $0.002 to $0.02 per request.
Self-hosting: Deploy via Docker, Railway, or locally using SQLite with no external dependencies.
IBANforge
IBAN validation & BIC/SWIFT lookup API with SEPA compliance data, issuer classification, risk indicators, x402 micropayments, and MCP integration for AI agents.
Features
IBAN Validation — Full mod-97 checksum verification, BBAN structure parsing, 84 countries
BIC/SWIFT Lookup — 121,000+ entries from GLEIF with LEI enrichment
SEPA Compliance — Membership status, payment schemes (SCT/SDD/SCT_INST), VoP requirement per country
Issuer Classification — Detects traditional banks, neobanks, EMIs (Wise, Revolut, N26...), and payment institutions for vIBAN detection (85 known BIC8 mappings)
Risk Indicators — Composite risk signal: issuer type, country risk (FATF-based), test BIC, SEPA reachability, VoP coverage
Batch Processing — Validate up to 100 IBANs in one call
x402 Micropayments — Pay-per-call with USDC (from $0.002/request)
MCP Server — Native AI agent integration via Model Context Protocol
Swiss Clearing — 1,190 BC-Nummer entries from SIX BankMaster with SIC, euroSIC, Instant Payments, and QR-IID data for CH/LI IBANs
Self-hosted — Docker deployment, SQLite database, no external dependencies
Quick Start
git clone https://github.com/cammac-creator/ibanforge.git
cd ibanforge
npm install
cp .env.example .env
npm run devAPI Endpoints
Method | Path | Cost | Description |
|
| $0.005 | Validate a single IBAN |
|
| $0.002/IBAN | Validate up to 100 IBANs |
|
| $0.003 | Lookup BIC/SWIFT code |
|
| $0.003 | Swiss BC-Nummer / IID clearing lookup |
|
| Free | Example validations |
|
| Free | Health check |
|
| Free | Usage statistics |
Examples
Validate IBAN
curl -X POST https://api.ibanforge.com/v1/iban/validate \
-H "Content-Type: application/json" \
-d '{"iban": "CH93 0076 2011 6238 5295 7"}'Lookup BIC
curl https://api.ibanforge.com/v1/bic/UBSWCHZH80AMCP Integration
Add to your Claude Desktop or AI agent config:
{
"mcpServers": {
"ibanforge": {
"command": "npx",
"args": ["tsx", "src/mcp/server.ts"],
"cwd": "/path/to/ibanforge"
}
}
}Available tools: validate_iban, batch_validate_iban, lookup_bic, check_compliance, lookup_ch_clearing
Development
npm run dev # Dev server (hot reload)
npm run test # Run tests
npm run check # Typecheck + lint + test
npm run db:seed # Rebuild BIC database from GLEIFDeployment
Docker
docker build -t ibanforge .
docker run -p 3000:3000 --env-file .env ibanforgeRailway
Push to main — Railway auto-deploys via Dockerfile.
Environment Variables
Variable | Required | Description |
| No | Server port (default: 3000) |
| Yes (prod) | x402 USDC wallet address |
| Yes (prod) | x402 facilitator endpoint |
Data Sources
BIC/SWIFT entries: GLEIF BIC-LEI mapping
LEI enrichment: GLEIF API
Country names: Node.js
Intl.DisplayNamesAPI
License
MIT
Latest Blog Posts
MCP directory API
We provide all the information about MCP servers via our MCP API.
curl -X GET 'https://glama.ai/api/mcp/v1/servers/cammac-creator/ibanforge'
If you have feedback or need assistance with the MCP directory API, please join our Discord server