Handover
handoverCall this when the user says 'wrap up this session', 'continue in another AI', or 'hand this over to '. For AI switching, create a resumable handover with the same session. For client delivery, return one proof link with verifiable receipts. Pass continue_from to chain off a job you picked up.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "handover"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ref | No | Optional referral source to preserve as source_ref on the saved handover. | |
| _ref | No | Optional handover referral ID from your install link. | |
| goal | No | The objective this handover should help the recipient continue. | |
| loop | No | Run a proof loop. Defaults to true for jobs with at least two steps, false otherwise. | |
| work | No | Paste work to save as a supplied-work receipt, without claiming it was independently checked. | |
| anchor | No | Whether to request an optional external anchor for the handover receipt; defaults to true. | |
| redact | No | Privacy settings for masking, hashing, or omitting selected fields. | |
| shield | No | Whether to run the handover content shield check; defaults to true. | |
| dry_run | No | Preview the proposed handover without publishing it. | |
| not_run | No | Checks or actions that were not run as part of this work. | |
| payment | No | Optional caller-supplied x402 payment metadata; it does not itself prove settlement. | |
| sources | No | Reference URLs related to the work being handed over. | |
| summary | No | Concise account of what has been completed so far. | |
| branding | No | Optional display name, logo URL, and accent color for the handover page. | |
| recipient | No | Display name or label for the person, agent, or AI receiving this handover. | Your recipient |
| thread_id | No | Optional continuity thread ID to associate with this handover. | |
| _zambo_key | No | Optional opaque Zambo access capability. Never place it in a URL or public log. | |
| next_steps | No | Ordered, actionable steps for the recipient to continue the work. | |
| step_areas | No | Work-area labels mapped to receipt IDs; each entry identifies one receipt and its area. | |
| visibility | No | Who can open the handover: public, unlisted by link, or private. | public |
| _session_id | No | Optional stable bot-job ID. Reuse it across calls to bind a Day Pass and keep the job ledger together. | |
| not_checked | No | Relevant items that were not independently checked. | |
| receipt_ids | No | IDs of existing receipts to attach as evidence for the handed-over work. | |
| client_prefs | No | Client constraints to carry forward, such as areas where AI must not be used. | |
| deliverables | No | Named outputs to include, with an optional URL, content, or SHA-256 hash. | |
| step_sources | No | Sources by original receipt ID. Reachability is checked by Zambo, not accuracy. | |
| _caller_label | No | Optional caller label recorded as a caller-reported claim in the receipt. | zambo-starter |
| allowed_tools | No | Optional tool names to allow for the recipient's continuation. | |
| continue_from | No | Chain off a handover picked up through handover_accept in this same job session. | |
| _caller_handle | No | Opaque anonymous continuity handle returned during initialize. Reuse it across MCP sessions; it is not payment authorization. | |
| recipient_type | No | Recipient category: human, agent, or AI. Defaults to human. | human |
| receipt_visibility | No | Receipt visibility for this call. Public is the default. Private returns a bearer link; anyone with that link can read it, so keep it secret. The raw token is not stored. | public |
| creator_payment_url | No | Optional creator-owned payment link shown to the client only after acceptance. Zambo does not hold or process this payment. | |
| exclude_receipt_ids | No | Receipt IDs to leave out of this handover. | |
| _continuity_ai_label | No | Optional self-reported AI client label for the private continuity timeline. Zambo does not independently verify the client. | |
| acknowledge_warnings | No | Publish only after reviewing missing evidence or a failed/risky shield scan. Warning labels stay visible. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | ||
| ids | Yes | ||
| next | No | ||
| tier | No | ||
| urls | Yes | ||
| error | No | ||
| graph | No | ||
| active | No | ||
| result | Yes | The tool's observed JSON value or plain-text result. | |
| intents | No | ||
| next_up | No | ||
| payment | No | ||
| day_pass | No | ||
| today_url | No | ||
| expires_at | No | ||
| human_line | Yes | ||
| next_steps | No | ||
| daily_recap | No | ||
| renew_nudge | No | ||
| unlock_link | No | ||
| seconds_left | No | ||
| resume_status | No | ||
| resumed_result | No |