payments-toolkit-mcp

Un servidor Model Context Protocol (MCP) mínimo, creado como un proyecto de aprendizaje práctico (consulta PLAN.md para la guía completa paso a paso).

Expone utilidades de validación relacionadas con pagos como herramientas MCP y un recurso estático — toda la lógica es local, sin llamadas de red ni necesidad de claves de API.

Herramientas

• validate_card_number — validación de checksum Luhn para un número de tarjeta (solo dígitos, longitud de 8 a 19).

• detect_card_type — identifica la red de la tarjeta (Visa, Mastercard, American Express, Discover, Diners Club, JCB) a partir del prefijo IIN/BIN.

• validate_iban — validación de formato, longitud específica por país y checksum mod-97 según ISO 13616 para un IBAN.

Related MCP server: stripe-mcp-server

Recursos

• card_networks (payments-toolkit://card-networks) — lista JSON estática de las redes de tarjeta compatibles y sus rangos de prefijos.

Requisitos previos

• Node.js 18+ (proyecto desarrollado con la v24)

• pnpm

Configuración

pnpm install
pnpm run build

Uso

Ejecuta el servidor de forma independiente (espera en stdio, así que esto sirve sobre todo para comprobar que funciona):

pnpm run start

Inspecciona y llama a las herramientas/recursos directamente a través de una interfaz web local, sin tener que conectar un cliente:

pnpm run inspect

Conectar con Claude Code

claude mcp add payments-toolkit-mcp -- node /path/to/payments-toolkit-mcp/dist/index.js
claude mcp list

Dentro de una sesión de Claude Code, ejecuta /mcp para confirmar la conexión y ver las herramientas/recursos descubiertos.

Estructura del proyecto

src/
  index.ts                   # composition root: creates the server, wires up transport
  lib/                       # pure validation/lookup logic (no MCP dependency)
    luhn.ts
    card-networks.ts
    iban.ts
    schemas.ts
  tools/                     # one file per registered MCP tool
    validate-card-number.ts
    detect-card-type.ts
    validate-iban.ts
  resources/                 # one file per registered MCP resource
    card-networks.ts

Notas

• Nunca uses console.log en este servidor — stdout está reservado para el flujo del protocolo JSON-RPC a través de stdio. Usa console.error para cualquier salida de depuración.