¿Qué es PayPal MCP Server?
PayPal aloja su servidor en https://mcp.paypal.com, con un sandbox en https://mcp.sandbox.paypal.com. La entrada de PayPal en el registro oficial de MCP indica las rutas /mcp (Streamable HTTP) y /sse; la documentación para desarrolladores, actualizada por última vez el 30 de junio de 2026, sigue mostrando /http y /sse, que se usan a través de mcp-remote con un inicio de sesión de PayPal o un bearer token generado a partir del client ID y el secreto de tu app.
Una versión local se ejecuta con npx -y @paypal/mcp --tools=all (Node 18+), un PAYPAL_ACCESS_TOKEN y PAYPAL_ENVIRONMENT con el valor SANDBOX o PRODUCTION. Su última versión en npm fue la 1.8.1, del 28 de octubre de 2025, y el repositorio de GitHub no ha tenido commits desde entonces.
Las 30 herramientas cubren facturas (crear, enviar, recordar, cancelar, códigos QR), pedidos, pagos y reembolsos, disputas, seguimiento de envíos, productos del catálogo, planes de suscripción y suscripciones, y el listado de transacciones.
Cómo instalar PayPal MCP Server
https://mcp.paypal.com/mcp¿Merece la pena PayPal MCP Server?
Sobre el papel, el servidor se ocupa de lo que los comercios de PayPal quieren delegar: redactar y enviar facturas, reclamar las impagadas, consultar pedidos, emitir reembolsos y revisar disputas. El endpoint de sandbox es de agradecer y permite probar prompts antes de tocar dinero real.
En la práctica, el proyecto parece abandonado. El paquete de código abierto no ha cambiado desde la versión 1.8.1, de octubre de 2025, el repositorio tiene 13 estrellas y una incidencia abierta de julio de 2026 indica que el endpoint de autorización OAuth del servidor alojado devuelve HTTP 500 en todas las peticiones, tanto en producción como en sandbox. Otra incidencia abierta dice que create_invoice rechaza argumentos construidos a partir de su propio esquema publicado. El registro y la documentación no coinciden en la ruta del endpoint, y el 26 de octubre una petición simple a la ruta documentada /http devolvió 404 mientras que /mcp respondió con una solicitud de autenticación, así que la ruta del registro es la que hay que configurar.
La vía local sigue funcionando con un token, aunque con fricción. Los tokens de acceso de producción duran ocho horas, así que alguien tiene que regenerar PAYPAL_ACCESS_TOKEN a partir del client ID y el secreto, y el token lleva todos los permisos que tenga la app REST. No hay modo de solo lectura ni filtro de herramientas más allá del indicador --tools.
Los controles de seguridad son escasos para un servidor que mueve dinero. No hay paso de aprobación humana: create_refund, pay_order y accept_dispute_claim actúan de inmediato, y aceptar una disputa supone darla por perdida. Activa la aprobación por herramienta en tu cliente. En un servidor que puede dar por perdida una disputa, con su comisión de $15, en una sola llamada, esa carencia importa más que el número de herramientas.
Dónde se gana su sitio
Una empresa de jardinería de dos personas que factura a través de PayPal
Crear y enviar facturas desde un chat en lugar del panel de PayPal
Pide al agente que redacte una factura para un cliente y un importe concretos, revísala y envíala. El servidor es gratis; cada factura pagada cuesta la comisión estándar del 3,49 % más una cuota fija para los pagos con PayPal checkout, o del 2,99 % más una cuota fija para las tarjetas.
Un desarrollador en una pequeña tienda de comercio electrónico
Hacer un prototipo de agente que concilie pedidos y reembolsos en sandbox
Ejecuta npx @paypal/mcp contra SANDBOX con un token de corta duración y prueba list_transactions, get_order y create_refund. Prevé renovar el token cada pocas horas y aprobar cada llamada antes de pasar a producción.
Una responsable de operaciones en una empresa de cajas por suscripción
Revisar las disputas abiertas cada mañana
list_disputes y get_dispute dan un resumen para priorizar; deja accept_dispute_claim sujeta a aprobación manual, ya que aceptar supone dar el caso por perdido. Las comisiones por disputa en EE. UU. son de $15 cada una con los precios estándar.
Antes de decidirte
- Puesta en marcha
- Alojado: apunta mcp-remote al endpoint de sandbox o de producción e inicia sesión en PayPal en el navegador, o pasa un bearer token. Local: npx -y @paypal/mcp --tools=all con un token de acceso del Developer Dashboard. Documentado para Claude Desktop, Cursor, Cline y GitHub Copilot.
- Integraciones
- 30 herramientas: siete para facturas, cinco para pedidos, pagos y reembolsos, tres para disputas, dos para seguimiento de envíos, cuatro para productos del catálogo, ocho para suscripciones y planes, y list_transactions. La mayoría de las herramientas de escritura actúan de inmediato.
- Datos y privacidad
- El servidor puede hacer todo lo que pueda la app REST de PayPal o la cuenta con sesión iniciada, incluidos reembolsos y pagos. El servidor alojado ve todas las peticiones; PayPal no publica condiciones de retención específicas para MCP y el repositorio no tiene política de seguridad, algo que pide una incidencia abierta.
- Coste a escala
- El servidor no tiene cuota. Las comisiones estándar de PayPal se aplican a lo que crea: en EE. UU., facturación al 3,49 % más una cuota fija para PayPal checkout, 2,99 % para tarjetas y $15 por disputa. PayPal no publica límites de uso de la API y limita con HTTP 429 el tráfico que considera abusivo.
- Límites
- Sin informes más allá de list_transactions, sin herramientas de pagos a terceros ni de saldo, OAuth alojado con fallos reportados y tokens de producción que caducan a las ocho horas.
Lo bueno
- Endpoint de sandbox para probar sin riesgo
- 30 herramientas para facturas, reembolsos, disputas y suscripciones
- Opciones alojada y local
Lo malo
- Ninguna versión en npm ni commit desde octubre de 2025
- OAuth alojado con fallos reportados desde julio de 2026
- Sin paso de aprobación para reembolsos, pagos o aceptación de disputas
- Los tokens locales caducan a las ocho horas
Ideal para
Comercios de PayPal que quieren que un asistente gestione facturas y consulte transacciones.
Alternativas a PayPal MCP Server
PayPal MCP Server: preguntas frecuentes
- ¿Merece la pena PayPal MCP Server?
- El servidor oficial de PayPal cubre las tareas adecuadas para un comercio, pero el paquete local lleva un año congelado y una incidencia abierta desde julio indica que falla el inicio de sesión del servidor alojado. Le damos un 3.4 sobre 5.
- ¿Cuánto cuesta PayPal MCP Server?
- Conectarlo es gratis; se aplican las comisiones normales de PayPal.
- ¿Qué inconvenientes tiene PayPal MCP Server?
- Ninguna versión en npm ni commit desde octubre de 2025; oAuth alojado con fallos reportados desde julio de 2026; sin paso de aprobación para reembolsos, pagos o aceptación de disputas; los tokens locales caducan a las ocho horas.
- ¿Para quién es PayPal MCP Server?
- Comercios de PayPal que quieren que un asistente gestione facturas y consulte transacciones.
- ¿Cuánto cuesta PayPal MCP Server para un equipo o en producción?
- El servidor no tiene cuota. Las comisiones estándar de PayPal se aplican a lo que crea: en EE. UU., facturación al 3,49 % más una cuota fija para PayPal checkout, 2,99 % para tarjetas y $15 por disputa. PayPal no publica límites de uso de la API y limita con HTTP 429 el tráfico que considera abusivo.
- ¿Es PayPal MCP Server seguro para los datos de la empresa?
- El servidor puede hacer todo lo que pueda la app REST de PayPal o la cuenta con sesión iniciada, incluidos reembolsos y pagos. El servidor alojado ve todas las peticiones; PayPal no publica condiciones de retención específicas para MCP y el repositorio no tiene política de seguridad, algo que pide una incidencia abierta.
- ¿Cuáles son las mejores alternativas a PayPal MCP Server?
- Las alternativas más cercanas que hemos analizado son Stripe MCP y Square MCP Server.
Respuestas comprobadas el 26 oct 2026.