Tools

El servidor expone 80 tools sobre 21 familias de recurso — una tool por operación de la API v1. Cada una despacha in-process al endpoint de /v1 que implementa la operación, así que validación, filtros, scope, permiso y aislamiento por organización son exactamente los de la API REST: la tool es el endpoint.

Cómo leer estas páginas

Cada tool aparece con cinco datos:

kadu_tasks_run · destructive · scope kadu/tasks + write · permiso agent.executions.run · POST /v1/tasks/{id}/run

Campo	Significado
read / write / destructive	La anotación que lee el cliente MCP. Una destructive (elimina, cancela, ejecuta el agente, reenvía un webhook, rota un secreto, cambia quién dispara una tarea) solo se ejecuta después de que confirmas — en el formulario del cliente o por un enlace de aprobación (Confirmación de tools destructivas). destructive (según los argumentos) pide confirmación solo cuando los argumentos hacen destructiva la llamada (un webhook que cambia de URL).
scope	El recurso (kadu/<recurso>) y el verbo que el token debe llevar: read, write o delete (las tools *_delete). write no elimina. Ve Autenticación.
permiso	El permiso de la consola que el rol de la persona del token debe tener en la organización — el mismo que verifica la API v1 (Permisos).
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
cursor	string	Cursor opaco del meta.next_cursor de la página anterior. Ve Paginación.
limit	entero	Ítems por página, de 1 a 100. Predeterminado 25.
sort_by	string	Campo de orden: created_at (predeterminado), updated_at o uno de los campos de filtro.
sort_order	asc | desc	Dirección. Predeterminado desc.
<campo>_gte / <campo>_lte	string	Intervalo (ISO 8601), enviado como campo[gte] / campo[lte].
idempotency_key	string	Enviada como X-Idempotency-Key: repetir la escritura con la misma clave no la duplica (24 h). Ve Idempotencia.
custom_metadata	object	JSON libre tuyo, devuelto en cada lectura y en cada webhook.

El catálogo

Familia	Tools	read	write	destructive
me — Identidad de la conexión	1	1	0	0
organizations — Organización	6	3	2	1
users — Usuarios	1	1	0	0
memberships — Vínculos	1	1	0	0
roles — Roles	2	1	1	0
workspaces — Workspaces	5	2	2	1
activities — Actividades	5	2	2	1
tasks — Tareas	10	4	2	4
executions — Ejecuciones	8	6	0	2
todos — Pendientes	1	0	1	0
memories — Memorias	5	2	2	1
environments — Ambientes	5	2	2	1
secrets — Secrets	5	2	2	1
schedules — Programaciones	5	2	2	1
files — Archivos	5	3	2	0
repository — Playbook	2	1	1	0
usage — Uso y costo	1	1	0	0
webhooks — Webhooks	6	2	0	4
webhook_deliveries — Entregas de webhook	3	2	0	1
operation_approvals — Aprobaciones	2	2	0	0
system_events — Eventos de sistema	1	1	0	0

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