Ardour Ultra MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Inspect ardour://capabilities and session state before editing. Units are explicit. Backend fake is simulated. Native undo and compensation have different scopes. Never retry an OUTCOME_UNCERTAIN mutation automatically.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| pingC | Check backend heartbeat and current session. |
| get_capabilitiesC | Return truthful per-command backend capability status. |
| get_server_infoB | Server version, MCP SDK, platform and protocol details. |
| doctorC | Inspect runtime, bridge, paths and optional analysis dependencies. |
| get_session_infoB | Read session UUID, name, sample rate and observed revision scope. |
| save_sessionC | Save current session through Ardour save_state. |
| create_snapshotC | Save a named snapshot without replacing an existing snapshot. |
| list_tracksC | Paginate routes with stable Ardour IDs and mixer state. |
| get_trackB | Inspect a route by persistent Ardour ID. |
| create_trackC | Create an audio/MIDI track or audio bus using Session APIs. |
| delete_trackA | Delete a non-singleton route; explicit confirm_delete required; not natively undoable. |
| rename_trackC | Rename a stable-ID route. |
| list_groupsC | Paginate native route groups, stable IDs, properties and member route IDs. |
| create_groupC | Create an empty route group; returns actual native linkage defaults. |
| delete_groupB | Remove a nonempty group without deleting its routes; explicit intent; Ardour cannot remove empty groups through this binding. |
| add_track_to_groupB | Add a route to a group; reject implicit transfer from another group. |
| remove_track_from_groupC | Remove exact membership without deleting the route; Ardour automatically deletes an ordinary group when its last member leaves. |
| set_group_propertiesC | Set explicit group linkage booleans; returns before/after state; no grouped undo. |
| set_track_gainC | Set route gain in dB (-193..+6), ignoring group linkage. |
| set_track_panC | Set stereo azimuth in signed normalized units -1..+1. |
| set_track_muteD | Set route mute explicitly. |
| set_track_soloC | Set route solo explicitly. |
| arm_trackC | Set recording arm on a recordable track. |
| set_monitoringC | Set track monitoring: auto/input/disk. |
| get_meter_stateB | Read route peak meter values in dBFS; no audio analysis in realtime. |
| get_transportB | Read playhead in samples, speed, loop and recording state. |
| playA | Request playback. Inspect get_transport to confirm asynchronous state. |
| stopC | Request transport stop. |
| locateC | Locate using typed samples, seconds, quarter ticks or BBT. |
| start_recordingB | Enable session recording and request roll; arm tracks first. |
| stop_recordingC | Stop transport and disable session recording. |
| set_loopC | Update an existing Ardour loop location and enable loop. |
| clear_loopC | Disable loop playback. |
| convert_positionB | Convert a typed position using Ardour's current tempo/meter map. |
| set_tempoC | Insert constant quarter-note BPM point at a typed position. |
| set_time_signatureC | Insert a time signature point through TempoMap. |
| list_regionsC | Paginate active-playlist regions by route ID and kind. |
| get_regionC | Read region ID, playlist, source offset, timeline position and length. |
| create_midi_regionC | Create a blank internal MIDI region in Editor context. |
| move_regionC | Move a region nondestructively; named native undo. |
| copy_regionC | Copy to a compatible active playlist; fork MIDI source independently; audio shares source; native playlist undo. |
| trim_regionC | Trim to absolute timeline bounds within original region; native undo. |
| split_regionB | Split inside a region using its owning playlist; native undo. |
| delete_regionC | Remove a region from active playlist with native undo and explicit delete intent. |
| set_region_gainC | Set audio-region amplitude in dB nondestructively. |
| set_region_muteC | Set region mute with native undo. |
| set_region_lockC | Set region lock state with native undo. |
| set_region_fadesB | Set audio fade durations in samples; preserve current fade shapes. |
| list_midi_notesC | Paginate internal notes with source-relative 1920-quarter ticks and guarded model references. |
| insert_midi_notesC | Insert up to 10000 exact internal notes in one native note-diff undo command. |
| edit_midi_notesC | Replace guarded notes atomically in one native diff; pitch/time/length/velocity/channel. |
| delete_midi_notesC | Remove guarded notes in one diff; model fingerprint and explicit delete intent required. |
| list_available_pluginsC | Query Ardour inventory; filter names/categories; formats are runtime dependent. |
| list_track_pluginsC | Paginate plugin instances with stable processor IDs. |
| add_pluginC | Load inventory-selected plugin ID/format and insert at processor index. |
| remove_pluginB | Remove plugin processor with explicit intent; not natively undoable. |
| set_plugin_enabledC | Set plugin processor active state. |
| get_plugin_parametersC | Inspect parameter ordinal/port ID, native value, range/default and available display metadata. |
| set_plugin_parametersC | Validate and set a batch of native parameter values; rollback supported values on failure. |
| list_plugin_presetsB | List loaded plugin's available presets. |
| load_plugin_presetB | Load an existing plugin preset by exact label. |
| list_sendsC | List sends with stable processor and target route IDs. |
| create_sendC | Create an internal aux send to a bus; reject routing feedback cycles. |
| set_send_gainC | Set send level in dB. |
| remove_sendC | Remove send with explicit delete intent. |
| list_portsC | Paginate engine port names and connections; port IDs are backend-qualified names. |
| connect_portsB | Connect valid output to input with matching data type. |
| disconnect_portsB | Disconnect one exact existing port connection. |
| get_automationB | Inspect automation points and mode for gain, pan, plugin or send. |
| create_automation_pointsC | Batch exact points with explicit native units; replace requires delete intent; native memento undo. |
| clear_automationB | Clear target automation with explicit delete intent and native undo. |
| set_automation_modeC | Set native off/play/write/touch/latch mode. |
| undoB | Invoke Editor native undo once; only native undoable edits are guaranteed. |
| redoC | Invoke Editor native redo once. |
| execute_batchC | Prevalidate compensable control edits and apply with rollback; no general ACID promise. |
| render_rangeC | Export master range using actual Ardour preset into a new isolated directory. |
| analyze_audio_fileB | Offline peak/RMS/LUFS/spectrum/stereo/silence and estimated true peak; allowed roots only. |
| compare_audio_filesC | Compare two measured passes; no subjective quality score. |
| ensure_busB | Ensure one exact-name/channel-count audio bus exists; refuse ambiguous collisions; return creation changes and stable ID. |
| render_and_analyzeC | Render one preset-based master file, then analyze locally; preserve export and report stage/error if analysis fails; no atomic file rollback. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| precise_production_workflow | Inspection, exact editing, rendering and measured iteration using available capabilities. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| session | Read current session; collections are bounded first pages, use tools for further pages. |
| tracks | Read current tracks; collections are bounded first pages, use tools for further pages. |
| routing | Read current routing; collections are bounded first pages, use tools for further pages. |
| timeline | Read current timeline; collections are bounded first pages, use tools for further pages. |
| plugins | Read current plugins; collections are bounded first pages, use tools for further pages. |
| capabilities | Read current capabilities; collections are bounded first pages, use tools for further pages. |
| status | Read current status; collections are bounded first pages, use tools for further pages. |
TDQS
Scored across 80 tools
Most tools target a distinct resource/action pair, and descriptions clearly delimit nearby operations such as track gain vs. send gain vs. region gain. The very large surface creates some risk of misselection among similar setter/getter families, but the naming and descriptions generally keep boundaries clear.
The tool set overwhelmingly follows a verb_noun snake_case convention, with predictable list/get/create/delete/set families. Minor deviations like ping, doctor, play, stop, undo, and redo are conventional command names and do not seriously break consistency.
Eighty tools is far beyond a practical, well-scoped MCP surface and will burden agent selection even though the DAW domain is broad. Many capabilities are legitimate, but the set is too large to be easily discoverable or safely composed without strong grouping.
Coverage is extensive across session, track, group, transport, region, MIDI, plugin, send, port, automation, undo, rendering, and analysis workflows. Some minor DAW lifecycle gaps remain, such as tempo-map inspection, marker management, and richer track routing operations, but core workflows are well represented.