1. Docs
2. /
3. Tool reference
4. /
5. Files & Drive
6. /
7. stageFileUploadFromMachine

Files & Drive

stageFileUploadFromMachine

Stage File Upload From Machine

Save a file that sits on one of your MachineSync boxes (a photo, video, PDF or anything a lane produced or downloaded) into Cloud Files in ONE call, without its bytes passing through the chat.

write

Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "save the video the lane rendered to my Files", and it calls stageFileUploadFromMachine.

Example call

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

{
  "arguments": {
    "localPath": "<localPath>"
  },
  "name": "stageFileUploadFromMachine"
}

Arguments

• contentTypestringoptionalOptional MIME type. The name's extension decides when omitted.
• folderIdstringoptionalThe folder the person chose (folderId from listFiles). Omit for their Files root.
• localPathstringrequiredAbsolute path of the file on the box (or ~/... under the daemon user's home).
• machineIdstringoptionalWhich machine holds the file (machineId from listMachines). Omit to use the one machine that is active and online.
• namestringoptionalThe file name in Cloud Files, with its extension. Defaults to the file's name on disk.
• uploadIdstringoptionalAn upload you opened with beginFileUpload, to stage into instead of opening one. Its declared size and SHA-256 must match the file.

Returns

Waits up to 90 seconds; if the box is still working, returns the session to read with getAgentResult, then commitFileUpload with the uploadId it reports.

Ask for it

The Cloud routes these requests to this verb.

• save the video the lane rendered to my Files
• put ~/Downloads/shoot.jpg in my Photos folder
• upload this file from my MacBook to Cloud Files

Pair it with

The verbs that finish the job.

• listMachines
• listFiles
• commitFileUpload
• saveToFiles

Questions

• What does stageFileUploadFromMachine do?

  Save a file that sits on one of your MachineSync boxes (a photo, video, PDF or anything a lane produced or downloaded) into Cloud Files in ONE call, without its bytes passing through the chat. It is one of the tools The Cloud MCP server gives every connected AI.

• How do I use stageFileUploadFromMachine 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 "save the video the lane rendered to my Files", and it calls stageFileUploadFromMachine.

• Is stageFileUploadFromMachine safe to let an AI call?

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