## Overview

Backed by the WM Studio Gridshot tool. Generates a 3×3 storyboard grid of shots that preserve the subject and progress the described story across panels.

Auth
oauth-jwt

Returns

{ job_id, status, panels?: [{ url, index, caption }] }

Web client

src/app/[locale]/dashboard/creative-studio/tools/gridshot/gridshot-nine-panel-client.tsx

MCP handler

mcp-director/src/tools/studio.py

## Quick start

Invoke the tool over Streamable HTTP at `{MCP_BASE_URL}/mcp/`. The request below assumes you already minted an MCP JWT via the OAuth flow.

MCPcurlTypeScript

Copy

```
{
  "name": "studio_storyboard",
  "arguments": {
    "reference_image_url": "<reference_image_url>",
    "story": "<story>"
  }
}
```

## Parameters

| Name                       | Type   | Default | Description                                        |
| -------------------------- | ------ | ------- | -------------------------------------------------- |
| reference_image_url       | string | —       | Source image for the opening shot.                 |
| story                     | string | —       | Narrative the storyboard should follow.            |
| style                     | string | ""    | Visual style hint.                                 |
| mood                      | string | ""    | Mood hint.                                        |

## Examples

9-shot storyboard

json

Copy

```
{
  "name": "studio_storyboard",
  "arguments": {
    "reference_image_url": "https://cdn.wm.studio/uploads/hero.jpg",
    "story": "Athlete laces up before dawn, runs the empty city, finishes at sunrise on the bridge.",
    "style": "cinematic 35mm",
    "mood": "determined"
  }
}
```