read_clip
Reads an Ableton Live clip’s notes, settings, and markers to inspect it before editing and verify changes made by write or update operations.
Instructions
A clip, Session (track + slot, or clip t0/s2) or timeline (clip t0/a1): name, length, loop, and under settings its color, mute, markers, launch mode and quantization, legato, scale, time signature and groove. An audio clip adds its file, warp mode, gain, pitch and warp markers. A MIDI clip lists every note with pitch name and number, start and length in beats, velocity, and (when not default) probability, velocity deviation and release velocity.
Use it before changing notes and to check what write_clip or update_clip did.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "read_clip"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clip | No | A clip by address instead of track and slot: t0/s2 (Session slot 2 of t0) or t0/a1 (the second timeline clip of t0, see arrangement list). | |
| slot | No | Clip slot: the scene row, from 0. Example: 0 for the first scene. | |
| track | No | Track address of a Session clip, e.g. t0 (with slot). |