Logo
MCP workflows

Squall MCP Workflow Examples

These examples use the workflows supported by the current MCP server. Project creation, script generation, script approval, and episode restructuring still happen in the web app; MCP takes over once there is project state for an agent to inspect and operate on.

Produce Media for an Existing Microdrama

projects:read + generation:write
  1. 1
    list_projects

    Find the Squall project by title and confirm the account owns it.

  2. 2
    get_project_episodes

    Choose the episode that is ready for shot generation.

  3. 3
    get_episode_editor

    Load the episode tree, including shots, characters, looks, locations, and jobs.

  4. 4
    generate_character_image

    Generate missing character reference images when the project still needs them.

  5. 5
    generate_location_image

    Generate location reference images for approved location records.

  6. 6
    generate_shot_background_image

    Generate empty plates for short shots that need location-specific backgrounds.

  7. 7
    generate_shot_clip

    Start the video generation job for the planned shot.

  8. 8
    get_job

    Poll the returned job id until it succeeds or fails.

Review and Tighten a Scene

projects:read + script:write
  1. 1
    list_projects

    Find the project the user named.

  2. 2
    get_project_episodes

    Resolve the requested episode by number or title.

  3. 3
    get_scene_assets

    Read the scene, including shots, referenced characters, locations, and continuity assets.

  4. 4
    update_shot

    Patch only the changed shot fields. Dialogue changes must target camera_setup.short_shots[].dialogue_covered.

  5. 5
    get_episode_shots

    Read the shots again and summarize exactly what changed.

Adjust a Shared Location Safely

projects:read + script:write
  1. 1
    get_project_locations

    Find the location and inspect where it appears before changing it.

  2. 2
    get_location

    Read the current location fields and decide whether the change belongs to the shared record.

  3. 3
    update_location

    Patch only the changed fields. Text and prompt edits mark the location image stale.

  4. 4
    get_scene_assets

    Review scenes that use the location so the user understands the downstream effect.

Current Creation Boundary

generate_script covers the empty state: it writes a script into a new project, and seeds that project's characters, locations, episodes and shots along with it. Importing an existing script, approving one, and restructuring episodes are not exposed by the current MCP registry, so those steps still happen in the web app.

Setup GuideStart a Project