Handover List
handover_listList Zambo Handovers scoped to the supplied owning _session_id. Returns real statuses and client-ready links. Required arguments: _session_id.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"_session_id": "<_session_id>"
},
"name": "handover_list"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| _ref | No | Optional handover referral ID from your install link. | |
| cursor | No | Pagination cursor returned by a previous handover_list result. | |
| _zambo_key | No | Optional opaque Zambo access capability. Never place it in a URL or public log. | |
| _session_id | Yes | Optional stable bot-job ID. Reuse it across calls to bind a Day Pass and keep the job ledger together. | |
| _caller_label | No | Optional caller label recorded as a caller-reported claim in the receipt. | zambo-starter |
| _caller_handle | No | Opaque anonymous continuity handle returned during initialize. Reuse it across MCP sessions; it is not payment authorization. | |
| 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 |
| _continuity_ai_label | No | Optional self-reported AI client label for the private continuity timeline. Zambo does not independently verify the client. |
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 |