Skip to main content
Glama

Handover

handover

Call 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

NameRequiredDescriptionDefault
refNoOptional referral source to preserve as source_ref on the saved handover.
_refNoOptional handover referral ID from your install link.
goalNoThe objective this handover should help the recipient continue.
loopNoRun a proof loop. Defaults to true for jobs with at least two steps, false otherwise.
workNoPaste work to save as a supplied-work receipt, without claiming it was independently checked.
anchorNoWhether to request an optional external anchor for the handover receipt; defaults to true.
redactNoPrivacy settings for masking, hashing, or omitting selected fields.
shieldNoWhether to run the handover content shield check; defaults to true.
dry_runNoPreview the proposed handover without publishing it.
not_runNoChecks or actions that were not run as part of this work.
paymentNoOptional caller-supplied x402 payment metadata; it does not itself prove settlement.
sourcesNoReference URLs related to the work being handed over.
summaryNoConcise account of what has been completed so far.
brandingNoOptional display name, logo URL, and accent color for the handover page.
recipientNoDisplay name or label for the person, agent, or AI receiving this handover.Your recipient
thread_idNoOptional continuity thread ID to associate with this handover.
_zambo_keyNoOptional opaque Zambo access capability. Never place it in a URL or public log.
next_stepsNoOrdered, actionable steps for the recipient to continue the work.
step_areasNoWork-area labels mapped to receipt IDs; each entry identifies one receipt and its area.
visibilityNoWho can open the handover: public, unlisted by link, or private.public
_session_idNoOptional stable bot-job ID. Reuse it across calls to bind a Day Pass and keep the job ledger together.
not_checkedNoRelevant items that were not independently checked.
receipt_idsNoIDs of existing receipts to attach as evidence for the handed-over work.
client_prefsNoClient constraints to carry forward, such as areas where AI must not be used.
deliverablesNoNamed outputs to include, with an optional URL, content, or SHA-256 hash.
step_sourcesNoSources by original receipt ID. Reachability is checked by Zambo, not accuracy.
_caller_labelNoOptional caller label recorded as a caller-reported claim in the receipt.zambo-starter
allowed_toolsNoOptional tool names to allow for the recipient's continuation.
continue_fromNoChain off a handover picked up through handover_accept in this same job session.
_caller_handleNoOpaque anonymous continuity handle returned during initialize. Reuse it across MCP sessions; it is not payment authorization.
recipient_typeNoRecipient category: human, agent, or AI. Defaults to human.human
receipt_visibilityNoReceipt 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_urlNoOptional creator-owned payment link shown to the client only after acceptance. Zambo does not hold or process this payment.
exclude_receipt_idsNoReceipt IDs to leave out of this handover.
_continuity_ai_labelNoOptional self-reported AI client label for the private continuity timeline. Zambo does not independently verify the client.
acknowledge_warningsNoPublish only after reviewing missing evidence or a failed/risky shield scan. Warning labels stay visible.

Output Schema

