IN PRACTICE
From a conversation to a recorded outcome.
These examples show possible workflows. Replace sample projects, identifiers and versions with your workspace values. Follow the current setup guide and, for MCP, the schema returned by tool discovery.
Find and read
Understand before changing
“Find blocked work in SUPPORT and explain the next step for SUPPORT-42.”
search_tools({ "query": "list_work get_task_context" })
execute_tools({
"calls": [{
"name": "list_work",
"arguments": {
"project_key": "SUPPORT",
"blocked": true,
"limit": 10
}
}]
})
Read a selected result with a separate get_task_context call. Tool discovery returns the current schemas, which describe each tool’s fields. Use the returned cursors to get more results.
Create a task
Record a concrete next step
“Create a follow-up in SUPPORT with this context and acceptance criterion.”
execute_tools({
"calls": [{
"name": "create_task",
"arguments": {
"idempotency_key": "support-followup-1842",
"project_key": "SUPPORT",
"title": "Verify the checkout fix",
"description_markdown": "Follow up on the support report.",
"acceptance_criteria_markdown": "Checkout succeeds on mobile."
}
}]
})
Read the destination’s work types and guidance first. When a policy applies, read and acknowledge Required Context, then add required_context_receipt_id to the write.
Read and revise
Keep the knowledge current
“Read the incident runbook, propose the new step, then save the agreed revision.”
list_documents → get_document
Review the complete proposed Markdown
update_document({
"idempotency_key": "runbook-update-1842",
"document_id": "DOCUMENT_ID_FROM_READ",
"current_version": 1,
"body_markdown": "# Runbook\n\nThe complete agreed content."
})
This example uses an ID placeholder. Use the current version from the read response. The supplied body replaces the whole document. Protected edits need a current context receipt.
Task email Powerup
Prepare a prospect email for review
“Prepare an introduction on LEAD-42. Show me the sender, recipients and complete copy before sending.”
Discover the task email tools
list_task_email_connections → prepare_task_email
get_task_email → review exact saved fields
update_task_email → review again if edited
Human authorizes this exact email
send_task_email → inspect its receipt
Requires the task email tools to be deployed and an eligible Gmail or SMTP sender. Sending needs the reviewed current_version, review_fingerprint and confirmed: true. Preparation never sends.