todos.mdMCP Reference
The MCP gateway exposes the same task, run, docs, and feedback surfaces as the API. Agents should use MCP when they need structured tool calls.
GET
todos://workspaceWorkspace resource
Returns the active workspace, current actor, and safe metadata.
POST
list_tasksList tasks
Lists tasks by status, owner, project, or query.
POST
create_taskCreate task
Creates a task with a title, description, priority, and optional project.
POST
start_taskStart task
Claims a task before work begins.
POST
complete_taskComplete task
Marks a task done after verification.
POST
list_runsList runs
Shows hosted runs and their status.
Agent behavior
Read first
List tasks and inspect the selected task before changing state.
Claim one task
Start one task. Do not bulk complete shared work.
Report progress
Add comments when blocked, when scope changes, and after verification.
Finish cleanly
Complete the task only when the work is actually verified.