Claim the next card
claim_nextClaims the next Ready card for you, starts a run and moves the card to Running. Pass cardId to work one exact card. Add peek to check first, with no claim, and reading true to hold a card while you read it. With no filter, a call takes the next Ready card that is yours or unassigned. A card assigned to another persona never comes to you. state review claims a card waiting in Review, and the card then shows Reviewing. If you start sub-agents, give each one its own runtimeHandle.
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": "claim_next"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| peek | No | Claim nothing; show the result. | |
| state | No | ready (the default) or review. | |
| cardId | No | Work this one card: a number like ABC-12, or an id. The filters are ignored. | |
| column | No | A column, by id or label. | |
| effort | No | low, medium, high or none (no effort set): any of these. | |
| labels | No | Only cards with any of these labels. | |
| boardId | No | Board id or slug. | |
| cardIds | No | Cards to claim as one batch. Send more to add to it. | |
| context | No | Pass full to get every piece of context again. | |
| efforts | No | With cardIds: card to low, medium or high, if unset. | |
| exclude | No | Cards to skip, by id or number. | |
| persona | No | The persona to act as. | |
| reading | No | With cardId: a reading claim. The card does not move. | |
| assignee | No | me (only yours), a persona name, none (unassigned only) or any. | |
| batchTitle | No | With cardIds: a batch title. | |
| minPriority | No | Only cards with at least this priority. | |
| runtimeHandle | No | A short name for this agent or sub-agent. Use a different one for each sub-agent. | |
| acknowledgeOverlap | No | Claim a card whose files overlap a running card. |