Files & Drive
beginAssetUpload
Begin Asset Upload
Open a resumable upload for a large file you hold on a container or a MachineSync box (a mastered WAV, a long recording, a video), up to 209715200 bytes, which lands in Cloud Files and, for audio,…
Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "upload this master to The Cloud", and it calls beginAssetUpload.
Example call
The MCP tools/call params, with the required arguments only.
{
"arguments": {
"byteSize": 1,
"contentSha": "<contentSha>",
"contentType": "<contentType>",
"name": "<name>"
},
"name": "beginAssetUpload"
}Arguments
byteSizeintegerrequiredThe file's exact size in bytes, at most 209715200.contentShastringrequiredThe whole file's SHA-256 as 64 hex characters.contentTypestringrequiredThe file's MIME type, e.g. 'audio/wav'. An audio type also files a Studio Audio asset.durationMsnumberoptionalAudio length in milliseconds, when you know it.folderIdstringoptionalFiles folder to land in (folderId from listFiles). Omit for the Files root.namestringrequiredThe file name, e.g. 'river-meditation.wav'.provenanceobjectoptionalWho made an audio file, for the Studio Audio chips: role, model and surface.sourceAudioAssetIdstringoptionalThe Studio Audio asset this file was made from, to file it beside that source.titlestringoptionalStudio Audio title. Defaults to the file name without its extension.
Returns
The registry does not declare a return shape.
Declared limits
byteSize: greater than 0byteSize: maximum 9007199254740991
Ask for it
The Cloud routes these requests to this verb.
- upload this master to The Cloud
- send the cleaned WAV back
- push the 115 MB file from the lane
Pair it with
The verbs that finish the job.
Questions
What does beginAssetUpload do?
Open a resumable upload for a large file you hold on a container or a MachineSync box (a mastered WAV, a long recording, a video), up to 209715200 bytes, which lands in Cloud Files and, for audio,… It is one of the tools The Cloud MCP server gives every connected AI.
How do I use beginAssetUpload 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 "upload this master to The Cloud", and it calls beginAssetUpload.
Is beginAssetUpload safe to let an AI call?
beginAssetUpload 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.