1. Docs
2. /
3. Tool reference
4. /
5. Agents & Machines
6. /
7. drainMachine

Agents & Machines

drainMachine

Drain Machine

Drain (or un-drain) one of your machines: the safe way to take a box offline without losing agent work.

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "drain the Mac Mini", and it calls drainMachine.

Example call

The MCP tools/call params, with the required arguments only.

{
  "arguments": {
    "machineId": "<machineId>"
  },
  "name": "drainMachine"
}

Arguments

• drainbooleanoptionaltrue places the drain order (stop claiming + checkpoint every running lane). false lifts it and auto-resumes the runs that checkpointed.
• machineIdstringrequiredWhich machine to drain (machineId from listMachines).

Returns

Queued runs stay queued (they are never failed) and claim again when the machine returns.

Ask for it

The Cloud routes these requests to this verb.

• drain the Mac Mini
• I need to unplug this machine
• pause the fleet on box N
• safe to shut down?
• bring that machine back

Pair it with

The verbs that finish the job.

• fleetDrainStatus
• listMachines
• resumeAgentRun

Questions

• What does drainMachine do?

  Drain (or un-drain) one of your machines: the safe way to take a box offline without losing agent work. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use drainMachine 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 "drain the Mac Mini", and it calls drainMachine.

• Is drainMachine safe to let an AI call?

  drainMachine 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.