← Todas las herramientas MCP

Get agent roster

get_agent_roster
Solo lectura

Qué hace

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

NombreTipoObligatorioDescripción
daysintegerOpcional

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

  • De 1 a 365

Anotaciones

Las pistas que el servidor envía con esta herramienta. Un cliente las lee para decidir si te pregunta antes de llamarla.

Solo lecturareadOnlyHint: true
No cambia nada.
DestructivadestructiveHint: false
Solo agrega o lee; no quita ni sobrescribe nada de lo que ya existe.
IdempotenteidempotentHint: —
No aplica: la herramienta no cambia nada.
Mundo abiertoopenWorldHint: false
Solo toca tu propia cuenta de Done.

Qué tokens pueden llamarla

Una conexión hecha con OAuth tiene acceso completo. Un token de Ajustes → Acceso de agentes → Tokens de MCP adicionales se puede acotar, y un token acotado nunca ve más allá de su proyecto o espacio de trabajo.

  • Acceso completoPermitido
  • Token de solo lecturaPermitido
  • Token de un proyectoRechazado
  • Token de un espacio de trabajoRechazado

Pruébala

Con Done conectado, pídele a tu asistente algo como:

“¿Qué hizo cada uno de mis agentes en los últimos 30 días?”

Conecta Done a tu asistente

Un endpoint MCP por cuenta, con OAuth o con un token. Configuración paso a paso para cada cliente:

Resumen de la configuración de MCP →