Create a watch-together room
create_watch_roomCreates a private ScreenParty room where friends watch the same video in sync, in their browsers, with chat and voice. Use it when the user wants to watch something together now, or plan a watch party at a set time. Without start_time the room is ready now: the first person to open room_link becomes the host (controls playback), so tell the user to open it before sharing. With start_time it returns a countdown page with "add to calendar" for guests; the room opens 15 minutes early, and organiser_link lets the user open it any time and host it. Share room_link or schedule_page with guests; keep organiser_link and organiser_key for the user only (they also change it with update_watch_party and cancel it with cancel_watch_party). The room made here is what the *_watch_party tools call a watch party — same room_code.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "create_watch_room"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | No | What people will watch, e.g. "Lesson 3: Past tense". Defaults to "Watch party". | |
| video_url | No | Optional video the room opens with. A direct video link (mp4, webm, m3u8) or a public YouTube video URL. Paid streaming services are not supported. | |
| start_time | No | Optional. ISO 8601 date-time WITH a time zone, e.g. 2026-11-07T20:00:00+08:00 (ask the user for their time zone if unknown). Omit for a room that opens now. Up to 60 days ahead. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| ok | Yes | false when the call failed; then code says why. | |
| code | No | Error code when ok is false. | |
| opens_at | No | ISO time guests can enter (15 minutes before). | |
| room_code | No | 5-character room code. | |
| room_link | No | Link guests open to join the room. | |
| starts_at | No | ISO time it starts. | |
| organiser_key | No | Private: needed to cancel with cancel_watch_party. | |
| schedule_page | No | Countdown page with "add to calendar"; best link to share for a later party. | |
| organiser_link | No | Private: opens the room as host, even before it opens to guests. |