Tools

El servidor expone 176 tools sobre 27 familias de recurso. Cada una despacha in-process al endpoint de /v1 que ya implementa la operación, así que filtros, validación, reglas de upsert y aislamiento por organización son exactamente los de la API REST — la tool es el endpoint. Las excepciones, dashboards_schemas_get, dashboards_workspaces_list y dashboards_me, responden localmente y están marcadas como tales. Dentro de la organización, los datos viven en workspaces: toda tool de datos acepta un workspace_id opcional.

Cómo leer estas páginas

Cada tool aparece con cuatro datos, en este orden:

dashboards_portal_users_resend_invite · destructive · recurso portal-users · permiso portal-users.update · POST /v1/portal_users/:id/resend

Campo	Significado
read / write / destructive	La anotación que lee el cliente MCP. Una destructive (elimina, suspende, cierra, desactiva, envía un e-mail o invitación) solo se ejecuta después de que el usuario confirma en el formulario que envía el servidor, en la revisión 2026-07-28; un cliente que no puede confirmar recibe confirmation_required.
recurso	La familia de recurso de la tool — lo que agrupa las tools en esta documentación.
permiso	El permiso de panel que la persona que autorizó el cliente debe tener en la organización.
MÉTODO /ruta	El endpoint de /v1 al que despacha la tool, para cruzar con la Referencia de la API.

Argumentos comunes

Aparecen en muchas tools y siempre significan lo mismo.

Argumento	Tipo	Descripción
page	entero	Página, desde 1. Predeterminado 1.
per_page	entero	Ítems por página. Predeterminado 20, máximo 100.
sort_by	string	Columna de orden, en snake_case. Los aceptados están en dashboards_schemas_get.
sort_order	asc | desc	Dirección. Un valor que no es dirección es un error, no un desc silencioso.
fields	string[]	Columnas a devolver. Omitido, vuelve el recurso entero; id siempre vuelve.
filters	object	Filtros adicionales, reenviados al endpoint. No acepta paginación, ordenación (page, per_page, sort_by, sort_order, limit, cursor, sort) ni un filtro que la tool ya nombra — esos van como argumento nombrado; dentro de filters se rechazan con VALIDATION_ERROR.
idempotency_key	string	Protección contra reintentos, enviada como X-Idempotency-Key.
custom_metadata	object	JSON libre tuyo, devuelto en cada lectura y en cada webhook.

El catálogo

Familia	Tools	read	write	destructive
ai-usage — Uso de IA	1	1	0	0
api-keys — Claves de API	7	2	2	3
assets — Archivos	7	3	3	1
audit-logs — Auditoría	3	3	0	0
backups — Backups	7	3	1	3
data-purges — Purga de datos	2	2	0	0
entities — Entidades	20	10	8	2
events — Eventos	2	2	0	0
exports — Exportaciones	4	3	1	0
imports — Importaciones	3	2	0	1
integrations — Fuentes de datos	19	5	11	3
maintenance — Mantenimiento	1	0	0	1
notifications — Notificaciones	4	2	0	2
portal-builder — Constructor del portal	9	2	3	4
portal-custom-domains — Dominios propios	5	2	1	2
portal-oauth-providers — Proveedores de inicio de sesión	5	1	2	2
portal-settings — Configuración del portal	7	2	3	2
portal-users — Usuarios del portal	11	4	2	5
rate-limits — Límites de solicitudes	1	1	0	0
roles — Roles del equipo	6	2	3	1
settings — Organización y esquemas	6	4	2	0
templates — Plantillas de e-mail	15	5	7	3
usage — Consumo	1	1	0	0
users — Usuarios del panel	10	4	2	4
webhook-deliveries — Entregas de webhook	2	2	0	0
webhooks — Webhooks	9	3	2	4
workspaces — Workspaces	9	5	3	1

Una tool que no puedes ejecutar no aparece en tools/list. Si falta alguna de esta página, ve Autenticación.