¿Qué es Square MCP Server?
Square, parte de Block, aloja su servidor MCP en https://mcp.squareup.com/mcp con inicio de sesión OAuth; todavía se sirve un endpoint /sse más antiguo. Solo pueden conectarse clientes aprobados, como protección frente al registro de clientes maliciosos, y la documentación enumera Claude.ai, Claude Desktop, Goose, Cursor y Windsurf. El servidor alojado solo llega a datos de producción, y todo el proyecto sigue marcado como beta.
Para probar en sandbox se ejecuta el servidor local de código abierto con npx square-mcp-server start, un ACCESS_TOKEN y SANDBOX=true. DISALLOW_WRITES=true lo deja en solo lectura y SQUARE_VERSION fija la versión de la API. El paquete de npm no tiene ninguna versión nueva desde la 0.1.2, del 25 de abril de 2025, aunque el README del repositorio se revisó en octubre de 2026 para dirigir a la mayoría de los usuarios al servidor alojado.
En lugar de una herramienta por endpoint, tiene tres: get_service_info para descubrir los métodos de un servicio, get_type_info para obtener los detalles de los parámetros y make_api_request para llamar a la API. Con eso llega a 38 servicios de Square, entre ellos pagos, reembolsos, pedidos, catálogo, inventario, facturas, liquidaciones, personal y fidelización.
Cómo instalar Square MCP Server
https://mcp.squareup.com/mcp¿Merece la pena Square MCP Server?
Square sigue el mismo camino que las herramientas genéricas de Stripe: tres herramientas que permiten al agente descubrir y llamar a cualquiera de 38 servicios de Square. Eso mantiene corta la lista de herramientas, lo que ayuda cuando varios servidores comparten una ventana de contexto, y permite a un vendedor preguntar por el catálogo, los pedidos, los clientes o las liquidaciones sin esperar a una herramienta específica.
El precio de las herramientas genéricas es que el modelo debe encontrar el método correcto y montar él mismo el cuerpo de la petición, y las issues abiertas muestran dónde falla eso. La issue #20 (abril de 2026) informa de que make_api_request envía arrays vacíos en campos como location_ids, lo que rompe la búsqueda de Orders, y de que no resuelve los parámetros de ruta. La issue #31 (septiembre de 2026) sostiene que la descripción de CreatePayment indica al modelo que genere una clave de idempotencia nueva en cada llamada, así que una petición reintentada podría cobrar dos veces una tarjeta. La issue #27 señala que los nombres genéricos chocan con herramientas de otros servidores, de modo que un modelo a veces dirige a Stripe una pregunta sobre pagos.
El servidor alojado solo llega a producción, lo que encaja mal con el propio consejo de Square de probar antes los prompts en sandbox: hacerlo supone ejecutar el paquete local con un token, y el interruptor de solo lectura DISALLOW_WRITES solo existe allí. La documentación no nombra permisos OAuth para el servidor alojado y no publica límites de peticiones ni condiciones de retención de datos para el endpoint MCP.
Para preguntas de solo lectura sobre el negocio de un vendedor, como los artículos más vendidos del mes pasado o qué facturas están vencidas, el diseño funciona y no cuesta nada aparte de las comisiones normales de Square. Las escrituras que tocan pagos, reembolsos o inventario merecen la aprobación de una persona en cada llamada hasta que se cierren las issues #20 y #31.
Dónde se gana su sitio
La dueña de una cafetería con dos locales en Square
Averiguar qué productos de la carta se vendieron más el mes pasado y cuáles apenas se movieron
En Claude, el agente consulta pedidos y catálogo mediante make_api_request en el servidor alojado. Sin coste extra; aprueba cada llamada, ya que la misma herramienta también puede escribir, y si una búsqueda de Orders falla con location_ids es por el bug abierto #20, no por el prompt.
Un desarrollador que crea una integración de Square para un cliente del comercio minorista
Explorar endpoints de Square que no conoce con datos de prueba
Ejecuta npx square-mcp-server start con SANDBOX=true y DISALLOW_WRITES=true; get_service_info y get_type_info funcionan como una referencia interactiva de la API. Gratuito, y nada toca dinero real.
Antes de decidirte
- Puesta en marcha
- Añade https://mcp.squareup.com/mcp en un cliente aprobado (Claude.ai, Claude Desktop, Goose, Cursor o Windsurf) e inicia sesión con Square; la configuración de Claude Desktop usa npx mcp-remote. Para sandbox, ejecuta npx square-mcp-server start con ACCESS_TOKEN y SANDBOX=true.
- Integraciones
- Tres herramientas: get_service_info y get_type_info para descubrir en solo lectura, y make_api_request para lecturas y escrituras en 38 servicios, entre ellos pagos, reembolsos, pedidos, catálogo, inventario, facturas y liquidaciones.
- Datos y privacidad
- El servidor alojado actúa sobre datos reales de producción mediante OAuth; la documentación no enumera permisos ni condiciones de retención. El servidor local guarda un token de acceso en tu equipo y puede quedar en solo lectura con DISALLOW_WRITES=true.
- Coste a escala
- El servidor es gratuito con licencia Apache-2.0; las comisiones de procesamiento estándar de Square se aplican a cualquier pago que cree. Cada operación suele requerir dos o tres llamadas (descubrir, inspeccionar el tipo y luego hacer la petición), así que el consumo de tokens por tarea es mayor que con herramientas específicas; la documentación de MCP no publica límites de peticiones.
- Límites
- En beta; el servidor alojado es solo de producción; las issues abiertas informan de parámetros de array que se pierden (#20), riesgo de cobro doble en pagos reintentados (#31) y choques de nombres de herramientas con otros servidores (#27).
Lo bueno
- Llega a 38 servicios de Square con tres herramientas
- Servidor alojado con OAuth y una lista de clientes aprobados
- Modo de solo lectura y soporte de sandbox en el servidor local
- La lista corta de herramientas deja sitio en el contexto para otros servidores
Lo malo
- En beta, con un paquete de npm sin cambios desde abril de 2025
- El servidor alojado es solo de producción, sin interruptor de solo lectura
- Bugs abiertos: parámetros de array que se pierden y una redacción sobre idempotencia que puede provocar cobros dobles
- Los nombres genéricos de las herramientas chocan con otros servidores
Ideal para
Vendedores y desarrolladores de Square que quieren que un asistente consulte datos de ventas, pedidos y catálogo.
Alternativas a Square MCP Server
Square MCP Server: preguntas frecuentes
- ¿Merece la pena Square MCP Server?
- Toda la API de Square detrás de tres herramientas: ingenioso para leer datos de ventas, arriesgado para cualquier cosa que mueva dinero mientras sigan abiertos sus bugs de beta. Le damos un 3.6 sobre 5.
- ¿Cuánto cuesta Square MCP Server?
- Gratuito y de código abierto (Apache-2.0); se aplican las comisiones normales de Square.
- ¿Qué inconvenientes tiene Square MCP Server?
- En beta, con un paquete de npm sin cambios desde abril de 2025; el servidor alojado es solo de producción, sin interruptor de solo lectura; bugs abiertos: parámetros de array que se pierden y una redacción sobre idempotencia que puede provocar cobros dobles; los nombres genéricos de las herramientas chocan con otros servidores.
- ¿Para quién es Square MCP Server?
- Vendedores y desarrolladores de Square que quieren que un asistente consulte datos de ventas, pedidos y catálogo.
- ¿Cuánto cuesta Square MCP Server para un equipo o en producción?
- El servidor es gratuito con licencia Apache-2.0; las comisiones de procesamiento estándar de Square se aplican a cualquier pago que cree. Cada operación suele requerir dos o tres llamadas (descubrir, inspeccionar el tipo y luego hacer la petición), así que el consumo de tokens por tarea es mayor que con herramientas específicas; la documentación de MCP no publica límites de peticiones.
- ¿Es Square MCP Server seguro para los datos de la empresa?
- El servidor alojado actúa sobre datos reales de producción mediante OAuth; la documentación no enumera permisos ni condiciones de retención. El servidor local guarda un token de acceso en tu equipo y puede quedar en solo lectura con DISALLOW_WRITES=true.
- ¿Cuáles son las mejores alternativas a Square MCP Server?
- Las alternativas más cercanas que hemos analizado son Stripe MCP, PayPal MCP Server y Shopify Dev MCP.
Respuestas comprobadas el 23 oct 2026.