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.

Load, browse, and manage devices on tracks.

​
Command line

​
device list

List devices loaded on a track 
vibrai device list <track>
​
track
required
Track number (1-based: 1, 2, … or first, second, …)

​
device load

Load a stock device or User Library preset onto a track 
vibrai device load <track> --path <PATH> --part-type <TYPE> --position <N>
​
track
required
Track number (1-based: 1, 2, … or first, second, …)
​
--path
Browser path, e.g. ‘Instruments/Operator’
​
--part-type
PartType shorthand (Bass, Pad, Lead, …); resolves through defaults.instruments
​
--position
Insert position in device chain (1-based: 1 = first slot; omit to append)

​
device browse

List immediate children of a Live browser path 
vibrai device browse [path]
​
path
Browser path; empty for the snapshot’s top-level folders. Examples: “Drums”, “Instruments/Operator”, “Packs/F9 GALAXY”, “User Library”.

​
device default

Show the resolved default device for a part-type 
vibrai device default <partType>
​
partType
required
PartType to resolve

​
device delete

Remove a device from a track’s top-level device chain by index 
vibrai device delete <track> <device-index>
​
track
required
Track number (1-based: 1, 2, … or first, second, …)
​
device-index
required
Device chain position (1-based: 1 = first device in the chain)

​
MCP tools

​
load_device

Load a stock device or User Library preset onto a track. Specify either path OR part_type, not both. The path argument accepts (a) classic browser paths like “Instruments/Operator” for stock devices, or (b) query: URIs from find_instruments_by_tag for user-tagged presets. NOTE: part_type=Bd/Snare/HiHat/Perc resolves to the bare “Instruments/Drum Rack”, which loads empty (no samples). For drums to be audible, follow up with browse_devices “Drums” and load_device on a kit preset (.adg). Tonal part_types (Bass/Pad/Chord/etc.) load synths that sound by default. 
{
  "tool": "load_device",
  "arguments": {
    "track_id": "<String>",
    "path": "<String>",
    "part_type": "<Nullable`1>",
    "position": "<String>"
  }
}
​
track_id
String
required
Track number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
path
String
required
Browser path (e.g. “Instruments/Operator”) OR a query: URI from find_instruments_by_tag.
​
part_type
Nullable`1
required
PartType shorthand; resolves through defaults.instruments
​
position
String
required
Insert position in device chain (1-based: 1 = first slot; omit to append at the end)

​
browse_devices

List immediate children of a Live browser path. Reads the Vibrai instrument-browser snapshot (written by the Vibrai Live remote script via SP9) in-process — no live Ableton connection required. Empty path returns the snapshot’s top-level folders. Examples: ‘Drums’ (drum kit presets), ‘Instruments/Operator’ (Operator presets), ‘Packs/<PackName>’ (pack contents), ‘User Library’ (user-saved presets). Returns an empty list when the snapshot is missing — run install_vibrai_remote_script and refresh in Live. 
{
  "tool": "browse_devices",
  "arguments": {
    "path": "<String>"
  }
}
​
path
String
required
Browser path string; empty = top-level snapshot folders.

​
delete_device

Remove a device from a track’s top-level device chain by index. v1 scope: top-level chain only — nested racks (Drum Rack pads, Instrument Rack chains) are not addressable through this call. The device is gone immediately; there is no undo. Use list_devices to discover indices. 
{
  "tool": "delete_device",
  "arguments": {
    "track_id": "<String>",
    "device_index": "<String>"
  }
}
​
track_id
String
required
Track number (1-based: 1, 2, … or ‘first’, ‘second’, …)
​
device_index
String
required
Device chain position (1-based: 1 = first device in the chain)

​
list_devices

List devices currently loaded on a track in chain order. Returns each device’s index, id, name, and class info — pass deviceId to list_automation_params / get_automation / write_automation. 
{
  "tool": "list_devices",
  "arguments": {
    "track_id": "<String>"
  }
}
​
track_id
String
required
Track number (1-based: 1, 2, … or ‘first’, ‘second’, …)

​
get_default_instrument

Return the resolved browser path for a part-type (defaults.instruments override or built-in). 
{
  "tool": "get_default_instrument",
  "arguments": {
    "part_type": "<PartType>"
  }
}
​
part_type
PartType
required
PartType to resolve