# IBANforge

IBAN validation, BIC/SWIFT lookup, Swiss clearing, SEPA compliance and risk indicators for AI

## Quick Start

```bash
# Connect this server (installs CLI if needed)
npx -y @smithery/cli@latest mcp add cammac/IBANforge

# Browse available tools
npx -y @smithery/cli@latest tool list cammac/IBANforge

# Get full schema for a tool
npx -y @smithery/cli@latest tool get cammac/IBANforge validate_iban

# Call a tool
npx -y @smithery/cli@latest tool call cammac/IBANforge validate_iban '{}'
```

## Direct MCP Connection

Endpoint: `https://ibanforge--cammac.run.tools`

**Optional config:**
- `api_key` (header) — Optional IBANforge API key for higher rate limits. Free signup at api.ibanforge.com
- `timeout_ms` (query) — Request timeout in milliseconds (default: 30000)

## Tools (5)

- `validate_iban` — Validate a single IBAN — returns country, BIC, SEPA info, issuer classification, and risk indicators. 84 countries.
- `batch_validate_iban` — Validate up to 100 IBANs in one call — each result includes BIC, SEPA, issuer, and risk data.
- `lookup_bic` — Look up a BIC/SWIFT code — returns institution, country, city, LEI, branch info. 121K+ entries from GLEIF.
- `check_compliance` — Compliance check for an IBAN: validation + issuer classification + risk indicators + SEPA reachability + sanctions scre…
- `lookup_ch_clearing` — Look up a Swiss BC-Nummer / IID — returns institution, SIC/euroSIC participation, QR-IID. 1,190 entries from SIX BankMa…

```bash
# Get full input/output schema for a tool
npx -y @smithery/cli@latest tool get cammac/IBANforge <tool-name>
```

## Resources

- `ibanforge://countries` — List of all 84 countries supported by IBANforge with IBAN length, SEPA membership, VoP status, and country risk classif…
- `ibanforge://pricing` — Per-call pricing for IBANforge API endpoints (USDC on Base L2 via x402 protocol).

## Prompts (1)

- `validate_and_explain` (iban) — Validate an IBAN and generate a human-readable explanation suitable for non-technical users.