mcp_opendaw_apply_articulation
Apply staccato, legato, tenuto, or accent articulation to notes by reshaping durations relative to grid position for deterministic phrasing changes.
Instructions
Apply articulation to existing notes — staccato, legato, tenuto, accent.
Reshapes note durations relative to their grid position to change phrasing character. Unlike velocity_curve (dynamics) or humanize (random), this applies deterministic duration ratios — the fundamental dimension of musical articulation.
unit_index: AU index. track_index: Note track index. region_index: Region index (-1 = all regions on the track). articulation: Articulation type:
"staccato" — shorten notes to fraction of their grid slot (default 50%)
"legato" — extend notes to nearly the next note's start (default 95%)
"tenuto" — hold notes to full grid slot (100%, no gap, no overlap)
"accent" — boost velocity on notes that fall on beat boundaries (downbeats) amount: Articulation depth 0-1 (default 0.5):
staccato: fraction of slot (0.3 = very short, 0.7 = moderate)
legato: overlap fraction (0.9 = near-full, 0.5 = half-fill)
tenuto: (unused, always full)
accent: velocity boost amount (0.3 = subtle, 1.0 = strong accent)
Returns per-region note counts and total notes reshaped.
Examples: apply_articulation(articulation="staccato", amount=0.3) # crisp, detached apply_articulation(articulation="legato", amount=0.95) # smooth, connected apply_articulation(articulation="accent", amount=0.8) # strong downbeat accents
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| amount | No | ||
| unit_index | No | ||
| track_index | No | ||
| articulation | No | staccato | |
| region_index | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |