How do I use runOnMachine 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 "run X on my machine", and it calls runOnMachine.

Is runOnMachine safe to let an AI call?

runOnMachine deletes or sends, and calling it again does not undo it, so a careful client confirms with you before it runs. It reaches a system outside The Cloud on your behalf.

Agents & Machines

`runOnMachine`

Run on Machine

Run a single shell command on one of your machines (a MachineSync box) through The Cloud, and stream its output back into the Agents view: box ops without a physical terminal (update the daemon,…

writedestructiveexternal

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "run X on my machine", and it calls runOnMachine.

Example call

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

{
  "arguments": {
    "command": "<command>"
  },
  "name": "runOnMachine"
}

Arguments

commandstringrequiredThe shell command to run on the box, e.g. `thecloud service status` or `pkill -f local/bin/thecloud`. A single command line; it runs as the daemon's own user.
cwdstringoptionalWorking directory to run the command in. Defaults to the daemon's working directory.
machineIdstringoptionalWhich machine to run on (machineId from listMachines). Omit to use the one machine that is active and online; the refusal when none or several qualify names the candidates.
timeoutMsnumberoptionalHard timeout in milliseconds: the command is killed if it runs longer. Defaults to the box-side bound.

Returns

The registry does not declare a return shape.

Ask for it

The Cloud routes these requests to this verb.

run X on my machine
update the daemon on box N
restart the box
tail the log on…

Pair it with

The verbs that finish the job.

Questions

What does runOnMachine do?
Run a single shell command on one of your machines (a MachineSync box) through The Cloud, and stream its output back into the Agents view: box ops without a physical terminal (update the daemon,… It is one of the tools The Cloud MCP server gives every connected AI.
How do I use runOnMachine 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 "run X on my machine", and it calls runOnMachine.
Is runOnMachine safe to let an AI call?
runOnMachine deletes or sends, and calling it again does not undo it, so a careful client confirms with you before it runs. It reaches a system outside The Cloud on your behalf.

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.