QvaPay API
Agentes IA (MCP)

Agentes IA (MCP)

Conecta tu cuenta de QvaPay a un agente de IA para que consulte tu saldo, tus movimientos y el mercado.

QvaPay tiene un servidor MCP remoto. MCP es el estándar con el que los agentes de IA usan herramientas externas: conectas el servidor una vez y el agente puede preguntar a QvaPay lo que necesita.

El servidor está en beta y es de solo lectura. Un agente puede consultar, pero no puede mover dinero, retirar, comprar ni operar en P2P.

https://mcp.qvapay.com

Antes de empezar

Necesitas una cuenta con la verificación de identidad aprobada. Las cuentas de staff no pueden conectarse.

Lo que consulte el agente pasa por el proveedor de IA que elijas. Conecta solo agentes en los que confíes.

Crea un token

  1. Abre Ajustes → Agentes IA.
  2. Ponle un nombre que te ayude a reconocerlo y elige cuándo caduca, un año como máximo.
  3. Copia el token. Solo se enseña una vez.

El token lleva el permiso mcp:read: solo funciona en este servidor y ninguna ruta de la API lo acepta. Si se filtra, lo revocas desde esa misma pantalla.

Conecta tu cliente

Estos clientes aceptan el token en una cabecera. Cambia <TU_TOKEN> por el tuyo.

Claude Code

claude mcp add --transport http qvapay https://mcp.qvapay.com --header "Authorization: Bearer <TU_TOKEN>"

Cursor

En .cursor/mcp.json:

{
  "mcpServers": {
    "qvapay": {
      "url": "https://mcp.qvapay.com",
      "headers": { "Authorization": "Bearer <TU_TOKEN>" }
    }
  }
}

OpenClaw

Guarda el token en la variable de entorno QVAPAY_MCP_TOKEN y ejecuta:

openclaw mcp set qvapay '{"url":"https://mcp.qvapay.com","transport":"streamable-http","headers":{"Authorization":"Bearer ${QVAPAY_MCP_TOKEN}"}}'

API de Grok

En tools, dentro de tu petición a la API de xAI:

{
  "type": "mcp",
  "server_url": "https://mcp.qvapay.com",
  "server_label": "qvapay",
  "authorization": "<TU_TOKEN>"
}

ChatGPT, Claude y Grok en la web

Estos clientes solo aceptan iniciar sesión con OAuth, que todavía no está disponible.

Errores

CódigoQué significa
401Falta el token, no es válido, caducó o no es un token de agentes. Un token de sesión o de la API no sirve aquí.
403La cuenta no puede usar el servidor. Si falta la verificación de identidad, el mensaje lo indica.
404El servidor no está disponible para nadie en este momento.
429Más de 60 peticiones por minuto con el mismo token. Respeta Retry-After.

Las herramientas están en Herramientas.