← Todas as ferramentas MCP

Get agent roster

get_agent_roster
Somente leitura

O que faz

What each named agent (task_runs.agent_name) has actually done, in one report: runs, minutes and tool calls spent, how many of its tasks a human approved vs rejected, the rejection rate, the impact/value (Task.value) delivered by the approved ones, and tool calls spent per approved task. Runs made with the account's full-access token, and everything predating agent-name attribution, collapse into one agent_name: null bucket rather than being hidden. A decided task with no run of its own in the window isn't guessed at — it's simply not counted. Each entry also carries what that agent holds right now (not windowed), by lane the way next_task resolves it: open (queued, unclaimed), in_progress (under an active claim) and waiting_on_human (tasks at pending_approval/plan_proposed plus open decisions); an agent holding work with no run in the window still appears. Reports only: no score, no gate, nothing written.

Parâmetros

NomeTipoObrigatórioDescrição
daysintegerOpcional

How far back to look, by run start and decision time (default 30).

  • De 1 a 365

Anotações

As indicações que o servidor envia com esta ferramenta. Um cliente as lê para decidir se pergunta a você antes de uma chamada.

Somente leiturareadOnlyHint: true
Não altera nada.
DestrutivadestructiveHint: false
Só adiciona ou lê; nada do que já existe é removido ou sobrescrito.
IdempotenteidempotentHint: —
Não se aplica: a ferramenta não altera nada.
Mundo abertoopenWorldHint: false
Só mexe na sua própria conta do Done.

Quais tokens podem chamá-la

Uma conexão feita com OAuth tem acesso total. Um token de Configurações → Acesso de agentes → Tokens MCP adicionais pode ser restringido, e um token restrito nunca enxerga além do seu projeto ou espaço de trabalho.

  • Acesso totalPermitido
  • Token somente leituraPermitido
  • Token de um projetoRecusado
  • Token de um espaço de trabalhoRecusado

Experimente

Com o Done conectado, peça ao seu assistente algo como:

“O que cada um dos meus agentes fez nos últimos 30 dias?”

Conecte o Done ao seu assistente

Um endpoint MCP por conta, com OAuth ou com um token. A configuração passo a passo para cada cliente:

Visão geral da configuração do MCP →