live_api
Access any Ableton Live object property or method not covered by other tools. Inspect, read, set or call song, view, device, clip and mixer members by path, returned as plain JSON.
Instructions
Escape hatch to Live's object model for anything the other tools do not cover: Song, view, device, clip or mixer properties and methods.
Start with info on the object to see its members, then get, set or call. Set and call need write=true, change one undo step, and say what Live holds after (Live silently keeps the old value for some invalid writes). Prefer the dedicated tools when one exists; they check more. Results are plain JSON: Live objects come back as {object, name, address}. Underscore names, modules and files are never reachable.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"path": "<path>",
"operation": "<operation>"
},
"name": "live_api"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| args | No | For call: the arguments in order. Example: [{"value": 4}, {"ref": "t0"}] | |
| name | No | The property or method. For info: only members containing this text. | |
| path | Yes | The object: song, app, or an address (t0, rA, m, t0/d1, t0/d0/c1/d0, t0/d0/pC1, s2 = scene, t0/s2 = clip slot, t0/a1 = Arrangement clip), then optional .member steps; a number indexes a list. Examples: song.view, t0.mixer_device.sends.1, t0/s2.clip, song.cue_points.0 | |
| limit | No | For info and list: items per page (default 100, at most 500). | |
| value | No | For set: the new value. ref:t0/d1 passes a Live object. | |
| write | No | Must be true for set and call. Reads never need it. | |
| offset | No | For info and list: skip this many items. | |
| confirm | No | Also needed to call a method starting with delete, remove, clear or stop_all. | |
| operation | Yes | info: members of the object. get: read property name. set: write property name = value. call: run method name with args. list: the items of a list property (or of the path itself). |