Tools

O servidor expõe 80 tools sobre 21 famílias de recurso — uma tool por operação da API v1. Cada uma despacha in-process para o endpoint de /v1 que implementa a operação, então validação, filtros, escopo, permissão e isolamento por organização são exatamente os da API REST: a tool é o endpoint.

Como ler estas páginas

Cada tool aparece com cinco fatos:

kadu_tasks_run · destructive · escopo kadu/tasks + write · permissão agent.executions.run · POST /v1/tasks/{id}/run

Campo	Significado
read / write / destructive	A anotação que o cliente MCP lê. Uma destructive (apaga, cancela, roda o agente, reenvia um webhook, gira um segredo, muda quem dispara uma tarefa) só roda depois de você confirmar — no formulário do cliente ou por um link de aprovação (Confirmação de tools destrutivas). destructive (conforme argumentos) pede confirmação só quando os argumentos tornam a chamada destrutiva (um webhook que muda de URL).
escopo	O recurso (kadu/<recurso>) e o verbo que o token precisa carregar: read, write ou delete (as tools *_delete). write não apaga. Veja Autenticação.
permissão	A permissão do console que o papel da pessoa do token precisa ter na organização — a mesma que a API v1 confere (Permissões).
MÉTODO /caminho	O endpoint de /v1 para onde a tool despacha, para cruzar com a referência da API.

Argumentos comuns

Aparecem em muitas tools e significam sempre a mesma coisa.

Argumento	Tipo	Descrição
cursor	string	Cursor opaco do meta.next_cursor da página anterior. Veja Paginação.
limit	inteiro	Itens por página, de 1 a 100. Padrão 25.
sort_by	string	Campo de ordenação: created_at (padrão), updated_at ou um dos campos de filtro.
sort_order	asc | desc	Direção. Padrão desc.
<campo>_gte / <campo>_lte	string	Intervalo (ISO 8601), enviado como campo[gte] / campo[lte].
idempotency_key	string	Enviada como X-Idempotency-Key: repetir a escrita com a mesma chave não a duplica (24 h). Veja Idempotência.
custom_metadata	object	JSON livre seu, devolvido em toda leitura e em todo webhook.

O catálogo

Família	Tools	read	write	destructive
me — Identidade da conexão	1	1	0	0
organizations — Organização	6	3	2	1
users — Usuários	1	1	0	0
memberships — Vínculos	1	1	0	0
roles — Papéis	2	1	1	0
workspaces — Workspaces	5	2	2	1
activities — Atividades	5	2	2	1
tasks — Tarefas	10	4	2	4
executions — Execuções	8	6	0	2
todos — Pendências	1	0	1	0
memories — Memórias	5	2	2	1
environments — Ambientes	5	2	2	1
secrets — Secrets	5	2	2	1
schedules — Agendamentos	5	2	2	1
files — Arquivos	5	3	2	0
repository — Playbook	2	1	1	0
usage — Uso e custo	1	1	0	0
webhooks — Webhooks	6	2	0	4
webhook_deliveries — Entregas de webhook	3	2	0	1
operation_approvals — Aprovações	2	2	0	0
system_events — Eventos de sistema	1	1	0	0

Uma tool que você não pode rodar não aparece em tools/list. Se uma daqui não está lá, veja Autenticação.