Conecta Claude, Cursor o Codex

https://api.listo.delivery/mcp

​

Conecta tu cliente

export LISTO_API_KEY="tu llave aquí"

​

Claude Code

claude mcp add --transport http listo https://api.listo.delivery/mcp --header 'Authorization: Bearer ${LISTO_API_KEY}'

​

Cursor

{
  "mcpServers": {
    "listo": {
      "url": "https://api.listo.delivery/mcp",
      "headers": {
        "Authorization": "Bearer ${env:LISTO_API_KEY}"
      }
    }
  }
}

​

Codex

codex mcp add listo --url https://api.listo.delivery/mcp --bearer-token-env-var LISTO_API_KEY

​

ChatGPT

​

Qué puede hacer el asistente

​

Cuenta y saldo

​

Tiendas

​

Envíos

​

Retiros

​

Planes

​

Registros, eventos y webhooks

​

Comentarios

​

Nada mueve dinero hasta que lo digas

1. La vista previa. El asistente llama la herramienta con los detalles. No pasa nada. Recibe lo que pasaría (en una reserva: el precio, la tienda, el destino) y un confirmation_token, y te lo muestra.
2. La confirmación. Solo cuando tú apruebas, llama la herramienta otra vez con exactamente los mismos argumentos más confirm: true y el token. Ese es el momento en que se mueve el dinero.

• Reservar siempre usa una cotización. create_delivery exige el quote_id de quote_delivery, así que el precio que te mostraron es el precio que se reserva. Si la cotización venció o ya se usó, la reserva se rechaza y el asistente cotiza de nuevo.
• Un token sirve una vez y por diez minutos. Pertenece a tu llave, a esa herramienta y a esos argumentos exactos: si cambias el monto o el envío, el token se rechaza, y el error no lo gasta. Un token que nadie usó se rechaza como confirmation_expired cuando pasan los diez minutos: pide una vista previa nueva.
• Confirmar de nuevo nunca actúa dos veces. Si se confirma el mismo token otra vez, por ejemplo porque el asistente reintentó tras una conexión caída, devuelve el primer resultado y no reserva, cancela ni retira nada por segunda vez. Esa repetición se mantiene 24 horas después de que el token venció. Pasado ese tiempo el registro ya no existe y confirmar responde confirmation_not_found: que el asistente lea primero el recurso (por ejemplo con get_delivery) antes de pedir una vista previa nueva.
• Una llave de solo lectura no recibe vista previa. Con una llave de solo lectura, una herramienta que pide confirmación se rechaza desde el primer paso con read_only_key y no se emite ningún token, porque la confirmación solo podría fallar. Enviar comentarios con submit_feedback sí sigue funcionando.

​

Límites y registros

• Una llamada a una herramienta es una petición a la API contra los límites de tu llave, los mismos de siempre (ve sal a producción). Al pasarte de un límite, el asistente recibe rate_limited. Cualquier error que le pida esperar (rate_limited, resend_limit_reached y test_webhook_limit_reached) trae retry_after_seconds, los segundos que debe esperar antes de reintentar la misma llamada.
• Cada llamada a una herramienta aparece en tus registros de la API como cualquier petición /v1/, excepto submit_feedback, que no llama a ninguna ruta /v1/, y una vista previa que se le rechazó a una llave de solo lectura, que nunca llega a una.
• Los errores son los de la API: el asistente ve el mismo code y el mismo retryable que verías tú, y decide con ellos de la misma manera. Cada error trae además un doc_url y un request_id, que es el X-Request-Id de esa respuesta de /mcp.

​

Cuando las herramientas no alcanzan