Skip to main content
Create, rename, list, and delete tracks.

Command line

track list

List all tracks

track get

Get a track by its 1-based number
track
required
Track number (1-based: 1, 2, … or first, second, …)

track create

Create a new track
name
required
Track name
--type
default:"Other"
Part type (Bass, Lead, Melody, etc.)

track delete

Delete a track by its 1-based number
track
Positional track number (1-based: 1, 2, … or first, second, …). Omit if using —liveset-id.
--liveset-id
Stable liveset_id from ‘vibrai track list —json’; preferred over the positional track number when available (survives reorders).

track rename

Rename a track by its 1-based number
track
Positional track number (1-based: 1, 2, … or first, second, …). Omit if using —liveset-id (in that case pass <name> alone after the flag).
name
New track name. Required (validated at runtime; declared optional only so Spectre permits the —liveset-id <name> shape).
--liveset-id
Stable liveset_id from ‘vibrai track list —json’; preferred over the positional track number when available (survives reorders).

MCP tools

list_tracks

List all tracks in the current Live set. Track id is 1-based. midi_index is the ordinal among MIDI tracks only (also 1-based), or null for audio tracks.

get_track

Get a single track. Pass either track_id (positional, 1-based) or liveset_id (stable across reorders within one Live session — get it from list_tracks). liveset_id wins if both are supplied. Returns the track in the same shape as list_tracks (1-based id and midi_index). Errors TRACK_NOT_FOUND if no such track exists.
track_id
String
Positional track number (1-based: 1, 2, … or ‘first’, ‘second’, …)
liveset_id
String
Stable liveset_id from list_tracks; preferred over track_id when available.

create_track

Create a new MIDI track of the given part type. Returns the created track with a 1-based id (matching list_tracks).
name
String
required
Track display name
type
PartType
required
Part type (drums, bass, chords, lead, pad, fx, etc.)

delete_track

Delete a track. Pass either track_id (positional, 1-based) or liveset_id (stable across reorders — get it from list_tracks). liveset_id wins if both are supplied. Subsequent tracks shift down so positional IDs stay dense; existing liveset_ids on the remaining tracks are unaffected. Destructive — no undo. Errors: TRACK_NOT_FOUND, CANNOT_DELETE_LAST_TRACK.
track_id
String
Positional track number (1-based: 1, 2, … or ‘first’, ‘second’, …)
liveset_id
String
Stable liveset_id from list_tracks; preferred over track_id when available.

set_track_name

Rename a track. Pass either track_id (positional, 1-based, may shift on reorder) or liveset_id (stable across reorders within one Live session — get it from list_tracks). liveset_id wins if both are supplied. Use liveset_id when you plan to issue multiple ops on the same track over time, especially across track insertions.
name
String
required
New track name
track_id
String
Positional track number (1-based: 1, 2, … or ‘first’, ‘second’, …)
liveset_id
String
Stable liveset_id from list_tracks; preferred over track_id when available.