Conecta agentes de IA con @vexpay/mcp

Servidor MCP oficial: permite que Claude Code, Claude Desktop, Cursor y otros agentes consulten saldos, pagos, pagos a terceros y suscripciones, y creen sesiones de checkout, links de pago y suscripciones send_invoice. No mueve dinero.

Instalación

Usa tu clave de Prueba mientras lo pruebas. El servidor corre localmente por stdio y requiere Node.js 20 o superior.

Claude Codebash

claude mcp add vexpay --env VEXPAY_API_KEY=tu_clave_de_prueba -- npx -y @vexpay/mcp

Claude Desktop / Cursorjson

{
  "mcpServers": {
    "vexpay": {
      "command": "npx",
      "args": ["-y", "@vexpay/mcp"],
      "env": { "VEXPAY_API_KEY": "tu_clave_de_prueba" }
    }
  }
}

Variable	Requerida	Descripción
VEXPAY_API_KEY	Sí	Tu clave de API. Nunca aparece en las respuestas ni en los logs.
VEXPAY_BASE_URL	No	Origen de la API. Por defecto https://api.pay.vexwallet.co.
VEXPAY_MCP_ALLOW_LIVE	No	Pon 1 para habilitar las herramientas de escritura en una cuenta en vivo.

Cuentas de prueba y en vivo

Al iniciar, el servidor consulta a VEXPay si la clave pertenece a una cuenta de prueba o en vivo. En una cuenta de prueba todas las herramientas están disponibles. En una cuenta en vivo solo las de lectura, salvo que pongas VEXPAY_MCP_ALLOW_LIVE=1. Si no se puede determinar el modo, el servidor asume en vivo.

Herramientas

Herramienta	Tipo	Qué hace
`vexpay_get_balance`	Lectura	Saldo VES de la plataforma
`vexpay_get_stablecoin_balances`	Lectura	Saldos USDT y USDC
`vexpay_list_banks`	Lectura	Bancos venezolanos y servicios soportados
`vexpay_get_fx_quote`	Lectura	USD → VES a tu tasa del bolívar
`vexpay_get_payment`	Lectura	Un pago por id o externalRef
`vexpay_list_payouts / vexpay_get_payout`	Lectura	Pagos a terceros (paginados) y uno por id o externalRef
`vexpay_list_conversions / vexpay_get_conversion`	Lectura	Conversiones VES → USDT
`vexpay_get_cop_payment / vexpay_get_cop_balance`	Lectura	Pagos y saldo en pesos colombianos
`vexpay_list_stablecoin_networks`	Lectura	Redes habilitadas, comisiones y disponibilidad
`vexpay_get_checkout_session`	Lectura	Una sesión de checkout
`vexpay_list_products / vexpay_list_payment_links`	Lectura	Productos y sus links de pago
`vexpay_list_webhook_endpoints`	Lectura	Tus endpoints de webhook
`vexpay_list_customers / vexpay_get_customer`	Lectura	Clientes de facturación (paginados) y uno por id
`vexpay_list_customer_payment_methods / vexpay_get_payment_method`	Lectura	Los métodos de pago por domiciliación de un cliente y uno por id (estado, bankCode, últimos 4 dígitos del teléfono)
`vexpay_list_prices / vexpay_get_price`	Lectura	Precios recurrentes en USD y uno por id
`vexpay_list_subscriptions / vexpay_get_subscription`	Lectura	Suscripciones con su estado, forma de cobro, período y última factura
`vexpay_list_invoices / vexpay_get_invoice`	Lectura	Facturas de suscripciones con sus intentos de cobro y la URL de su página de pago
`vexpay_get_setup_session`	Lectura	Una sesión de autorización de domiciliación: abierta, completada o vencida
`vexpay_create_checkout_session`	Escritura	Sesión de checkout con URL de pago alojada
`vexpay_create_product / vexpay_create_payment_link`	Escritura	Producto y su link de pago
`vexpay_create_deposit_address`	Escritura	Dirección de depósito stablecoin para un cliente
`vexpay_quote_conversion`	Escritura	Tasa VES → USDT fija por 60 s (no ejecuta nada)
`vexpay_send_test_webhook`	Escritura	Envío notification.test a tus endpoints
`vexpay_create_customer`	Escritura	Cliente de facturación para suscribirlo a un precio
`vexpay_create_price`	Escritura	Precio recurrente en USD de un producto
`vexpay_create_subscription`	Escritura	Suscripción send_invoice: las facturas se envían por correo al cliente. Nunca cobra automáticamente; para charge_automatically usa la API
`vexpay_create_setup_session`	Escritura	Página de 24 horas donde el cliente autoriza la domiciliación (no cobra nada)

37 herramientas: 27 de lectura y 10 de escritura. Las de facturación se explican en Suscripciones y facturación y Débito automático.

Las herramientas de escritura aceptan un idempotencyKey opcional. Reutilízalo al reintentar para que el registro se cree una sola vez. Las llamadas fallidas devuelven el estado HTTP, el código de error, el mensaje y el id de la solicitud.