mcp_opendaw_replace_from_preset
Replace an audio unit's instrument from a preset, optionally retaining its MIDI/audio effects and timeline. Provides preset-based swapping for compatible instrument types.
Instructions
Replace an audio unit's instrument/effects/timeline from a preset.
Uses PresetDecoder.replaceAudioUnit — swaps the instrument in an existing AU, optionally keeping the target's MIDI effects, audio effects, and/or timeline. The preset must contain a compatible instrument type (MIDI→MIDI, Audio→Audio).
unit_index: Target AU index to replace. preset_b64: Base64 preset bytes from export_preset. keep_midi_effects: If true, keep target's existing MIDI effects. keep_audio_effects: If true, keep target's existing audio effects. keep_timeline: If true, keep target's existing tracks/regions/notes.
Returns success or error with reason.
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": {
"unit_index": "<unit_index>",
"preset_b64": "<preset_b64>"
},
"name": "mcp_opendaw_replace_from_preset"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| preset_b64 | Yes | ||
| unit_index | Yes | ||
| keep_timeline | No | ||
| keep_midi_effects | No | ||
| keep_audio_effects | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |