IBANforge

API de validación de IBAN y búsqueda de BIC/SWIFT con datos de cumplimiento SEPA, clasificación de emisores, indicadores de riesgo, micropagos x402 e integración MCP para agentes de IA.

Características

• Validación de IBAN — Verificación completa de suma de comprobación mod-97, análisis de estructura BBAN, 84 países

• Búsqueda de BIC/SWIFT — Más de 121.000 entradas de GLEIF con enriquecimiento LEI

• Cumplimiento SEPA — Estado de afiliación, esquemas de pago (SCT/SDD/SCT_INST), requisito de VoP por país

• Clasificación de emisores — Detecta bancos tradicionales, neobancos, EMI (Wise, Revolut, N26...) e instituciones de pago para detección de vIBAN

• Indicadores de riesgo — Señal de riesgo compuesta: tipo de emisor, riesgo país (basado en GAFI), BIC de prueba, accesibilidad SEPA, cobertura VoP

• Procesamiento por lotes — Valida hasta 100 IBAN en una sola llamada

• Micropagos x402 — Pago por llamada con USDC (desde $0.002/solicitud)

• Servidor MCP — Integración nativa de agentes de IA mediante Model Context Protocol

• Autohospedado — Despliegue en Docker, base de datos SQLite, sin dependencias externas

Inicio rápido

git clone https://github.com/cammac-creator/ibanforge.git
cd ibanforge
npm install
cp .env.example .env
npm run dev

Endpoints de la API

Ejemplos

Validar IBAN

curl -X POST https://api.ibanforge.com/v1/iban/validate \
  -H "Content-Type: application/json" \
  -d '{"iban": "CH93 0076 2011 6238 5295 7"}'

Buscar BIC

curl https://api.ibanforge.com/v1/bic/UBSWCHZH80A

Integración MCP

Añadir a la configuración de Claude Desktop o de su agente de IA:

{
  "mcpServers": {
    "ibanforge": {
      "command": "npx",
      "args": ["tsx", "src/mcp/server.ts"],
      "cwd": "/path/to/ibanforge"
    }
  }
}

Herramientas disponibles: validate_iban, batch_validate_iban, lookup_bic

Desarrollo

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 GLEIF

Despliegue

Docker

docker build -t ibanforge .
docker run -p 3000:3000 --env-file .env ibanforge

Railway

Enviar a main — Railway despliega automáticamente mediante Dockerfile.

Variables de entorno

Fuentes de datos

• Entradas BIC/SWIFT: Mapeo BIC-LEI de GLEIF

• Enriquecimiento LEI: API de GLEIF

• Nombres de países: API Intl.DisplayNames de Node.js

Licencia

MIT