Media & Video
watchVideo
Watch Video
Start reading a video URL, Cloud file, recording, page media block, or A FILE ON THE MEMBER'S OWN ATTACHED MACHINE.
Ask Claude, ChatGPT, Cursor or any AI connected to The Cloud "watch this video", and it calls watchVideo.
Example call
The MCP tools/call params, with the required arguments only.
{
"arguments": {},
"name": "watchVideo"
}Arguments
devicePathstringoptionalFull path to a media file on the member's own attached machine, starting at /, for example /Users/them/Downloads/recording.mp4. Nothing is uploaded and there is no size limit: the machine that holds the file reads it in place, so a…fileRefobjectoptionalA Cloud file or recording. Provide exactly one source.pageMediaBlockIdstringoptionalA page media block id. Provide exactly one source.urlstringoptionalA video URL. Provide exactly one source.cadencenumberoptionalSeconds between overview frames. Use 10 to 15 for screen recordings and 30 for talking heads.confirmbooleanoptionalRequired when the source is the member's own private content: their recording, their Cloud file, a video on their page, or a YouTube upload of theirs that is not public. Set it to true ONLY when the member asked for this video in words in…machineIdstringoptionalOptional machine id. Omit to use the member's healthy online machine.timestampsnumber[]optionalOptional exact timestamps in seconds to capture in addition to the cadence.
Returns
When an owned private YouTube upload has no Cloud copy, the existing authorized YouTube connection may return a completed transcript-only result from a verified manual English caption track;…
Declared limits
cadence: minimum 5cadence: maximum 300timestamps: maximum items 50
Ask for it
The Cloud routes these requests to this verb.
- watch this video
- review this recording
- what did I point at
- look closer at 4:32
- read the transcript of my video
Pair it with
The verbs that finish the job.
Questions
What does watchVideo do?
Start reading a video URL, Cloud file, recording, page media block, or A FILE ON THE MEMBER'S OWN ATTACHED MACHINE. It is one of the tools The Cloud MCP server gives every connected AI.
How do I use watchVideo 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 "watch this video", and it calls watchVideo.
Is watchVideo safe to let an AI call?
watchVideo widens who can see or receive something, so the owner approves every call explicitly. An AI cannot approve it for itself. 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.