Plan a launch film
plan_launch_filmPlan a launch film's look, length and words from a product page before rendering, so you can review and edit film.json, its script and brand notes first.
Instructions
Use it when the user wants to choose a launch film's look, length or words, or to read its plan before it renders. Reads a product's brand and page and writes film.json, the plan of a launch film, without rendering it. The result shows film.json, words.json (the page's words) and brand/BRAND.md, so every word on screen can be checked against the page before the render. Change film.json where it is wrong (launch_film_guide with topic types lists the scene types), then render it with render_launch_film. A second aspect is a second plan with words from the first and the other aspect. For a film in one job, use make_launch_film instead. The launch-film playbook (makersmcp_playbook) has the whole job. (launch-film 0.3.1, on this machine.)
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": {
"url": "<url>"
},
"name": "plan_launch_film"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| sfx | No | Set to false to plan the film without sound effects. | |
| url | Yes | The product's website, like https://linear.app, or its App Store or Google Play listing. A social profile is refused, and so is a host without a dot, like localhost. | |
| look | No | The film's look, which also sets the tempo of its music and so how long a bar lasts (default: picked from the brand). launch_film_guide with topic looks says what each one suits. | |
| brand | No | A brand kit you already have: its folder or its brand.json. make_brand_kit makes one. The kit copies the kit given into brand/ in the film's folder; without one, it reads the brand from the site itself. | |
| music | No | Set to false to plan the film without the music bed, as when the user's own track goes under it later. | |
| words | No | A words.json from an earlier plan or film, used instead of reading the page again, so a second aspect keeps the same words. | |
| aspect | No | 16:9 (default) or 9:16 for phones. For both, plan the second one with words from the first. | |
| out_dir | No | Folder to save into, absolute or relative to /app. Default: launch-film-<host>, where <host> is the site's host without www or the port. A run replaces the files an earlier run of this kit left there, so give each version its own out_dir. The kit deletes the brand/ folder in it and makes it again when given brand, or for an App Store page, so it does not start then while that folder holds a file other than a kit's own that would be lost. Otherwise it makes the kit in brand/ again where it is, so it does not start while brand/ holds a file named like a kit's own, in any letter case, that its brand.json does not list. To use that brand/ folder where it is, give brand as out_dir with /brand added, written the same way. | |
| seconds | No | Aim for this length (default 30). Clips last whole bars of the look's music and the plan never stretches one to fill the time, so the film can end several seconds away from it, often short. | |
| wait_seconds | No | How long to wait for the result, counted from the start of the call, before returning a job_id to wait on. Some clients end a call after 60 or 240 seconds; 45 is safe in all of them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kit | Yes | ||
| docs | No | The notes the text shows, and where each one is. | |
| next | No | What to do next, as the Next line says. | |
| tool | Yes | ||
| files | No | ||
| folder | No | Where the kit saved its files. | |
| job_id | Yes | ||
| passed | No | For checks: whether the check passed. | |
| status | Yes | ||
| continued | No | True when this call continued the job of an identical call whose answer did not reach the client, instead of starting another. | |
| exit_code | No | ||
| last_line | No | What the kit was doing last. | |
| expires_at | No | When the download links stop working. | |
| next_action | No | ||
| elapsed_seconds | Yes |