Projects, scenes and renders
Use these tools to read your account and to change projects and scenes.
Account and browsing
Section titled “Account and browsing”get_account
Section titled “get_account”Your credit balance, storage usage, enabled capabilities, and the per-action credit costs.
- Surfaces: ChatGPT app, ChatGPT app v2, Claude connector, Generic MCP, Manan
- Parameters: none
list_projects
Section titled “list_projects”List your video projects, newest first, with thumbnails and scene counts.
- Surfaces: ChatGPT app, ChatGPT app v2, Claude connector, Generic MCP, Manan
- Parameters:
cursor,limit
get_project
Section titled “get_project”Every scene of a project with its still, clip, narration and status, plus the project’s audio.
A project linked to an Unreal sequence also reports:
linkedandsequences, with each linked sequence’s name, path and scene count.sequenceper scene, its sequence name.dirty_reasonsper scene, why a bound scene’s clip no longer matches its marker.binding.in_frame, the objects in the capture, each with its actor path, stencil id, linked reference document and that link’skind.binding.shot_size.
On ChatGPT app v2, it also reports the project’s reference documents and render settings, and takes a detail of full or summary for a lighter progress check.
- Surfaces: ChatGPT app, ChatGPT app v2, Claude connector, Generic MCP, Manan
- Parameters:
project_id(required),detail
get_scene
Section titled “get_scene”One scene’s full details, addressed by ID or position.
In Manan it carries the scene’s still, clip, layers and keyframes, and each captured object’s place and size in the frame. It also lists up to 20 history versions, each with the slot it fills. Not on ChatGPT app v2: read it from get_project there.
- Surfaces: ChatGPT app, Claude connector, Generic MCP, Manan
- Parameters:
project_id(required),scene_id,scene_position
list_renders
Section titled “list_renders”All renders of a project with their status and video URLs. A render that shows a scene layer instead of the final pictures reports that layer. Not on ChatGPT app v2: pass all to get_render there instead.
- Surfaces: ChatGPT app, Claude connector, Generic MCP, Manan
- Parameters:
project_id(required)
get_render
Section titled “get_render”One render (or a project’s latest) with its playable video URL, poster and file details.
On ChatGPT app v2, pass all with a project ID to list every render of that project instead of one.
- Surfaces: ChatGPT app, ChatGPT app v2, Claude connector, Generic MCP, Manan
- Parameters:
all,project_id,render_id
get_job_status
Section titled “get_job_status”Progress of up to 40 generation/render jobs in one call, including queue position for waiting jobs and result URLs when done. Failed or cancelled jobs that cost credits report credits_refunded, or credits_refund: "pending" while the automatic refund is still running. On every surface except the ChatGPT app and the Claude connector, a running job also names what it is doing now (message, phase). A workflow run or batch there also reports how many of its jobs have finished (run_done of run_total).
- Surfaces: ChatGPT app, ChatGPT app v2, Claude connector, Generic MCP, Manan
- Parameters:
job_ids(required)
Projects and scenes
Section titled “Projects and scenes”create_project
Section titled “create_project”Start a new project with a name, an optional description and an aspect ratio. The ratios are 16:9, 9:16, 1:1, 4:3, 3:4, 21:9, 4:5, 5:4, 2:3 and 3:2.
- Surfaces: ChatGPT app, ChatGPT app v2, Claude connector, Generic MCP, Manan
- Parameters:
name(required),aspect_ratio,description
add_scenes
Section titled “add_scenes”Append up to 20 scenes in one call: the whole script at once, each with a name, description, and an optional picture prompt and duration.
- Surfaces: ChatGPT app, ChatGPT app v2, Claude connector, Generic MCP, Manan
- Parameters:
project_id(required),scenes(required)
update_scene
Section titled “update_scene”Update a scene’s name, description, position, duration, caption, audio generation, narration style or voice. Not on ChatGPT app v2: use update_scenes there.
- Surfaces: ChatGPT app, Claude connector, Generic MCP
- Parameters:
project_id(required),scene_id(required),caption,description,duration,generate_audio,name,position,show_captions,voiceover_style,voiceover_voice
update_scenes
Section titled “update_scenes”Batched scene edits in one call: rename, rewrite, move, retime or change the voice settings of up to 20 scenes, in order. It replaces update_scene on ChatGPT app v2.
In Manan it also deletes and duplicates.
- Surfaces: ChatGPT app v2, Manan
- Parameters:
project_id(required),scenes(required)
delete_scenes
Section titled “delete_scenes”Remove up to 20 scenes in one call; positions refer to the scene order before the call. The client asks you to confirm first. Replaces delete_scene on ChatGPT app v2.
- Surfaces: ChatGPT app v2
- Parameters:
project_id(required),scenes(required)
duplicate_scenes
Section titled “duplicate_scenes”Copy up to 20 scenes in one call; each copy lands right after its original. Replaces duplicate_scene on ChatGPT app v2.
- Surfaces: ChatGPT app v2
- Parameters:
project_id(required),scenes(required)
update_project
Section titled “update_project”Change a project’s name, description, aspect ratio or background-music volume.
On ChatGPT app v2, it also changes the render settings. They cover resolution, frame rate, quality, transitions, fades, captions, color grade and audio. They also cover the motion on scenes that render as stills. The tool refuses an unknown value, and a setting the account can’t fully honor comes back with a one-line warning. audio_mode music_master plays the music track once from music_start and mutes the clips’ own sound. mix loops the music under the clips.
In Manan, background_music makes an attached track the project’s music, and remove_background_music takes it off. There, render_settings takes audio_mode and music_start only.
- Surfaces: ChatGPT app, ChatGPT app v2, Claude connector, Generic MCP, Manan
- Parameters:
project_id(required),aspect_ratio,background_music_volume,description,name,render_settings
duplicate_scene
Section titled “duplicate_scene”Copy a scene; the copy lands right after the original. Not on ChatGPT app v2: use duplicate_scenes there.
- Surfaces: ChatGPT app, Claude connector, Generic MCP
- Parameters:
project_id(required),scene_id,scene_position
delete_scene
Section titled “delete_scene”Remove a scene. The client asks you to confirm first. Not on ChatGPT app v2; use delete_scenes there.
- Surfaces: ChatGPT app, Claude connector, Generic MCP
- Parameters:
project_id(required),scene_id,scene_position
set_scene_image
Section titled “set_scene_image”Attach an existing picture to a scene as its still: a chat file attachment in ChatGPT, a public picture URL elsewhere.
In Manan it takes a slot: still, keyframe or clip. Its resource_id takes any picture or clip of the project, and original puts the raw capture back in the slot.
On ChatGPT app v2 it also restores a version from the scene’s history in place of revert_scene_image. It spends no credits.
- Surfaces: ChatGPT app, ChatGPT app v2, Claude connector, Generic MCP, Manan
- Parameters:
project_id(required),image,image_url,resource_id,scene_id,scene_position
revert_scene_image
Section titled “revert_scene_image”Restore a scene’s previous picture or clip version from its history. Not on ChatGPT app v2: pass a history version to set_scene_image there. It spends no credits.
- Surfaces: ChatGPT app, Claude connector, Generic MCP
- Parameters:
project_id(required),resource_id,scene_id,scene_position
Rendering
Section titled “Rendering”render_project
Section titled “render_project”Compose the project’s scenes into a finished MP4 with their stills, clips, narration and music, at 720p to 2160p. 1440p and above fall back to 1080p when the account does not have that capability. Format and resolution default to the project’s render settings. Scenes without a clip render as stills. It spends no credits.
- Surfaces: ChatGPT app, ChatGPT app v2, Claude connector, Generic MCP, Manan
- Parameters:
project_id(required),scene_ids(required),format,request_id,resolution
cancel_job
Section titled “cancel_job”Cancel one or many queued or running jobs. Cancelling a waiting job is free. Cancelling a running job returns its full credit cost, reported as credits_refunded.
- Surfaces: ChatGPT app, ChatGPT app v2, Claude connector, Generic MCP, Manan
- Parameters:
job_id,job_ids
