Command line
scene list
List all scenes
scene create
Create a new scene
Optional scene number to insert at (1-based: 1, 2, … or first, second, …); omit to append. Mutually exclusive with —after/—before.
Insert the new scene AFTER this scene — handle (scn_7) OR 1-based number OR ordinal. Mutually exclusive with —at/—before.
Insert the new scene BEFORE this scene — handle (scn_7) OR 1-based number OR ordinal. Mutually exclusive with —at/—after.
scene delete
Delete a scene by its handle
required
Scene handle (scn_7) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
scene rename
Rename a scene by its handle
required
Scene handle (scn_7) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
required
New scene name
scene set-color
Set a scene’s colour by Live palette index
required
Scene handle (scn_7) OR 1-based number (1, 2, …) OR ordinal (first, second, …).
required
Live colour palette index, 0-69.
scene play
Fire (play) a scene by its handle.
required
Scene handle (scn_7) OR 1-based number (1, 2, …) OR ordinal (first, second, …)
MCP tools
list_scenes
List all scenes. Each entry has a 1-based index, a name, and a liveset_id handle (e.g. scn_7). Address scenes by that handle — copy it verbatim.
set_scene_name
Rename a scene. Address it by its liveset_id handle from list_scenes (e.g. scn_7).
String
required
Scene handle from list_scenes, e.g. “scn_7”. Copy verbatim; not a position number.
String
required
New scene name
create_scene
Create a scene. Omit after/before to append at the end. Pass exactly one of after/before (each a scene handle from list_scenes) to insert relative to it.
String
Insert the new scene AFTER this scene handle (e.g. scn_7).
String
Insert the new scene BEFORE this scene handle (e.g. scn_7).
delete_scene
Delete a scene by its liveset_id handle from list_scenes (e.g. scn_7). Idempotent: last-remaining-scene is a no-op.
String
required
Scene handle from list_scenes, e.g. “scn_7”. Copy verbatim; not a position number.
play_scene
Fire (play) a scene by its liveset_id handle from list_scenes (e.g. scn_7) — launches every clip in that row.
String
required
Scene handle from list_scenes, e.g. “scn_7”. Copy verbatim; not a position number.