# MCP de pagos

> Conecta Claude, ChatGPT o Cursor a Pagos Express. Doce herramientas para crear y editar enlaces de cobro, registrar pagos, consultar cobros y compartir por correo — con OAuth o clave API.

HTML: https://pagos.express/mcp
Texto para modelos: https://pagos.express/mcp.llms.txt

El MCP de Pagos Express expone las operaciones de cobro como herramientas Model Context Protocol.

## Endpoints
- Pruebas: https://api.pagos.express/mcp/test — `sk_test_…` o OAuth `pagos:test`
- En vivo: https://api.pagos.express/mcp — `sk_live_…` o OAuth `pagos:live`

Transporte: Streamable HTTP, POST. GET/DELETE al protocolo responden 405. https://pagos.express/mcp es esta página de marketing; el servidor MCP vive en https://api.pagos.express.

## Herramientas
- `create_payment_link` (POST /v1/payment_links): Crea un cobro con conceptos e importes. Devuelve la URL para compartir; no cobra ni envía correo por sí solo.
- `list_payment_links` (GET /v1/payment_links): Lista los enlaces del entorno actual, con paginación por cursor.
- `get_payment_link` (GET /v1/payment_links/{id}): Consulta un enlace y su estado.
- `disable_payment_link` (POST /v1/payment_links/{id}/disable): Desactiva un enlace. No reembolsa pagos ya cobrados.
- `update_payment_link` (POST /v1/payment_links/{id}): Edita título, descripción, datos del cliente o si es facturable un enlace activo. Conceptos e importes no cambian.
- `mark_payment_link_paid` (POST /v1/payment_links/{id}/mark_paid): Registra un pago recibido fuera del checkout (transferencia, efectivo). Cierra el enlace y dispara los webhooks. Pide confirmación al usuario.
- `list_payments` (GET /v1/payments): Lista pagos. Solo el estado succeeded confirma fondos recibidos.
- `get_payment` (GET /v1/payments/{id}): Consulta el estado de un pago concreto.
- `sync_payment` (POST /v1/payments/{id}/sync): Verifica el pago con su pasarela y actualiza el estado.
- `send_payment_link_email` (POST /v1/payment_links/{id}/email): Envía el enlace por correo si el usuario lo autoriza. En pruebas no se entrega correo real.
- `list_payment_link_emails` (GET /v1/payment_links/{id}/emails): Consulta las últimas entregas de correo de un enlace.
- `list_connections` (GET /v1/connections): Lista proveedores conectados. No expone credenciales.
- `get_invoicing_connection` (GET /v1/invoicing/connection): Consulta la conexión con CFDI Express y el emisor (RFC) que factura.
- `get_invoicing_catalogs` (GET /v1/invoicing/catalogs): Catálogos SAT de régimen fiscal y uso de CFDI para validar los datos del receptor.
- `get_payment_invoice` (GET /v1/payments/{id}/invoice): Consulta si un pago se puede facturar, el enlace de autofacturación y su factura.
- `invoice_payment` (POST /v1/payments/{id}/invoice): Timbra el CFDI de un pago con los datos fiscales del cliente. Confirma los datos con el usuario.
- `get_payment_invoice_files` (GET /v1/payments/{id}/invoice/files): Devuelve el PDF y el XML de la factura (enlaces que caducan en 15 minutos).
- `cancel_payment_invoice` (POST /v1/payments/{id}/invoice/cancel): Pide al SAT cancelar la factura de un pago. Pide autorización al usuario; no reembolsa.

## Autenticación
OAuth (consentimiento y revocación en /agent-access) o Bearer con clave API mostrada una sola vez. El entorno lo fija la credencial, no un argumento. Las herramientas no devuelven secretos.

## Importes
Enteros en centavos. MX$1,500.00 = 150000. Crear un enlace no cobra; solo `succeeded` confirma el pago.

## FAQ

**¿Qué es un MCP de pagos?**
MCP (Model Context Protocol) es un protocolo para que un agente de IA use herramientas de un servidor remoto. El MCP de Pagos Express expone crear y consultar enlaces de pago, revisar cobros, sincronizar con Stripe y enviar el link por correo. El agente no procesa tarjetas: tu cliente paga en la página pública.

**¿Cómo lo conecto a Claude, ChatGPT o Cursor?**
Agrega un servidor MCP remoto con la URL de pruebas o en vivo. Si el cliente admite OAuth, elige esa opción: iniciarás sesión y revisarás permisos en la pantalla de consentimiento. Si no, usa una clave API como Bearer. La configuración exacta cambia por cliente; nunca pongas la clave en el prompt.

**¿OAuth o clave API?**
OAuth es el canal pensado para agentes: el usuario autoriza y puede revocar el acceso en /agent-access. La clave API (sk_test_… o sk_live_…) sirve para servidores y clientes que solo aceptan un Bearer estático. La clave se muestra una sola vez en el dashboard.

**¿Hay sesiones o secretos en las herramientas?**
No. El servidor es stateless (POST, Streamable HTTP). Las herramientas no devuelven claves, tokens de Stripe ni secretos. list_connections solo muestra metadatos del proveedor.