Listar as ferramentas
O catálogo das ferramentas que um agente pode ter: as dos servidores MCP embutidos e as nativas do runtime, numa lista só, pelo nome qualificado. É o catálogo, igual para todos; o que um agente liga está em /agents/{agent_id}/tools.
Autorização
bearer authenticatedCredencial da v3: o JWT da sessão (o mesmo da v2) ou um token pessoal dom_pat_…. A lista de escopos de cada operação diz o que ela exige: uma capacidade (agents:read), authenticated ou session-only. Segredo de máquina (X-Agent-Secret, X-API-Token, sdk_…) não é aceito.
Em: header
Escopo: authenticated
Parâmetros de consulta
Só as ferramentas deste servidor MCP (o que deixa as nativas de fora).
mcp ou native.
Valor em
- "mcp"
- "native"
read ou write.
Valor em
- "read"
- "write"
Cursor opaco devolvido em page.next_cursor da página anterior. Omita para começar do início.
Tamanho da página. Padrão 50; o máximo é o da coleção: 200, ou até 500 nas coleções de itens pequenos.
int320 <= valueCorpo da resposta
application/json
application/json
curl -X GET "https://example.com/tools"{ "data": [ { "description": "string", "effect": "read", "input_schema": null, "kind": "mcp", "name": "string", "namespace": "string", "parameters": [ "string" ], "qualified_name": "string", "title": "string" } ], "page": { "has_more": true, "next_cursor": "string" }}