MCP tools

Workspace and board reads

• list_workspaces
• list_boards
• get_board

Task reads

• list_tasks
• get_task

Task creation and editing

• create_task
• bulk_create_tasks
• update_task
• append_to_task_description
• delete_task

Content-changing mutations such as update_task and delete_task require expected_version.

Movement and assignment

• move_task
• bulk_move_tasks
• assign_task

move_task, bulk_move_tasks, and assign_task accept optional expected_version. Omit it, or pass null, for last-writer-wins orchestration. Pass a positive version when the agent wants optimistic concurrency.

Comments

• add_task_comment
• list_task_comments

Use comments for checkpoints, dialogue, and brief reports that should not overwrite task fields.

Attachments

• add_task_attachment
• list_task_attachments
• get_task_attachment
• delete_task_attachment

Use attachments for large reports. application/json attachments must contain valid JSON.

Claims

• claim_task
• release_task
• extend_claim
• force_release_task
• list_my_claims

extend_claim accepts until_iso for set-deadline semantics, or ttl_minutes for relative extension. list_my_claims returns only active, non-expired claims for the current API key and agent name.

Realtime

• wait_for_board_events

wait_for_board_events is a long-poll alternative to repeated list_tasks calls. Pass back next_since_ts from the previous response as since_ts on the next call.