← All MCP tools

List agents

list_agents
Read-only

What it does

The account's agent roster — the named agents a task can be pinned to (e.g. Claude, Instinct, Muse) — and which one YOU are. Your lane comes from your credential's own name (a named MCP token, or your OAuth connection's label), never from a tool argument; a credential that matches no roster agent works the default agent's lane. list_my_tasks, next_task, claim_task and list_triggers only give you your own lane's tasks. An empty roster means lanes are off: every agent shares one queue, as before. Read-only — only a human can change the roster.

Parameters

This tool takes no arguments.

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 tokenAllowed
  • Single-workspace tokenAllowed

Try it

With Done connected, ask your assistant something like:

“Which agents are on my roster, and which one are you?”

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 →