claim_task
Assign yourself to available tasks in Task Trellis MCP. Use to claim the next ready task, select by ID, or filter by project scope. Essential for AI agents to dynamically pick up and execute work items.
Instructions
Claims a task in the task trellis system
Use this tool to assign yourself to available tasks for execution. Essential for AI agents to pick up work items from the task queue and begin execution.
Claiming behavior:
Without 'taskId': Claims the next available task based on priority and readiness
With 'taskId': Claims a specific task by ID if available and ready
'scope': Limits claiming to tasks within a specific project or area
'force': Overrides normal claiming restrictions (use with caution)
Task readiness criteria:
Task status allows claiming (typically 'draft' or 'open' states)
All prerequisites are satisfied (prerequisite tasks completed)
Task is not already claimed by another agent
Task falls within specified scope if provided
Claiming workflow:
System evaluates available tasks against readiness criteria
Selects highest priority task that meets requirements
Updates task status to 'in-progress
Associates task with the claiming agent
Returns claimed task details for execution
Common patterns:
Claim any ready task: (no parameters)
Claim from project: scope='P-project-name'
Claim specific task: taskId='T-specific-task-id'
Force claim blocked task: taskId='T-task-id', force=true
Essential for autonomous task execution workflows where agents need to discover and claim work items dynamically.
Input Schema
Name | Required | Description | Default |
---|---|---|---|
force | No | Force claim flag (defaults to false) | |
scope | No | Scope to claim task from (optional) | |
taskId | No | Specific task ID to claim (optional) |