> ## Documentation Index
> Fetch the complete documentation index at: https://docs.squarecloud.app/llms.txt
> Use this file to discover all available pages before exploring further.

# Herramientas del MCP de Square Cloud

> Las 49 herramientas del servidor MCP de Square Cloud por área, con el scope que necesita cada una.

El servidor MCP tiene 49 herramientas. Un cliente solo ve las que cubren los [scopes](https://docs.squarecloud.app/es/mcp/permissions-and-safety.md#scopes) de su clave. Las herramientas identifican una aplicación por su ID, su nombre exacto o su hostname, y una base de datos por su ID o su nombre. Cada herramienta responde un JSON con `ok`, un `summary` y, cuando algo falló o te necesita, un `code`.

Cada herramienta [se ejecuta al instante](https://docs.squarecloud.app/es/mcp/permissions-and-safety.md#cada-cambio-se-ejecuta-al-instante). Eliminar una aplicación o una base de datos y restaurar un snapshot toman primero un [snapshot de seguridad](https://docs.squarecloud.app/es/mcp/permissions-and-safety.md#eliminaciones-y-restauraciones).

## 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` |
| `upload_application` | Crea y hace deploy de una aplicación nueva a partir de un zip de un proyecto que ya tienes, enviado en base64 (hasta 1 MB). El [archivo de configuración](https://docs.squarecloud.app/es/getting-started/config-file.md) `squarecloud.app` debe estar en la raíz del zip, no dentro de una carpeta. | `apps:write` |
| `commit_application` | Envía una nueva versión a una aplicación existente, como archivos de texto o como zip (hasta 1 MB), a la carpeta que elijas (la raíz por defecto). Los archivos con el mismo nombre se reemplazan y no se borra nada más. No reinicia la aplicación y, con `snapshot`, toma un snapshot antes. | `files:write` (con `snapshot`, también `snapshots: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](https://docs.squarecloud.app/es/getting-started/config-file.md) campo por campo: nombre visible, descripción, memoria, reinicio automático, subdominio, `MAIN` y `START`. | `files:write` |

Los cambios en los archivos se aplican en el siguiente reinicio. En el archivo de configuración, la memoria y el subdominio se aplican al instante, y `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` y `envs:write` |
| `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 scope `mcp`.

| 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](https://help.squarecloud.app) 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](https://squarecloud.app/es/dashboard/activity). |


This documentation is built and hosted on [Mintlify](https://mintlify.com), a developer documentation platform.