Storyboard

Send "type": "storyboard".

Create a film/video storyboard with scenes and frames for visualizing stories, movie sequences, commercials, and video content.

Also available as the MCP tool render_storyboard. The same payload works through either surface.

Fields

data

scenesobject[]required

Array containing one scene with frames

Child attributes

idstringrequired

Scene ID (e.g., "scene_default")

titlestringrequired

Scene title

isDefaultboolean

true for main scene

colorstring

Scene color (e.g., "#e94560")

framesobject[]required

Array of frame objects

settingsobjectrequired

Storyboard settings

Child attributes

boardTitlestring

Storyboard title

themeenum<string>

One of light or dark. Defaults to light.

showMetadataboolean

Defaults to true.

frameSizeenum<string>

One of small, medium or large. Defaults to medium.

storyboardSettingsobject

Example

{
  "type": "storyboard",
  "data": {
    "scenes": [
      {
        "id": "string",
        "title": "Q4 Launch Planning",
        "isDefault": false,
        "color": "string",
        "frames": [
          {
            "id": "string",
            "sequence": 0,
            "title": "Q4 Launch Planning",
            "description": "string",
            "coverType": "string",
            "coverFileID": "string",
            "metadata": {
              "field1": "string",
              "field2": "string",
              "field3": "string",
              "field4": "string"
            },
            "comments": [
              {}
            ],
            "createdAt": "string"
          }
        ]
      }
    ],
    "settings": {
      "boardTitle": "Q4 Launch Planning",
      "theme": "light",
      "showMetadata": true,
      "frameSize": "medium",
      "storyboardSettings": {
        "customFields": [
          {}
        ],
        "frameNumber": {
          "format": "number",
          "prefix": "",
          "startFrom": 1
        },
        "brandGuide": {
          "primaryColor": "#1c7ce2",
          "secondaryColor": "#6c757d",
          "accentColor": "#e94560",
          "bgColor": "#ffffff",
          "artStyle": "string",
          "styleNotes": "string"
        },
        "features": {
          "enableCharacters": true,
          "enableScenes": true
        },
        "characters": [
          {}
        ],
        "customScenes": [
          {}
        ]
      }
    }
  }
}