NameRequiredDescriptionDefault
okYes
idsYes
nextNo
tierNo
urlsYes
errorNo
graphNo
activeNo
resultYesThe tool's observed JSON value or plain-text result.
intentsNo
next_upNo
paymentNo
day_passNo
today_urlNo
expires_atNo
human_lineYes
next_stepsNo
daily_recapNo
renew_nudgeNo
unlock_linkNo
seconds_leftNo
resume_statusNo
resumed_resultNo

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed2 schema fields changed
    • addedInput schema / properties / receipt_visibility
      Added value: +{
      +  "default": "public",
      +  "description": "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.",
      +  "enum": [
      +    "public",
      +    "private"
      +  ],
      +  "type": "string"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "result",
      -  "ok",
      -  "human_line",
      -  "next",
      -  "ids",
      -  "urls"
      -]New value: +[
      +  "result",
      +  "ok",
      +  "human_line",
      +  "ids",
      +  "urls"
      +]
  2. Changed8 schema fields changed
    • changedOutput schema / properties / daily_recap / type
      Previous value: -"object"New value: +[
      +  "object",
      +  "null"
      +]
    • changedOutput schema / properties / error / anyOf
      Previous value: -[
      -  {
      -    "required": [
      -      "next_call"
      -    ]
      -  },
      -  {
      -    "required": [
      -      "next_url"
      -    ]
      -  }
      -]New value: +[
      +  {
      +    "properties": {
      +      "next_call": {}
      +    },
      +    "required": [
      +      "next_call"
      +    ]
      +  },
      +  {
      +    "properties": {
      +      "next_url": {}
      +    },
      +    "required": [
      +      "next_url"
      +    ]
      +  }
      +]
    • addedOutput schema / properties / graph / properties / edges
      Added value: +{
      +  "items": {
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / graph / properties / nodes
      Added value: +{
      +  "items": {
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / graph / properties / retries
      Added value: +{
      +  "properties": {
      +    "max": {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "used": {
      +      "minimum": 0,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "used",
      +    "max"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / graph / properties / sources
      Added value: +{
      +  "properties": {
      +    "not_checked": {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "not_resolved": {
      +      "minimum": 0,
      +      "type": "integer"
      +    },
      +    "resolved": {
      +      "minimum": 0,
      +      "type": "integer"
      +    }
      +  },
      +  "required": [
      +    "resolved",
      +    "not_resolved",
      +    "not_checked"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / graph / properties / summary
      Added value: +{
      +  "type": "string"
      +}
    • removedOutput schema / properties / next_steps / minItems
      Removed value: -1
  3. Changed25 schema fields changed
    • addedInput schema / properties / branding / properties / accent / description
      Added value: +"Optional six-digit hex accent color."
    • addedInput schema / properties / branding / properties / logo_url / description
      Added value: +"Optional logo URL shown on the handover."
    • addedInput schema / properties / branding / properties / name / description
      Added value: +"Optional display name shown on the handover."
    • addedInput schema / properties / client_prefs / properties / no_ai_for / description
      Added value: +"Work areas the client asked not to use AI for."
    • addedInput schema / properties / deliverables / items / properties / content / description
      Added value: +"Optional text content to include directly as the deliverable."
    • addedInput schema / properties / deliverables / items / properties / name / description
      Added value: +"Human-readable name for this delivered file or artifact."
    • addedInput schema / properties / deliverables / items / properties / sha256 / description
      Added value: +"Optional SHA-256 digest used to identify the exact deliverable bytes."
    • addedInput schema / properties / deliverables / items / properties / url / description
      Added value: +"Optional URL where the recipient can access this deliverable."
    • addedInput schema / properties / payment / properties / amount / description
      Added value: +"Settled payment amount as a string, if available."
    • addedInput schema / properties / payment / properties / asset / description
      Added value: +"Payment asset or token symbol, if available."
    • addedInput schema / properties / payment / properties / method / description
      Added value: +"Payment protocol used for the supplied settlement details."
    • addedInput schema / properties / payment / properties / network / description
      Added value: +"Network identifier on which the payment was settled."
    • addedInput schema / properties / payment / properties / payTo / description
      Added value: +"Recipient address that received the payment, if available."
    • addedInput schema / properties / payment / properties / settlement_ref / description
      Added value: +"Provider settlement reference, if available."
    • addedInput schema / properties / payment / properties / tx_hash / description
      Added value: +"Transaction hash for the payment, if available."
    • addedInput schema / properties / redact / properties / auto_pii / description
      Added value: +"Automatically detect and redact likely personal information."
    • addedInput schema / properties / redact / properties / fields / description
      Added value: +"Additional field names to redact from the public handover."
    • addedInput schema / properties / redact / properties / mode / description
      Added value: +"How selected private values are handled in public output."
    • changedInput schema / properties / sources / items / anyOf
      Previous value: -[
      -  {
      -    "format": "uri",
      -    "maxLength": 2048,
      -    "type": "string"
      -  },
      -  {
      -    "properties": {
      -      "ref": {
      -        "format": "uri",
      -        "maxLength": 2048,
      -        "type": "string"
      -      }
      -    },
      -    "required": [
      -      "ref"
      -    ],
      -    "type": "object"
      -  }
      -]New value: +[
      +  {
      +    "description": "A source URL relevant to the saved work.",
      +    "format": "uri",
      +    "maxLength": 2048,
      +    "type": "string"
      +  },
      +  {
      +    "properties": {
      +      "ref": {
      +        "description": "URL of a source relevant to the saved work.",
      +        "format": "uri",
      +        "maxLength": 2048,
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "ref"
      +    ],
      +    "type": "object"
      +  }
      +]
    • addedInput schema / properties / step_areas / items / properties / area / description
      Added value: +"Work area, such as legal review or final approval."
    • addedInput schema / properties / step_areas / items / properties / receipt_id / description
      Added value: +"Receipt ID for the step associated with this work area."
    • addedInput schema / properties / step_sources / items / properties / receipt_id / description
      Added value: +"Receipt ID for the handover step these sources support."
    • addedInput schema / properties / step_sources / items / properties / sources / description
      Added value: +"Sources associated with this receipt's step."
    • addedInput schema / properties / step_sources / items / properties / sources / items / properties / ref / description
      Added value: +"Citation or source reference associated with this receipt."
    • changedOutput schema / properties / human_line / maxLength
      Previous value: -200New value: +512
  4. Changed22 schema fields changed
    • addedInput schema / properties / allowed_tools / description
      Added value: +"Optional tool names to allow for the recipient's continuation."
    • addedInput schema / properties / anchor / description
      Added value: +"Whether to request an optional external anchor for the handover receipt; defaults to true."
    • addedInput schema / properties / branding / description
      Added value: +"Optional display name, logo URL, and accent color for the handover page."
    • addedInput schema / properties / client_prefs / description
      Added value: +"Client constraints to carry forward, such as areas where AI must not be used."
    • addedInput schema / properties / deliverables / description
      Added value: +"Named outputs to include, with an optional URL, content, or SHA-256 hash."
    • addedInput schema / properties / dry_run / description
      Added value: +"Preview the proposed handover without publishing it."
    • addedInput schema / properties / exclude_receipt_ids / description
      Added value: +"Receipt IDs to leave out of this handover."
    • addedInput schema / properties / goal / description
      Added value: +"The objective this handover should help the recipient continue."
    • addedInput schema / properties / next_steps / description
      Added value: +"Ordered, actionable steps for the recipient to continue the work."
    • addedInput schema / properties / not_checked / description
      Added value: +"Relevant items that were not independently checked."
    • addedInput schema / properties / not_run / description
      Added value: +"Checks or actions that were not run as part of this work."
    • addedInput schema / properties / payment / description
      Added value: +"Optional caller-supplied x402 payment metadata; it does not itself prove settlement."
    • addedInput schema / properties / receipt_ids / description
      Added value: +"IDs of existing receipts to attach as evidence for the handed-over work."
    • addedInput schema / properties / recipient / description
      Added value: +"Display name or label for the person, agent, or AI receiving this handover."
    • addedInput schema / properties / recipient_type / description
      Added value: +"Recipient category: human, agent, or AI. Defaults to human."
    • addedInput schema / properties / redact / description
      Added value: +"Privacy settings for masking, hashing, or omitting selected fields."
    • addedInput schema / properties / shield / description
      Added value: +"Whether to run the handover content shield check; defaults to true."
    • addedInput schema / properties / sources / description
      Added value: +"Reference URLs related to the work being handed over."
    • addedInput schema / properties / step_areas / description
      Added value: +"Work-area labels mapped to receipt IDs; each entry identifies one receipt and its area."
    • addedInput schema / properties / summary / description
      Added value: +"Concise account of what has been completed so far."
    • addedInput schema / properties / thread_id / description
      Added value: +"Optional continuity thread ID to associate with this handover."
    • addedInput schema / properties / visibility / description
      Added value: +"Who can open the handover: public, unlisted by link, or private."
  5. Changed1 schema field changed
    • changedInput schema / properties / recipient_type / enum
      Previous value: -[
      -  "human",
      -  "agent"
      -]New value: +[
      +  "human",
      +  "agent",
      +  "ai"
      +]
  6. Changed2 schema fields changed
    • addedInput schema / properties / _caller_handle
      Added value: +{
      +  "description": "Opaque anonymous continuity handle returned during initialize. Reuse it across MCP sessions; it is not payment authorization.",
      +  "maxLength": 64,
      +  "type": "string"
      +}
    • addedInput schema / properties / _caller_label / default
      Added value: +"zambo-starter"
  7. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-25"New value: +"draft-zambo-aer1-26"
  8. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-24"New value: +"draft-zambo-aer1-25"
  9. Changed2 schema fields changed
    • addedInput schema / properties / creator_payment_url
      Added value: +{
      +  "description": "Optional creator-owned payment link shown to the client only after acceptance. Zambo does not hold or process this payment.",
      +  "format": "uri",
      +  "maxLength": 2048,
      +  "type": "string"
      +}
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-23"New value: +"draft-zambo-aer1-24"
  10. Changed1 schema field changed
    • addedInput schema / properties / ref
      Added value: +{
      +  "description": "Optional referral source to preserve as source_ref on the saved handover.",
      +  "maxLength": 200,
      +  "minLength": 1,
      +  "type": "string"
      +}
  11. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-22"New value: +"draft-zambo-aer1-23"
  12. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-21"New value: +"draft-zambo-aer1-22"
  13. Changed1 schema field changed
    • addedInput schema / properties / continue_from
      Added value: +{
      +  "description": "Chain off a handover picked up through handover_accept in this same job session.",
      +  "format": "uuid",
      +  "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$",
      +  "type": "string"
      +}
  14. Changed1 schema field changed
    • changedOutput schema / properties / graph / properties / aer / const
      Previous value: -"draft-zambo-aer1-20"New value: +"draft-zambo-aer1-21"
  15. Changed2 schema fields changed
    • addedInput schema / properties / sources
      Added value: +{
      +  "default": [],
      +  "items": {
      +    "anyOf": [
      +      {
      +        "format": "uri",
      +        "maxLength": 2048,
      +        "type": "string"
      +      },
      +      {
      +        "properties": {
      +          "ref": {
      +            "format": "uri",
      +            "maxLength": 2048,
      +            "type": "string"
      +          }
      +        },
      +        "required": [
      +          "ref"
      +        ],
      +        "type": "object"
      +      }
      +    ]
      +  },
      +  "maxItems": 20,
      +  "type": "array"
      +}
    • addedOutput schema / properties / next_steps
      Added value: +{
      +  "items": {},
      +  "minItems": 1,
      +  "type": "array"
      +}
  16. Changed16 schema fields changed
    • addedInput schema / properties / _ref
      Added value: +{
      +  "description": "Optional handover referral ID from your install link.",
      +  "format": "uuid",
      +  "type": "string"
      +}
    • addedInput schema / properties / client_prefs
      Added value: +{
      +  "properties": {
      +    "no_ai_for": {
      +      "default": [],
      +      "items": {
      +        "maxLength": 200,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "maxItems": 50,
      +      "type": "array"
      +    }
      +  },
      +  "type": "object"
      +}
    • addedInput schema / properties / loop
      Added value: +{
      +  "description": "Run a proof loop. Defaults to true for jobs with at least two steps, false otherwise.",
      +  "type": "boolean"
      +}
    • addedInput schema / properties / step_areas
      Added value: +{
      +  "default": [],
      +  "items": {
      +    "properties": {
      +      "area": {
      +        "maxLength": 200,
      +        "minLength": 1,
      +        "type": "string"
      +      },
      +      "receipt_id": {
      +        "format": "uuid",
      +        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$",
      +        "type": "string"
      +      }
      +    },
      +    "required": [
      +      "receipt_id",
      +      "area"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 500,
      +  "type": "array"
      +}
    • addedInput schema / properties / step_sources
      Added value: +{
      +  "default": [],
      +  "description": "Sources by original receipt ID. Reachability is checked by Zambo, not accuracy.",
      +  "items": {
      +    "properties": {
      +      "receipt_id": {
      +        "format": "uuid",
      +        "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000)$",
      +        "type": "string"
      +      },
      +      "sources": {
      +        "items": {
      +          "properties": {
      +            "ref": {
      +              "maxLength": 2048,
      +              "minLength": 1,
      +              "type": "string"
      +            }
      +          },
      +          "required": [
      +            "ref"
      +          ],
      +          "type": "object"
      +        },
      +        "maxItems": 20,
      +        "type": "array"
      +      }
      +    },
      +    "required": [
      +      "receipt_id",
      +      "sources"
      +    ],
      +    "type": "object"
      +  },
      +  "maxItems": 20,
      +  "type": "array"
      +}
    • changedOutput schema / additionalProperties
      Previous value: -falseNew value: +true
    • addedOutput schema / properties / error
      Added value: +{
      +  "additionalProperties": true,
      +  "anyOf": [
      +    {
      +      "required": [
      +        "next_call"
      +      ]
      +    },
      +    {
      +      "required": [
      +        "next_url"
      +      ]
      +    }
      +  ],
      +  "properties": {
      +    "code": {
      +      "type": "string"
      +    },
      +    "next_call": {
      +      "additionalProperties": false,
      +      "properties": {
      +        "args": {
      +          "type": "object"
      +        },
      +        "tool": {
      +          "type": "string"
      +        }
      +      },
      +      "required": [
      +        "tool",
      +        "args"
      +      ],
      +      "type": "object"
      +    },
      +    "next_step": {
      +      "type": "string"
      +    },
      +    "next_url": {
      +      "type": "string"
      +    }
      +  },
      +  "required": [
      +    "code",
      +    "next_step"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / graph
      Added value: +{
      +  "properties": {
      +    "aer": {
      +      "const": "draft-zambo-aer1-20"
      +    },
      +    "schema": {
      +      "const": "zambo.graph/1"
      +    }
      +  },
      +  "required": [
      +    "schema",
      +    "aer",
      +    "nodes",
      +    "edges",
      +    "retries",
      +    "sources",
      +    "summary"
      +  ],
      +  "type": "object"
      +}
    • addedOutput schema / properties / human_line / maxLength
      Added value: +200
    • addedOutput schema / properties / human_line / pattern
      Added value: +"^[^\\r\\n]*$"
    • addedOutput schema / properties / ids
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • addedOutput schema / properties / next
      Added value: +{
      +  "minLength": 1,
      +  "type": "string"
      +}
    • addedOutput schema / properties / ok
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / renew_nudge
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / urls
      Added value: +{
      +  "additionalProperties": {
      +    "type": "string"
      +  },
      +  "type": "object"
      +}
    • changedOutput schema / required
      Previous value: -[
      -  "result"
      -]New value: +[
      +  "result",
      +  "ok",
      +  "human_line",
      +  "next",
      +  "ids",
      +  "urls"
      +]
  17. Changed3 schema fields changed
    • addedInput schema / properties / recipient / default
      Added value: +"Your recipient"
    • addedInput schema / properties / work
      Added value: +{
      +  "description": "Paste work to save as a supplied-work receipt, without claiming it was independently checked.",
      +  "maxLength": 64000,
      +  "minLength": 1,
      +  "type": "string"
      +}
    • removedInput schema / required
      Removed value: -[
      -  "recipient"
      -]
  18. Changed17 schema fields changed
    • addedInput schema / properties / allowed_tools
      Added value: +{
      +  "default": [],
      +  "items": {
      +    "maxLength": 120,
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "maxItems": 150,
      +  "type": "array"
      +}
    • addedInput schema / properties / next_steps
      Added value: +{
      +  "default": [],
      +  "items": {
      +    "maxLength": 2000,
      +    "minLength": 1,
      +    "type": "string"
      +  },
      +  "maxItems": 10,
      +  "type": "array"
      +}
    • addedInput schema / properties / recipient_type
      Added value: +{
      +  "default": "human",
      +  "enum": [
      +    "human",
      +    "agent"
      +  ],
      +  "type": "string"
      +}
    • addedOutput schema / properties / active
      Added value: +{
      +  "type": "boolean"
      +}
    • addedOutput schema / properties / daily_recap
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / day_pass
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / expires_at
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / human_line
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / intents
      Added value: +{
      +  "items": {
      +    "type": "object"
      +  },
      +  "type": "array"
      +}
    • addedOutput schema / properties / next_up
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / payment
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / resume_status
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / resumed_result
      Added value: +{
      +  "type": "object"
      +}
    • addedOutput schema / properties / seconds_left
      Added value: +{
      +  "type": [
      +    "number",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / tier
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
    • addedOutput schema / properties / today_url
      Added value: +{
      +  "type": "string"
      +}
    • addedOutput schema / properties / unlock_link
      Added value: +{
      +  "type": [
      +    "string",
      +    "null"
      +  ]
      +}
  19. Added

TDQS

A3.6/5.0
Behavior3/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

The annotations already disclose that this is a non-read-only, open-world, non-idempotent, non-destructive mutation. The description adds that client delivery returns one proof link with verifiable receipts and that AI switching creates a resumable handover, but it omits auth, privacy, payment, shield, dry-run, and warning-acknowledgment behavior that matters for a 36-parameter tool.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

Three sentences with the trigger phrases front-loaded and no obvious filler. It could be slightly more structured by separating AI-switching, client-delivery, and chaining modes, but it is efficient.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For a complex handover tool with 36 optional parameters, nested privacy/payment/receipt objects, and multiple modes, the description supplies only the high-level trigger and routing context. Full schema descriptions, annotations, and an output schema make it callable, but important behavioral details such as dry_run, redaction, visibility, and warning acknowledgment are left entirely to structured fields.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters3/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 100%, so all 36 parameters are already documented in structured data. The description clarifies continue_from as chaining off a picked-up handover and mentions same-session resumability, but adds no meaning for the remaining privacy, receipt, payment, visibility, or branding parameters; baseline 3 is appropriate.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States the concrete action: create a resumable handover or return a proof link with verifiable receipts. It names trigger phrases and distinguishes AI-switching from client-delivery modes, though it does not explicitly contrast with handover_list, handover_status, or handover_accept siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines4/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

Explicitly tells the agent when to call it, including quoted user phrases such as 'wrap up this session' and 'continue in another AI'. It gives mode-selection guidance for AI switching versus client delivery and mentions continue_from for chaining, but stops short of when-not-to-use guidance or direct sibling comparisons.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Try in Browser

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources