← All MCP tools

Get agent roster

get_agent_roster
Read-only

What it does

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.

Parameters

NameTypeRequiredDescription
daysintegerOptional

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

  • From 1 to 365

Annotations

The hints the server sends with this tool. A host reads them to decide whether to ask you before a call.

Read-onlyreadOnlyHint: true
Changes nothing.
DestructivedestructiveHint: false
Only adds or reads; nothing already there is removed or overwritten.
IdempotentidempotentHint: —
Doesn't apply: the tool changes nothing.
Open worldopenWorldHint: false
Touches only your own Done account.

Which tokens can call it

A connection made with OAuth has full access. A token from Settings → Agent access → Extra MCP tokens can be narrowed, and a narrowed token never sees beyond its project or workspace.

  • Full accessAllowed
  • Read-only tokenAllowed
  • Single-project tokenRefused
  • Single-workspace tokenRefused

Try it

With Done connected, ask your assistant something like:

“What has each of my agents done in the last 30 days?”

Connect Done to your assistant

One MCP endpoint per account, over OAuth or a token. Step-by-step setup for each client:

MCP setup overview →