Tool reference

Screel serves one tool catalogue on three MCP surfaces. Which tools appear depends on where you connect:

Surface	Endpoint	Tools
ChatGPT app	https://api.screel.ai/mcp/chatgpt	24 — management + generation, with in-chat widgets
Claude connector	https://api.screel.ai/mcp/claude	17 — management and rendering only (no AI media generation)
Generic MCP	https://api.screel.ai/mcp	24 — management + generation, plain JSON responses

Two OAuth scopes gate the tools: screel.read for read-only tools and screel.generate for anything that creates or changes content. Tools marked free never spend credits.

Account and browsing

Available on every surface.

Tool	What it does
get_account	Your credit balance, storage usage, enabled capabilities, and the per-action credit costs.
list_projects	List your video projects, newest first, with thumbnails and scene counts.
get_project	A project’s full storyboard: every scene with its image, clip, voiceover and status, plus project-level audio.
get_scene	One scene’s full details, addressed by ID or position.
list_renders	All renders of a project with their status and video URLs.
get_render	One render (or a project’s latest) with its playable video URL, poster and file details.
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.

Projects and scenes

Available on every surface.

Tool	What it does
create_project	Start a new project with a name, optional description, and aspect ratio (16:9, 9:16, 1:1, 4:3).
add_scenes	Append up to 20 scenes in one call — the whole script at once, each with a name, description and optional duration.
update_scene	Rename, rewrite or reposition a scene.
update_project	Change a project’s name, description, aspect ratio or background-music volume.
duplicate_scene	Copy a scene; the copy lands right after the original.
delete_scene	Remove a scene. Destructive — hosts ask for confirmation.
set_scene_image	Attach an existing image to a scene as its still — a chat file attachment in ChatGPT, a public image URL elsewhere. Free.
revert_scene_image	Restore a scene’s previous image or clip version from its history. Free.

Rendering

Available on every surface.

Tool	What it does
render_project	Compose the project’s scenes — stills, clips, voiceover, music — into a finished MP4 or WebM (720p/1080p). Scenes without a clip render as stills.
cancel_job	Cancel one or many queued or running jobs; cancelling a waiting job is free.

Generation

Available in the ChatGPT app and the generic MCP endpoint. These spend credits. They return a job_id immediately; progress arrives via get_job_status.

Tool	What it does
generate_scene_image	Generate a scene’s image from a text prompt — one scene or a batch of up to 20 in a single call.
refine_scene_image	Edit a scene’s existing image with an instruction, optionally guided by up to two reference images.
animate_scene	Turn a scene’s image into a moving clip from a motion prompt (4–12 s, up to 1080p) — batchable.
generate_voiceover	Text-to-speech narration for a scene, with selectable voice, style and speed — batchable.
generate_music	Generate a background music track for the project from a prompt (5–300 s).
upscale_render	Upscale a finished render to 1080p, 1440p or 2160p.
list_voices	The available voiceover voices, style presets and defaults. Free.