apply_drum_variation
Plan or apply deterministic drum variations to an Ableton clip, using guarded confirmation, exact timing/velocity limits, accent preservation, and complete note readback.
Instructions
Plan or apply a guarded deterministic drum variation with exact native context and complete note readback.
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": {
"expectedStateVersion": "<expectedStateVersion>",
"trackId": "<trackId>",
"clipId": "<clipId>",
"grid": "<grid>",
"startBar": "<startBar>",
"bars": "<bars>",
"laneNotes": "<laneNotes>",
"seed": "<seed>",
"timingAmount": "<timingAmount>",
"velocityAmount": "<velocityAmount>",
"preserveAccentsAbove": "<preserveAccentsAbove>"
},
"name": "apply_drum_variation"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bars | Yes | ||
| fill | No | ||
| grid | Yes | ||
| seed | Yes | Deterministic variation seed. | |
| clipId | Yes | list_clips Session ID or supported list_arrangement_clips ID. | |
| dryRun | No | False executes with token and hash. | |
| trackId | Yes | ID from list_tracks. | |
| planHash | No | Plan hash. | |
| startBar | Yes | ||
| laneNotes | Yes | Unique drum pitches to humanize. | |
| timingAmount | Yes | Maximum timing movement as a fraction of the selected grid step. | |
| velocityAmount | Yes | Maximum velocity movement. | |
| confirmationToken | No | Single-use plan token. | |
| expectedStateVersion | Yes | Observed stateVersion. | |
| preserveAccentsAbove | Yes | Required threshold; do not alter velocity at or above it. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||