ReferenceMCP Tools
Tasks Tools
MCP tools for tasks operations.
task_list
List tasks from the task board. Returns metadata for all matching tasks, sorted by priority.
| Parameter | Type | Required | Description |
|---|---|---|---|
status | string | no | Filter by task status |
role | string | no | Filter by agent role |
backend | string | no | Filter by execution backend |
initiative | string | no | Filter by initiative slug |
task_get
Get a single task by ID with full details: metadata, body content, and output log if available.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Task slug/ID |
task_create
Create a new task on the task board. Routes to the appropriate backend via dispatch config, or accepts an explicit backend override.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Task slug — becomes the filename |
title | string | yes | Human-readable task title |
role | string | yes | Agent role to execute this task |
priority | string | no | |
initiative | string | no | Parent initiative slug |
backend | string | no | Target backend. When omitted, resolved from task_type via dispatch config |
task_type | string | no | Task type — used for backend routing when backend is omitted |
model | string | no | Model override. When omitted, uses the backend's configured default |
objective | string | yes | What the worker must accomplish |
context | string | no | Files to read, initiative context |
acceptance_criteria | array | yes | List of acceptance criteria |
constraints | string | no | What NOT to do, patterns to follow |
deliverables | string | yes | Artifacts the worker must produce |
task_update
Update a task's metadata field.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Task slug/ID |
field | string | yes | Frontmatter field to update |
value | string,null | yes | New value (use null to clear) |
task_dispatch
Dispatch a pending task to its configured backend for execution. The worker runs as a detached background process. Supports all backends: claude, opencode, codex, gemini, lm-studio, groq, google-ai, lm-studio-api, openclaw.
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Linear issue identifier (e.g. 'SG-306') |
task_logs
Read logs for a task. Returns structured NDJSON events and/or artifact logs (output, blockers, verdict).
| Parameter | Type | Required | Description |
|---|---|---|---|
id | string | yes | Task slug/ID |
log_type | string | no | Which log to read |
tail | number | no | Return only the last N events |