ok, un summary y, cuando algo falló o te necesita, un code.
Cada herramienta se ejecuta al instante. Eliminar una aplicación o una base de datos y restaurar un snapshot toman primero un snapshot de seguridad.
Aplicaciones
| Herramienta | Qué hace | Scope |
|---|---|---|
list_applications | Lista tus aplicaciones (ID, nombre, lenguaje, si está en ejecución, dominio), 100 por página. | apps:read |
get_application_status | Estado en vivo de una aplicación: CPU, RAM, tiempo de actividad, dirección, dominio personalizado, memoria y reinicio automático. | apps:read |
get_all_applications_status | Si cada una de tus aplicaciones está en ejecución, en una sola llamada. | apps:read |
get_application_logs | Los logs más recientes de una aplicación, aproximadamente los últimos 4.000 caracteres. | apps:read |
get_deployments | Historial de deploys de Git (GitHub App o webhook) de una aplicación: commit, rama, resultado, duración y el error de un deploy fallido. | apps:read |
get_metrics_history | Historial de CPU y RAM de una aplicación o base de datos, con valores promedio, máximo y más reciente. 24 horas, o 7 días en Pro y Enterprise (en una aplicación, solo con 512 MB o más). | apps:read o databases:read |
start_application | Inicia una aplicación detenida. | apps:control |
stop_application | Detiene una aplicación en ejecución. | apps:control |
restart_application | Reinicia una aplicación, lo que también aplica los cambios de archivos y de configuración. | apps:control |
create_application | Crea y hace deploy de una aplicación nueva a partir de una plantilla inicial (Node.js, Python, sitio estático, Go, Rust, Elixir, .NET, PHP o Ruby), opcionalmente con tus primeros archivos. | apps:write |
delete_application | Elimina una aplicación, con un snapshot de seguridad antes. | apps:write |
Archivos y configuración
| Herramienta | Qué hace | Scope |
|---|---|---|
list_files | Lista una carpeta de una aplicación. | files:read |
read_file | Lee un archivo de texto de hasta 10 MB, página por página. | files:read |
search_files | Busca texto o una expresión regular en los archivos de una aplicación, omitiendo node_modules, .git, la salida de build, los archivos de bloqueo y los binarios. | files:read |
create_file | Escribe un archivo con su contenido completo (hasta 128 KB), creando sus carpetas. Reemplaza un archivo que ya existe. | files:write |
edit_file | Reemplaza el contenido de un archivo existente (hasta 128 KB). | files:write |
patch_file | Edita un archivo de hasta 10 MB con ediciones exactas de buscar y reemplazar. Si una edición no coincide, no se escribe nada. | files:write |
rename_file | Renombra o mueve un archivo o una carpeta. | files:write |
delete_file | Elimina un archivo o una carpeta. Se niega con la raíz de la aplicación, el archivo de configuración y los archivos .env. | files:write |
edit_config_file | Cambia el archivo de configuración campo por campo: nombre visible, descripción, memoria, reinicio automático, subdominio, MAIN y START. | files:write |
MAIN y START en el siguiente reinicio.
Variables de entorno
| Herramienta | Qué hace | Scope |
|---|---|---|
list_env_vars | Lista los nombres de las variables de entorno de una aplicación, nunca sus valores. | envs:read |
set_env_vars | Añade, cambia o elimina variables en una sola llamada, con un reinicio opcional. | envs:write (con restart, también apps:control) |
Snapshots
| Herramienta | Qué hace | Scope |
|---|---|---|
list_snapshots | Snapshots de una aplicación o base de datos, del más reciente al más antiguo. Sin un objetivo, una vista general de la cuenta, incluidas las aplicaciones eliminadas cuyos snapshots siguen existiendo. | snapshots:read |
create_snapshot | Toma un snapshot de una aplicación o base de datos. Cuenta para el límite diario de snapshots de tu plan. | snapshots:write |
restore_snapshot | Restaura una aplicación o base de datos existente a un snapshot, después de un snapshot de su estado actual. | snapshots:write |
Bases de datos
| Herramienta | Qué hace | Scope |
|---|---|---|
list_databases | Lista tus bases de datos (ID, nombre, motor, RAM, host, puerto, si está en ejecución). | databases:read |
create_database | Crea una base de datos (planes Standard y superiores), lo que tarda hasta unos 90 segundos. Con connect_to_app, también escribe la URL de conexión y el archivo del certificado en una aplicación. | databases:write (con connect_to_app, también databases:credentials y envs:write) |
start_database | Inicia una base de datos detenida. | databases:write |
stop_database | Detiene una base de datos en ejecución. Las aplicaciones que la usan pierden la conexión hasta que se inicie de nuevo. | databases:write |
update_database | Cambia la RAM de una base de datos, aplicada en vivo. | databases:write |
connect_database | Conecta una base de datos existente a una aplicación: rota su contraseña, escribe la nueva URL y el certificado en la aplicación, y actualiza las demás aplicaciones que la usan. | databases:credentials y envs:write |
rotate_database_credentials | Rota la contraseña o el certificado TLS de una base de datos e indica las aplicaciones que actualizó. | databases:credentials |
delete_database | Elimina una base de datos y sus datos, con un snapshot de seguridad antes. | databases:write |
Dominios y red
Las herramientas de red funcionan con sitios web (aplicaciones con un dominio), en intervalos de hasta 7 días.| Herramienta | Qué hace | Scope |
|---|---|---|
list_account_domains | Todos los dominios de todas las aplicaciones: direcciones squareweb.app y dominios personalizados, 100 por página. | apps:read |
list_dns_records | Los registros DNS que hay que crear para el dominio personalizado de una aplicación, con su estado. | apps:read |
set_custom_domain | Conecta, reemplaza o elimina el dominio personalizado de una aplicación y devuelve los registros DNS que hay que crear. | apps:write |
purge_network_cache | Purga la caché del edge de hasta 50 aplicaciones en una sola llamada. | apps:write |
get_network_analytics | Tráfico del edge: solicitudes, visitas y bytes, con desgloses por país, ruta, referer, dispositivo y más. | apps:read |
get_network_errors | Errores HTTP del edge por código de estado, ruta y método. 5xx por defecto, 4xx si se piden. | apps:read |
get_network_performance | Tiempo hasta el primer byte y tiempo de respuesta del origen (p50, p95, p99) y las rutas más lentas. Pro y Enterprise. | apps:read |
get_network_logs | Las 40 solicitudes más recientes al edge, con las direcciones IP enmascaradas. Pro y Enterprise. | apps:read |
Workspaces
| Herramienta | Qué hace | Scope |
|---|---|---|
list_workspaces | Los workspaces de los que eres dueño o miembro, con sus miembros y las aplicaciones compartidas. Solo lectura: las demás herramientas solo llegan a tus propias aplicaciones. | workspaces:manage |
Ayuda y estado
Estas herramientas solo necesitan el scopemcp.
| Herramienta | Qué hace | Scope |
|---|---|---|
get_platform_knowledge | La referencia propia de Square Cloud sobre límites, planes, códigos de error y configuración. | mcp |
search_help_center | Busca en el centro de ayuda o lee uno de sus artículos. | mcp |
list_help_center | Lista todos los artículos del centro de ayuda por categoría. | mcp |
get_platform_status | El estado de los servicios de Square Cloud y de los proveedores de los que dependen. | mcp |
get_discord_status | El estado propio de Discord y la latencia de su API, para distinguir una caída de Discord de un problema del bot. | mcp |
Excluido a propósito
| No disponible | Por qué | En su lugar |
|---|---|---|
| Descargar snapshots | El enlace firmado contiene tu código y tus variables de entorno, y terminaría en la conversación y en manos del proveedor del modelo de IA. | Descárgalo desde el dashboard. |
| Descargar certificados de bases de datos | Por el mismo motivo: el certificado saldría de Square Cloud a través del modelo. | Descárgalo desde el dashboard. |
| Actividad de la cuenta | Muestra las direcciones IP y los dispositivos de tu cuenta. | Consulta tu registro de actividad. |