get_clip_envelope
Sample automation envelopes for device parameters in Ableton Session clips. Returns whether an envelope exists and its values at evenly spaced intervals.
Instructions
Sample the automation envelope for a device parameter in a Session clip.
The Ableton API does not expose individual breakpoints, so this samples the envelope value at evenly-spaced time positions across the clip. Returns envelope_exists=False if no envelope is set for the parameter. Only works for Session clips (not Arrangement clips).
Args: track_index: Zero-based index of the track. clip_index: Zero-based index of the clip slot. device_index: Zero-based index of the device on the track. param_index: Zero-based index of the parameter on the device. num_steps: Number of sample points across the clip (2-128, default 16).
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": {
"track_index": "<track_index>",
"clip_index": "<clip_index>",
"device_index": "<device_index>",
"param_index": "<param_index>"
},
"name": "get_clip_envelope"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| num_steps | No | ||
| clip_index | Yes | ||
| param_index | Yes | ||
| track_index | Yes | ||
| device_index | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |