read_device
Retrieve Ableton Live device parameters as displayed, including raw values, ranges, and on/off state; inspect rack macros/chains or query specific parameters by name and target.
Instructions
A device's parameters as Live shows them ("262 ms", "-6.0 dB", "On"), with raw value and range, plus whether the device is on.
For a rack: its visible mapped macro knobs and its chains, not every parameter (set all_params to see them all). For other devices: all parameters. Give params to see only some, by name; a wrong name comes back with similar names. A chain or pad address shows its devices instead.
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": {
"target": "<target>"
},
"name": "read_device"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| params | No | Only these parameters, by name as Live shows them. Example: ["Release", "Decay"]. Leave empty for the default view. | |
| target | Yes | Device, rack chain or Drum Rack pad address. Examples: t0/d0 (first device on t0), t1/d0/c1/d0 (first device in chain 1 of that rack), t2/d0/pC1 (Drum Rack pad C1), rA/d0, m/d0 | |
| all_params | No | For a rack: list every parameter, not only the macros. |