humanize_midi_notes
Apply deterministic MIDI timing and velocity offsets to selected Ableton Live notes using a seed, grid, and limits, with dry-run planning and guarded execution.
Instructions
Plan or apply guarded deterministic MIDI timing and velocity humanization with exact clip, grid, and complete native 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>",
"noteIds": "<noteIds>",
"seed": "<seed>",
"gridBeats": "<gridBeats>",
"maxTimingOffsetBeats": "<maxTimingOffsetBeats>",
"maxVelocityOffset": "<maxVelocityOffset>"
},
"name": "humanize_midi_notes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| seed | Yes | Deterministic humanization seed. | |
| clipId | Yes | list_clips Session ID or supported list_arrangement_clips ID. | |
| dryRun | No | False executes with token and hash. | |
| noteIds | Yes | Unique stable note IDs to humanize. | |
| trackId | Yes | ID from list_tracks. | |
| planHash | No | Plan hash. | |
| gridBeats | Yes | Reference grid step in beats, including fractional triplet values. | |
| confirmationToken | No | Single-use plan token. | |
| maxVelocityOffset | Yes | Maximum absolute velocity movement. | |
| expectedStateVersion | Yes | Observed stateVersion. | |
| maxTimingOffsetBeats | Yes | Maximum absolute timing movement in beats; must not exceed half gridBeats. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||