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.
todos://workspaceWorkspace resource
Returns the active workspace, current actor, and safe metadata.
list_tasksList tasks
Lists hosted tasks by status, owner, project, plan, overdue state, ready-to-claim state, or due-before date.
create_taskCreate task
Creates a hosted task with title, description, priority, project, plan, due date, delayed start, recurrence rule, and SLA window.
claim_taskClaim task
Worker-safe claim of the next ready hosted task.
complete_taskComplete task
Marks a task done after verification and returns the next spawned occurrence when recurrence is configured.
list_task_dependenciesList task dependencies
Lists dependency blockers and unblock events for an organization or task.
add_task_dependencyAdd task dependency
Marks one task as blocked by a prerequisite task and rejects duplicate or cyclic edges.
clear_task_dependencyClear task dependency
Clears a dependency after the prerequisite is satisfied and records unblock events.
list_ready_tasksList ready tasks
Returns ready and blocked task ids from a candidate set so agents only claim unblocked work.
next_ready_taskNext ready task
Selects the next unblocked task for an agent while respecting completed and claimed tasks.
list_runsList runs
Shows hosted runs and their status.
run_capabilityQueue hosted run
Creates an organization-scoped hosted run with input, max attempt, and timeout metadata.
claim_runClaim run
Claims the next queued run for a worker and starts its sandbox lifecycle.
heartbeat_runHeartbeat run
Extends a worker lease while the run is still active.
list_service_accountsList service accounts
Lists organization service accounts for admin MCP clients.
create_service_accountCreate service account
Creates a headless agent principal with explicit scopes.
create_service_account_keyCreate service account key
Returns a one-time API key for a service account. Responses do not include key hashes.
revoke_api_keyRevoke API key
Revokes an organization API key without returning secret material.
list_notification_subscriptionsList notification subscriptions
Lists org-scoped outbound webhooks for agent-native events.
create_notification_subscriptionCreate notification subscription
Creates a signed webhook subscription for task, run, billing, quota, and import events.
disable_notification_subscriptionDisable notification subscription
Disables an org-scoped webhook subscription without deleting delivery or audit history.
list_notification_deliveriesList notification deliveries
Shows retry attempts, failures, and dead-letter records.
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.