List agent runs
list_agent_runsList the agent runs, live and finished, in the caller's accessible projects, newest first. Each run is one agent in its own sandbox. Returns id (the run's sandbox id), issueId, role, harness, status, instance type, and latest CPU/memory/disk metrics. When more runs match, nextCursor is set: pass it back as cursor, with the same filters, for the next page.
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_agent_runs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| role | No | Only the runs of this agent role | |
| limit | No | Max results (default 50). Narrow with projectId, issueId, role or status before raising it. | |
| cursor | No | nextCursor from the previous page; omit for the newest runs | |
| status | No | Filter by how the run stands: running, completed (finished), stopped (ended on purpose before it finished), failed, or stale (closed without a report) | |
| issueId | No | Only the runs of this mission, by its issue id, e.g. SHIP-412 | |
| projectId | No | Filter to one project id |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| data | Yes | ||
| nextCursor | Yes |