Agents & Machines
handoffSession
Hand Off Session
Hand this session off to a successor: write the baton, open the next session on the SAME machine and seat, and mark this one handed off: one verb instead of the ritual.
Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "hand off", and it calls handoffSession.
Example call
The MCP tools/call params, with the required arguments only.
{
"arguments": {
"conversationId": "<conversationId>"
},
"name": "handoffSession"
}Arguments
conversationIdstringrequiredThe session handing off: its conversationId (from listAgentSessions, or the chat you are running in).headlinestringoptionalOne line of state for the baton's title heading: what the successor is walking into. Omit and it reads as a plain handoff from one session number to the next.lanesstring[]optionalWhat is RUNNING right now and what slot is free, one line each: so the successor knows its capacity before dispatching anything. Each becomes a named lane in the baton's Open lanes section.openDecisionsstring[]optionalDecisions waiting on the OWNER, one line each, each with its link. Labelled as owner decisions in the baton rather than buried in narrative, which is what the contract requires.prsstring[]optionalPull requests in flight, one line each. Render each as a LINK: a bare "#1234" is refused by the contract gate before anything is written.signaturestringoptionalYour chip signature for the baton's Signature section: role · model · surface, from your live session. Omit it and the baton signs role and surface only: a model chip that is not yours is worse than no model chip.verificationstring[]optionalWhat the successor must verify against ground truth rather than trust: which branch to diff against, which claim is unproven. One line each.worktreesstring[]optionalWorktrees and branches this session was holding, one line each with its link, so no work is stranded on a checkout nobody knows about.
Returns
It (a) files the baton as a start-here page under the platform doc contract, validated before it is written, carrying whatever you pass (worktrees, lanes, pull requests, open decisions) plus both…
Ask for it
The Cloud routes these requests to this verb.
- hand off
- start a new chat from here
- I am out of context
- pass the baton
Pair it with
The verbs that finish the job.
Questions
What does handoffSession do?
Hand this session off to a successor: write the baton, open the next session on the SAME machine and seat, and mark this one handed off: one verb instead of the ritual. It is one of the tools The Cloud MCP server gives every connected AI.
How do I use handoffSession from Claude or ChatGPT?
Connect your AI to The Cloud at https://mcp.thecloud.so/mcp and sign in once. Then ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "hand off", and it calls handoffSession.
Is handoffSession safe to let an AI call?
handoffSession changes your workspace. What an AI creates is Private until you share it.
Connect
One endpoint gives your AI this tool and every other one: connect Claude, ChatGPT, Cursor or Gemini, read what The Cloud is, or see pricing.