Conecta agentes de IA con @vexpay/mcp

Servidor MCP oficial: permite que Claude Code, Claude Desktop, Cursor y otros agentes consulten saldos, pagos y pagos a terceros y creen sesiones de checkout y links de pago. 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.

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_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

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.

Instalación

Cuentas de prueba y en vivo

Herramientas