poll_tasks
Waits for new task assignments and returns open tasks plus whether work changed, blocking until a task arrives or the timeout expires.
Instructions
Long-poll for new task assignments: use it only in a loop that waits for work. Blocks until a task is assigned to this agent or the timeout expires. Returns your open tasks (in_progress, review, todo; at most limit, with total_count/has_more) and whether any change occurred; done, cancelled and backlog need status_category or full=true. Tasks use the lean get_my_tasks view (first-line descriptions, no envelope fields); full=true returns the complete items without the open-category default. Kept for backward compatibility; get_my_tasks is the non-blocking equivalent.
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": "poll_tasks"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| full | No | Return complete task items of every status category instead of the lean open-card view (default false). | |
| limit | No | Max results (default 50). | |
| timeout | No | Maximum seconds to wait for new assignments (default 30, max 120). | |
| project_id | No | Filter by project. | |
| status_category | No | Filter by status category, one or a comma list: backlog, todo, in_progress, review, done, cancelled. Default: in_progress,review,todo. |