Workflows and commentary (MCP) - layZ Docs

Guided workflows are the highest-quality path for full productions. Agents should treat layz_get_current_step as the source of truth after every action.

Core run tools

Tool	Role
`layz_list_templates`	Discover official + user templates
`layz_start_workflow`	Create a run (`templateId`, optional `referenceUrl`)
`layz_get_current_step`	Full guidance for the active module
`layz_get_status`	Lightweight status
`layz_advance_step` / `layz_skip_step` / `layz_go_to_step`	Navigation
`layz_set_step_data`	Save notes, picks, reviews (not scriptApproval)
`layz_get_workflow_link`	Dashboard URL for humans
`layz_complete_run`	Mark finished
`layz_list_runs`	Resume later

Commentary content tools

Tool	Role
`layz_download_videos`	Ingest into the downloader step
`layz_view_video_frames`	Visual inspection
`layz_set_script_brief`	assistanceMode and story settings
`layz_get_script_brief`	Read brief + notes
`layz_set_script`	Save narration (edits revoke guided approval)
`layz_approve_script`	Human approval in guided mode
`layz_list_voices` / `layz_generate_voiceover`	Speech
Editor + `layz_export_video`	Finish

Automatic vs guided

Mode	Voiceover gate
automatic	Script saved is enough
guided	`layz_approve_script` with matching approved text required

Agent rules of thumb

Do not use layz_analyze_videos for Generic Commentary
Save timestamped visualNotes on the downloader step after inspecting frames
Prefer advancing only when the current module’s exit criteria are met
After export, wait with layz_wait_for_processing (kind: export)
Return publication title with the final links

Human UI twin: Generic Commentary.