mcp_opendaw_create_ratchet
Create a ratchet effect with accelerating or decelerating repeated notes for musical builds and fills. Adjust pitch, velocity, and subdivision rate to craft dynamic sequences.
Instructions
Create a ratchet — repeated notes with changing subdivision rate.
A ratchet (also called "accelerando repeat" or "Bach ratchet") is a series of repeated notes where the spacing between notes gradually decreases (accelerate) or increases (decelerate), creating a sense of acceleration or deceleration. Used extensively in Baroque music (Bach cadences), electronic build-ups, and drum fills.
Args: unit_index: Audio unit index track_index: Note track index pitch: MIDI pitch for all ratchet notes (0-127) start_beat: Start position in beats length_beats: Total length in beats subdivisions: Subdivision mode — "accelerate" = start slow, get faster (16th→32nd→64th) "decelerate" = start fast, get slower (64th→32nd→16th) "constant" = even subdivision (no change, like a roll) "exponential" = exponential acceleration max_subdivisions: Maximum notes per beat at the fastest point (4=16th, 8=32nd, 16=64th, 32=128th) velocity: Base velocity (0-1) velocity_decay: Velocity reduction per note (0=uniform, 0.02=gradual fade) pitch_drift: Semitones to drift per note (0=same pitch, 1=ascending chromatic, -1=descending, 12=ascending octaves) region_index: Target region (-1 = auto-create/append)
Returns: JSON with notes_created, pitch, subdivision_points, total_beats.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| pitch | No | ||
| velocity | No | ||
| start_beat | No | ||
| unit_index | Yes | ||
| pitch_drift | No | ||
| track_index | Yes | ||
| length_beats | No | ||
| region_index | No | ||
| subdivisions | No | accelerate | |
| velocity_decay | No | ||
| max_subdivisions | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |