apply_midi_chord_inversion
Rotate MIDI chord tones up or down by an octave within a clip, with a dry-run plan and verified note readback before execution.
Instructions
Plan or apply guarded chord inversions with complete native note readback verification.
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>",
"direction": "<direction>",
"steps": "<steps>"
},
"name": "apply_midi_chord_inversion"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| steps | Yes | Number of chord tones to rotate at each selected onset. | |
| 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 at complete chord onsets. | |
| trackId | Yes | ID from list_tracks. | |
| planHash | No | Plan hash. | |
| direction | Yes | Rotate the lowest notes upward or highest notes downward by one octave. | |
| confirmationToken | No | Single-use plan token. | |
| expectedStateVersion | Yes | Observed stateVersion. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||