Skip to main content

Documentation Index

Fetch the complete documentation index at: https://docs.vibrai.com/llms.txt

Use this file to discover all available pages before exploring further.

Create, fire, delete, and manage session-view clips.

​
Command line

​
clip list

List clips for a track 
vibrai clip list <track>
​
track
required
Track number (1-based: 1, 2, … or first, second, …)

​
clip get

Get a clip by track and scene index 
vibrai clip get <track> <scene>
​
track
required
Track number (1-based: 1, 2, … or first, second, …)
​
scene
required
Scene number (1-based: 1, 2, … or first, second, …)

​
clip create

Create a clip 
vibrai clip create <track> <scene> --bars <N>
​
track
required
Track number (1-based: 1, 2, … or first, second, …)
​
scene
required
Scene number (1-based: 1, 2, … or first, second, …)
​
--bars
default:"4"
Clip length in bars (default: 4)

​
clip delete

Delete a clip 
vibrai clip delete <track> <scene>
​
track
required
Track number (1-based: 1, 2, … or first, second, …)
​
scene
required
Scene number (1-based: 1, 2, … or first, second, …)

​
clip fire

Fire a clip 
vibrai clip fire <track> <scene>
​
track
required
Track number (1-based: 1, 2, … or first, second, …)
​
scene
required
Scene number (1-based: 1, 2, … or first, second, …)

​
clip rename

Rename a clip by track and scene index 
vibrai clip rename <track> <scene> <name>
​
track
required
Track number (1-based: 1, 2, … or first, second, …)
​
scene
required
Scene number (1-based: 1, 2, … or first, second, …)
​
name
required
New clip name

​
MCP tools

​
list_clips

List all clip slots for a track. Empty slots are included as empty entries. Returns clip metadata only — notes are stripped for performance; call get_clip for note detail. 
{
  "tool": "list_clips",
  "arguments": {
    "track_id": "<String>"
  }
}
​
track_id
String
required
Track number (1-based: 1, 2, … or ‘first’, ‘second’, …)

​
get_clip

Get a single clip by track and scene. Returns null if the slot is empty. Includes the clip’s notes; use list_clips for a notes-less summary across a track. 
{
  "tool": "get_clip",
  "arguments": {
    "track_id": "<String>",
    "scene_index": "<String>"
  }
}
​
track_id
String
required
Track number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
scene_index
String
required
Scene number (1-based: 1, 2, … or ‘first’, ‘second’, …)

​
create_clip

Create an empty MIDI clip at the given track and scene. 
{
  "tool": "create_clip",
  "arguments": {
    "track_id": "<String>",
    "scene_index": "<String>",
    "bars": "<Double>"
  }
}
​
track_id
String
required
Track number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
scene_index
String
required
Scene number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
bars
Double
required
Clip length in bars (e.g. 4.0)

​
delete_clip

Delete the clip at the given track and scene. 
{
  "tool": "delete_clip",
  "arguments": {
    "track_id": "<String>",
    "scene_index": "<String>"
  }
}
​
track_id
String
required
Track number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
scene_index
String
required
Scene number (1-based: 1, 2, … or ‘first’, ‘second’, …)

​
fire_clip

Trigger the clip at the given track and scene. 
{
  "tool": "fire_clip",
  "arguments": {
    "track_id": "<String>",
    "scene_index": "<String>"
  }
}
​
track_id
String
required
Track number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
scene_index
String
required
Scene number (1-based: 1, 2, … or ‘first’, ‘second’, …)

​
set_clip_name

Rename the clip at the given track and scene. 
{
  "tool": "set_clip_name",
  "arguments": {
    "track_id": "<String>",
    "scene_index": "<String>",
    "name": "<String>"
  }
}
​
track_id
String
required
Track number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
scene_index
String
required
Scene number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
name
String
required
New clip name