Tool reference · Tasks, workflows & decisions
task_phases_list
Returns every phase a task has been through, in order, with entry and exit times.
local stdio server read-only
When to use
- You resume a task and need to know which phase it is in.
- You want to see how long each phase took.
- You need the artifacts or notes recorded at an earlier phase.
Parameters
| Name | Type | Default | Description |
|---|---|---|---|
task_idrequired | string | — | — |
Example
Arguments
{
"task_id": "BILL-142"
}Result shape
{
"phases": [
{
"task_id": "BILL-142",
"phase": "van",
"entered_at": "2026-09-25T09:12:04Z",
"exited_at": "2026-09-25T09:30:11Z",
"notes": "level=2",
"artifacts": {
"description": "Add rate limiting to the public REST API",
"level": 2
}
},
{
"task_id": "BILL-142",
"phase": "plan",
"entered_at": "2026-09-25T09:30:11Z",
"exited_at": null,
"notes": "Token bucket per API key",
"artifacts": {
"plan": "docs/rate-limit-plan.md"
}
}
]
}The phase with exited_at null is the current one. An unknown task_id returns an empty list.
Values are illustrative; the keys follow the server's handler. MCP clients receive the result as JSON text content.
Server description
The description the server sends to your agent in tools/list, captured from the v14.7.0 source:
list all phases of a task in chronological order.