insert_clip_envelope_step
Insert an automation point into a Session clip's parameter envelope at a specified time and value, creating the envelope if needed. Enables precise automation control in Ableton Live.
Instructions
Insert an automation breakpoint into a clip's parameter envelope.
Writes a single automation point at the given time with the given value. Creates the envelope if it does not exist yet. Only works for Session clips. Note: Arrangement clips will return an error.
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. time: Time position in beats to insert the automation point. value: Automation value to set at the given time. curve: Curve shape (0.0 = linear, default 0.0).
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>",
"time": "<time>",
"value": "<value>"
},
"name": "insert_clip_envelope_step"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| time | Yes | ||
| curve | No | ||
| value | Yes | ||
| clip_index | Yes | ||
| param_index | Yes | ||
| track_index | Yes | ||
| device_index | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |