list_agents
List live agents, filter by state, parent, or blocked prompts, and expand full details to inspect health diagnostics and delivery receipts.
Instructions
List live-derived agents, including registry-persisted prompt blockage and pause state; filter to blocked agents or children with mine/parent_agent_id. Default summary returns flat addressable scalars and hides close tombstones and failed spawns whose surfaces are absent; request a terminal state or detail=full to include them. Full detail also includes provenance, health diagnostics, the registry record, and up to 20 unresolved or attention delivery receipts.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "list_agents"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mine | No | Return direct children of the calling agent | |
| repo | No | Filter by repository | |
| model | No | Filter by model | |
| state | No | Filter by state | |
| detail | No | summary (default): flat addressable scalar rows. full: provenance, health diagnostics, the full registry record, and up to 20 unresolved or attention delivery receipts. | summary |
| agent_ids | No | Return only these agent IDs | |
| max_age_ms | No | Maximum acceptable snapshot age in milliseconds (0-5000); topology changes always invalidate the snapshot | |
| parent_agent_id | No | Return direct children of this agent | |
| blocked_on_prompt | No | Return only agents whose registry records show a live prompt blocker |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| count | No | ||
| agents | No | ||
| derived_at | No | ||
| retry_count | Yes |