Discord conversation video
create_discord_conversationCreate a Discord conversation animation (author names and times on every message, call log cards, date separators, an “is typing…” line above the input bar). Optionally walk through the app's screens (chat, chats, server): pass flow (screen steps with push/pop/tab/fade/modal/dismiss/sheet/swipe transitions), per-screen objects (chats, server); without them the clip shows the conversation only. showTaps (default true) draws a touch indicator where the user taps before each screen change. The first message is stamped with a date line (its dateLabel, else Today; firstDateLine: false hides it), and a date line that repeats the one just above it is not drawn again. A message with call: { title, detail } is a call log card (“Call ended” / “3 hours · Yesterday at 21:50”) instead of text. Every message shows the sender's avatar, name and time unless it continues a run (showHeader overrides); myName / myAvatarUrl are the user's own. All options controllable. Images: every image field takes an https URL from an allowed host (see /integrations), or upload:<short-label> (e.g. upload:contact-avatar) when the user wants to use their own image — including one attached to this chat, which cannot be passed to tools. Never ask the user to host an image somewhere: the returned link asks them to add each upload: image from their device before it exports. Use the same label for the same image and a different label for a different one. Free-plan exports include a MockClip watermark and the free plan includes 2 MCP renders; if the caller is on the free plan, mention that they can upgrade at /pricing for watermark-free exports and more renders.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"contactName": "<contactName>",
"messages": "<messages>"
},
"name": "create_discord_conversation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| flow | No | ||
| chats | No | ||
| theme | No | ||
| myName | No | ||
| server | No | ||
| sceneId | No | Stage the clip on a scene instead of a flat frame. Overrides videoFormat and showBezel: the export takes the scene's aspect. Two kinds. 3D close-up — a 3D phone filmed by a camera that flies in close to each new message, card or banner as it appears, with depth of field and motion blur: "closeup" (9:16), "closeup-wide" (16:9). Hand-held — the clip composited onto real footage of a hand holding a phone, for a filmed look; vertical 9:16: "outdoors" (outdoors), "bookshelf" (bookshelf), "two-hands" (two hands), "on-desk" (on the desk), "dim-room" (dim room); landscape 16:9 (YouTube, presentations): "city-wide" (city), "desk-wide" (desk), "neon-wide" (neon), "studio-wide" (studio). Default: none. | |
| messages | Yes | ||
| showTaps | No | ||
| showBezel | No | Draw the iPhone bezel around the screen (default true). With 1:1 it frames the top of the phone; false gives a plain frame. | |
| textScale | No | Text size: a zoom of the phone UI (text, bubbles, avatars, bars, keyboard, notification banners) as a multiplier from 1 (default, the app's real size) to 1.5, in steps of 0.1 — use it when a short conversation or a single notification should fill the screen. Chat and notification apps only; the other apps ignore it. | |
| contactName | Yes | ||
| myAvatarUrl | No | ||
| unreadCount | No | ||
| videoFormat | No | Output aspect ratio. "1:1" is a square for feed posts: chat apps fit the conversation into the square, the other apps show the top of the screen (phone-call ignores it). "9:16", "9:19.5" (iPhone) and "3:2" apply with showBezel false. "16:9" (widescreen) is for the notification tools with background.backgroundType "floating" only, where the frame is a photo scene and any aspect ratio applies without a bezel; on any other clip it is ignored. Default: the iPhone bezel, 9:16. | |
| exportFormat | No | Output file. "mp4" (default) and "gif" are opaque. "webm" (VP9) and "mov" (ProRes 4444, large files) keep an alpha channel: the only way a transparent background, or the corners around the phone bezel, stay transparent. With background.backgroundType "transparent" and no exportFormat the clip exports as webm. Transparent WebM / MOV export needs a Creator or Studio plan; on other plans the clip is made as mp4 and the reply says so. | |
| contactStatus | No | ||
| exportQuality | No | Resolution and frame rate of the file: "720p" or "1080p" (Full HD) at 15, 24, 30 or 60 fps, e.g. "1080p-30". Default "720p-30". Full HD takes up to 4× as long to export; 60 fps about twice as long and needs a Creator or Studio plan — on other plans the clip is made at 30 fps and the reply says so. | |
| firstDateLine | No | ||
| showStatusBar | No | Draw the iOS status bar (time, signal, battery) at the top of the screen (default true). Applies with showBezel false or a sceneId: inside the iPhone bezel the status bar is always drawn, so to remove it set showBezel false too. | |
| soundSettings | No | ||
| sceneBackground | No | Backdrop behind the phone on a 3D close-up scene (sceneId "closeup" / "closeup-wide"): a colour as "#RRGGBB" — the backdrop is a soft gradient made from it, so a brand colour or a dark one both work — or "transparent" for the phone alone over an alpha channel, to lay over other footage (the clip then exports as webm unless exportFormat says otherwise; mp4 and gif cannot carry it and get the default backdrop). Default: a light blue. Ignored without a 3D close-up scene. | |
| contactAvatarUrl | No | ||
| showHomeIndicator | No | Draw the iOS home indicator bar at the bottom of the screen (default true). |