omnidaw-agent-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| --domains | No | Comma-separated list of API domains to expose, e.g. session,tracks,clips,theory. CLI flag: --domains <list>. | |
| --allow-risk | No | Set to "true" to explicitly authorize risky operations. CLI flag: --allow-risk. | false |
| --allow-write | No | Set to "true" to explicitly authorize project edits within the authorized --output-root. CLI flag: --allow-write. | false |
| --output-root | No | Authorized root directory for project edits and exports. CLI flag: --output-root <path>. | |
| --allow-overwrite | No | Set to "true" to allow session.save / export.render to replace existing files inside --output-root. CLI flag: --allow-overwrite. | false |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| session_infoA | Overview of the open project: name, unsaved changes, sample rate, number of tracks, scenes and return buses, and whether the audio engine runs. Call this first to orient yourself. |
| session_saveA | Save the project with its audio collected next to it, to its own file or to an absolute .omni path (a new name becomes the project's). Does not overwrite another existing file unless asked. |
| transport_getA | Play / record state, tempo (BPM), time signature and the playhead position in beats. |
| transport_playA | Start playback from the playhead. Does nothing if already playing. |
| transport_stopA | Stop playback (and a running recording, which is then kept). |
| transport_set_tempoA | Set the project tempo in BPM (40-240). Arrangement clips keep their musical position. Undoable. |
| transport_seekA | Move the playhead to a song position in beats (0 = song start). |
| tempo_getB | The project tempo, the tempo map (tempo changes and ramps over the song) and the time signature changes. |
| tempo_set_mapA | Replace the tempo map: points at song beats with a tempo, each a step or a linear ramp to the next. Timeline clips, automation, markers and the loop stay on their beats. Empty points = one tempo (transport.set_tempo). A step at a section boundary plays exactly; a ramp inside a MIDI clip is followed block by block. Undoable. |
| tempo_set_time_signaturesA | Replace the time signature changes: from a bar on, so many beats of a unit (7/8, 3/4, …). Empty = the project signature everywhere. Undoable. |
| groove_getA | The project groove every clip follows (unless its track opts out): style, amount, grid, accent, lean, humanize; and which tracks play straight. |
| groove_setA | Change the project groove (fields left out stay): style (straight, mpc, jazz, nested, push, drunk, samba, waltz, custom), amount 0-1, grid 8th/16th/32nd, accent, lean_ms, humanize_ms, humanize_vel, seed. Picking a style without amount or grid takes the style's own. Undoable. |
| groove_set_trackA | Whether a track follows the project groove (false = it plays straight, e.g. a tight bass under swung hats). Undoable. |
| tracks_listA | Every track in mixer order with its id, kind (midi/audio/group/vca), instrument, fader (dB), pan, mute/solo/arm, colour, group, insert effects and send levels. Use the ids in later calls; indices shift when tracks move. |
| tracks_createA | Add a track at the end. kind 'midi' plays notes through an instrument: pass an instrument from instruments.list: a builtin URI or an installed plugin (its uri = path, or its name). Without one the track is silent. Plugins load in the background: their parameters show in params.list a moment later. kind 'audio' plays samples. Returns the new track. Undoable. |
| tracks_updateA | Change a track's name, fader (volume_db, up to +6 dB), pan (-1..1), mute, solo or colour. Only the fields given change. Returns the track. One undo step (solo is monitoring and is not recorded). |
| tracks_deleteA | Delete a track with its clips, devices and automation. Groups are not deleted this way (ungroup first). Indices of later tracks shift down. Undoable: undo rebuilds the whole track, instrument state included. |
| tracks_duplicateA | Copy a track (instrument, clips, effects, mixer settings, automation) right after it, named ' (Copy)'. A plugin instrument loads in the background: the copy shows in tracks.list a moment later. Undoable. |
| tracks_set_instrumentA | Replace the instrument of a MIDI track with one from instruments.list (builtin, or an installed plugin, loaded in the background). The track keeps its name, clips, effects and mixer settings. Undoable: undo brings the previous instrument back with its sound. |
| tracks_moveA | Move a track (a group with all its members) right before another track, joining that track's group, or to the end when 'before' is absent. Returns the new track order. Undoable. |
| instruments_listA | Instruments that tracks.create can load: name, family and the URI to pass as 'instrument'; installed plugins (group Plugin, with vendor and format) after the builtins. Families: Synth (Omni Synth = subtractive/wavetable all-rounder), Keys (Piano), Physical model (strings, winds, plucked, mallets), Drums (TOMNIC drum synth), Image to sound, DJ. |
| instruments_presetsA | Preset files (.fxp) installed with the external plugin on a track, e.g. Surge XT's factory patches: name, category (their folders) and path. Filter with query words ("bass reese", "leads"); pages of up to 200. |
| instruments_load_presetA | Load a preset file (from instruments.presets) into the plugin on a track: its whole sound, as the plugin's own preset browser would. Then params.list shows the new values to tweak. Undoable. |
| scenes_listA | Scene rows of the session: index, name, colour and how many tracks have a clip in the row. Clip slot N of every track belongs to scene N. |
| scenes_launchA | Launch every clip of a scene row together, quantised like a click on the scene. Starts the transport unless start_transport is false. |
| scenes_updateA | Rename or recolour a scene row (e.g. 'Intro', 'Drop'). Undoable. |
| clips_generate_melodyA | Write a melody into a MIDI slot with the piano roll's melody generator: a style (stepwise_flow, minimal_cell, classical_arch, funk_groove, celtic_reel, bebop_line, arpeggio_loop, synth_arp, sequence_run, ambient_drift, tension_build, modal_motive), a key, bars, register and density. It sits on the chords of the slot's chord lane, or of chords_from (e.g. the pad slot written by clips.write_progression). Same seed, same melody. Undoable. |
| clips_listB | The session clip slots (scene rows) of a track: empty or not, kind (midi/audio/sequencer), loop length in beats, note count, playing / queued. |
| clips_get_notesA | Notes of a session MIDI clip (pitch, start and duration in beats, velocity) and its loop length. |
| clips_write_midiA | Write notes into a session clip slot of a MIDI track, creating the clip if the slot is empty. mode 'replace' (default) leaves exactly these notes, 'merge' adds them. length_beats sets the loop (default: the notes rounded up to whole bars). Times are in beats from the clip start (1 beat = a quarter note; in 4/4 a bar is 4 beats). The clip loops; launch it with clips.launch. Undoable. |
| clips_launchA | Play a session clip, quantised like a click on its slot. Starts the transport unless start_transport is false. |
| clips_stopA | Stop the session clip of one track, or of every track when no track is given. |
| clips_write_progressionA | Render a chord progression (text, library or generated, see theory.progression) into a session slot of a MIDI track and set the clip's chord lane, so the user sees the chords in the piano roll. The loop length is the progression's. Replaces the clip's notes. Undoable. |
| clips_write_drumsA | Write a drum pattern into a session slot of a TOMNIC track (TOMNIC plays its own step pattern, not clip notes). Each lane is one voice (kick, snare, hihat, bass, tom, perc, cymbal, fx, or 0-7) with a step string: x = hit, X = accent, . = rest; '|' and spaces may mark bars. At rate 1/16 sixteen steps are one 4/4 bar, e.g. kick "x...x...x...x...", snare "....x.......x...". Lanes may differ in length (polymeters). Replaces the pattern, or with mode merge only the lanes given. Undoable. |
| clips_duplicateA | Copy a session clip to another slot, on the same track or another one of the same kind (MIDI to MIDI, audio to audio). Overwrites the target. Undoable. |
| clips_transformA | Edit every note of a MIDI clip at once: transpose (semitones), quantize starts to a grid in beats (0.25 = 1/16 in 4/4) with a strength, scale and offset velocities. Undoable. |
| clips_set_lengthA | Set the loop length of a session clip in beats (notes past the end stay but do not play). Undoable. |
| clips_clearA | Empty a session clip slot (notes, audio, sequencer). Undoable. |
| theory_scaleA | The seven degrees of a key (names, pitch classes, MIDI notes in the middle-C octave) and its diatonic chords as numerals, triads and sevenths. Use it to stay in key when writing melodies and bass lines. |
| theory_chordA | Notes of a chord symbol (C, Am7, F#m7b5, Bbmaj9, G7/B, Dsus4, …): pitch classes, names and MIDI notes in close position from the root. |
| theory_progressionA | Turn a chord progression into voiced, voice-led notes ready for clips.write_midi: from text (numerals or symbols), from the library, or generated in a style. Optional bass line and playing pattern (arpeggios, pulses, strums, …). Deterministic. To write it straight into a clip with its chord lane, use clips.write_progression. |
| theory_harmonizeA | Find chords for the melody in a MIDI slot, in a key and a generator style (theory.vocabulary): one chord per harmonic-rhythm slot, chosen so the melody's strong notes are chord tones. fit 0 follows the style's habits, 1 the melody. Returns the chords; with write_to also writes them into a slot (performed like clips.write_progression). Undoable. |
| theory_analyzeA | The chords a MIDI clip's notes spell, with symbols and numerals, one per resolution_beats (default a bar); the key is estimated from the notes unless given. Use it to understand a user's part before writing around it. |
| theory_libraryA | Search the 240 named progressions (pop, rock, jazz, soul, blues, gospel, classical, modal, electronic, film, world, dark…). Pass a name to theory.progression or clips.write_progression as 'library'. |
| theory_vocabularyA | Every name the theory methods accept: modes, generator styles, playing patterns, library categories. |
| arrangement_getA | The song on the timeline: its length, whether the arrangement or the session is playing, the loop region, the markers (sections) and every track's clips with start and length in beats. |
| arrangement_build_songA | Lay a song out on the timeline from session scenes: each section plays one scene row for a number of bars (e.g. intro 8, verse 16, drop 16, outro 8), every MIDI track's clip in that row copied and repeated to fill it, a marker per section; TOMNIC patterns go on as their notes. Audio tracks are reported as skipped. Refuses if the range already holds clips unless clear_existing. One undo step. Then arrangement.play. |
| arrangement_place_clipA | Copy one session clip onto its track's timeline at start_beat; length_beats longer than the clip repeats it. MIDI tracks. Undoable. |
| arrangement_clearA | Remove timeline clips starting inside a range (default: all), on one track or all. Undoable. |
| arrangement_edit_clipA | Change one timeline clip (index from arrangement.get): move it, change its length (MIDI grows or shrinks, audio only shrinks), mute it, rename it, set its gain. Fields left out stay. E.g. mute the bass in the second half of a drop after copying it there. Undoable. |
| arrangement_copy_clipA | Copy one timeline clip to another beat, on the same track or another one (to_track; MIDI clips go to MIDI tracks). The copy is independent: edit or mute it on its own to make a variation. Undoable. |
| arrangement_remove_clipA | Delete one timeline clip (index from arrangement.get; later clips on the track move down one index). Undoable. |
| arrangement_set_loopA | Set and enable (or disable) the arrangement loop region in beats. Undoable. |
| arrangement_playA | Play the timeline from a beat: every track follows the arrangement again (like Back to Arrangement), the playhead moves, playback starts. |
| markers_addA | Add a marker (or, with end_beat, a section region) to the timeline. Undoable. |
| markers_removeA | Remove a marker by its index from arrangement.get. Undoable. |
| automation_listB | The automation lanes of a track on the arrangement timeline: what each drives (its key), how many segments and points, the automated span in beats. |
| automation_writeA | Automate a track's volume, pan or any parameter over the song: points at song beats with values in the parameter's own unit; the lane is created if needed and its automation replaced. E.g. a filter sweep through a break: {param: "instrument:16", points: [{beat: 96, value: 400}, {beat: 128, value: 8000}]}. Plays when the arrangement plays. Undoable. |
| automation_clearA | Remove the automation of one parameter on a track (the lane stays, empty). Undoable. |
| audio_importA | Load an audio file (WAV, AIFF, FLAC, MP3, OGG) into a session slot of an audio track, as dropping it from the browser does; arrangement.place_clip then puts it on the timeline. Needs file access, granted in Omni's Settings (AI Create). Undoable. |
| audio_transcribeA | Audio to notes with Basic Pitch: a file (path) or the audio in a session slot (track + slot). mode poly (chords), melody (one line) or bass. Returns a job; its result has the notes in beats at the project tempo, ready for clips.write_midi, and the detected length. File paths need file access (Settings, AI Create). |
| audio_split_stemsA | Split a WAV mix into vocals, drums, bass and other with Demucs (the model downloads on first use). Returns a job; its result has the four file paths, which audio.import can load. Needs file access (Settings, AI Create). |
| sampler_getB | The sampler of an audio clip: file, length, playback mode, root note, transpose, envelope and its slices (index, the note that plays it, start and end in seconds). |
| sampler_setA | Change how an audio clip's sampler plays (fields left out stay): playback_mode one_shot, loop, slice, gate, granular, warp; root note, transpose in semitones, reverse, envelope (attack/decay/release ms, sustain 0-1). Undoable. |
| sampler_sliceA | Cut an audio clip into slices, as the sample editor's slice detection does: on transients (sensitivity), into equal parts (count) or on beats (division per beat at the clip's tempo). A clip holds at most 92 slices (notes 36-127): slice a short loop, not a whole song. Switches the clip to slice mode: each slice gets a note, so clips.write_slices can play patterns and melodies from them. Returns the slices. Undoable. |
| clips_write_slicesA | Write which slices of a sliced audio clip play when (replacing its notes): steps with a slice index, start and length in beats, velocity, and pitch in semitones, so one slice can play a melody (a vocal chop, a stab) and many slices a rearranged break. Undoable. |
| devices_typesA | Omni's builtin effects that devices.add can insert, with their family: EQ, Filter, Compressor, Limiter, MultibandDynamics, Noise Gate, Transient Shaper, Saturator, Delay, Reverb, Chorus, Phaser and creative ones. |
| devices_listC | The effects of a chain in signal order: a track's inserts ({"track": id}), a return bus ({"return_bus": n}) or "master". Each with slot, name, kind (builtin/plugin/script), bypass and parameter count. |
| devices_getB | Every parameter of a builtin effect with its current value, range, default, unit (dB, Hz, ms, %) and group; a choice lists its options (index = value, e.g. Shape 4 = HighPass). Values are in those units, not 0..1. |
| devices_addA | Insert a builtin effect (a name from devices.types) into a chain, at the end or at 'position'. It starts at its default settings; shape it with devices.set_params. Returns the chain. Undoable. |
| devices_removeA | Remove an effect from a chain; later slots move up. Undoable. |
| devices_set_bypassA | Bypass (true) or enable an effect; the switch crossfades, no click. Useful to compare before / after with mix.meters. Undoable. |
| devices_set_paramsA | Set several parameters of a builtin effect at once, by name (as devices.get lists them, case-insensitive) or index, in the parameter's own unit. All are checked against their ranges before any changes. One undo step. Returns the device with its new values. |
| midi_fx_typesA | MIDI effects a track can put in front of its instrument: transforms (Arpeggiator, Chord, Scale, Velocity, Note Length, Note Echo, Random, Ornaments, Tuplets) change the notes going through; generators (Marbles, Markov, L-System, Cellular, Thue-Morse, Recaman, Sequence, Shepard, Walks) play their own, locked to the song while a clip plays. |
| midi_fx_listB | The MIDI FX chain of a track, in processing order. |
| midi_fx_getB | Every parameter of one MIDI FX slot: name, value, range, default. |
| midi_fx_addA | Append a MIDI effect from midi_fx.types to a track's MIDI FX chain, with its default settings. Undoable. |
| midi_fx_removeA | Remove one MIDI FX slot; later slots move down. Undoable. |
| midi_fx_set_paramsA | Set parameters of one MIDI FX slot by name (or index), values in each parameter's range from midi_fx.get. Undoable, one step per call. |
| midi_fx_renderA | Play one MIDI FX slot offline over some bars and write what it played into a session slot as notes: a Markov / L-System / Marbles line becomes an editable clip, an Arpeggiator over the chord in input_slot becomes the arpeggio. The effect is bypassed afterwards (bypass false keeps it on). Undoable. |
| midi_fx_set_bypassB | Bypass (or re-enable) one MIDI FX slot. Undoable. |
| mixer_add_returnA | Add a return bus (e.g. 'Reverb', 'Delay'): put an effect on it with devices.add ({"return_bus": n}, usually at 100% mix) and feed it from tracks with mixer.set_send. Returns the mixer. Undoable. |
| mixer_remove_returnA | Delete a return bus with its effects and every track's send to it. Later buses move down one index. Undoable (the sends come back too). |
| mixer_getA | Master fader (dB) and balance, and the return buses (index, name, fader, insert count). Track faders and sends are in tracks.list. |
| mixer_set_sendA | Send level from a track to a return bus in dB (up to +6; -120 or lower = off), e.g. to put a part into the reverb on a return. Undoable. |
| mixer_set_masterA | Master fader in dB (up to about +6) and balance (-1..1). Prefer leaving the master at 0 dB and balancing the tracks. Undoable. |
| mixer_set_returnC | Fader of a return bus in dB. Undoable. |
| params_listA | Every parameter of a track: its instrument (builtin synth or VST3 / CLAP plugin) and every insert effect, plugins included, with key, name, device, group, range, default and current value. Plugins have hundreds: narrow with filter (words that must all appear, e.g. 'filter cutoff') and page with offset / limit (default 100). |
| params_setA | Set parameters of a track by their params.list keys (instrument:, fx::), each in its own range (plugins are usually 0-1). All are checked before any changes; one undo step. For builtin effects devices.set_params by name is simpler. |
| mix_metersA | Live levels, as the mixer meters show them: per track peak/RMS (dBFS) and EBU R128 loudness (momentary, short-term, integrated LUFS, true peak dBTP); on the master also stereo correlation and loudness range (LU). Meters only move while audio plays: start the transport, wait a few seconds, then read. null = silence or not measured yet. |
| analysis_captureA | Record what the master or one track plays for a few seconds (default 8, 1-30) and analyse it in the background: peak, true peak, RMS, crest factor, clipping, DC; LUFS integrated / short-term / momentary and loudness range, short-term per second; stereo correlation, width and mono loss; tonal balance (sub, bass, low-mid, mid, high-mid, high, air) and a 1/3-octave spectrum with per-band width. Starts playback if stopped. Returns a job id at once: call jobs.wait with it. One capture at a time. |
| analysis_fileA | Analyse an audio file (WAV, FLAC, MP3, OGG, AIFF) the same way as analysis.capture: a reference track to compare the mix with (analysis.compare), or an exported master to master.check. Reads at most the first 10 minutes. Returns a job: jobs.wait for it. |
| analysis_compareA | Where two finished captures (e.g. kick and bass, vocal and guitars) compete: band by band levels and the bands where both carry energy within a few dB of each other, strongest first. The usual cure is an EQ cut on one of them there (devices.add EQ + devices.set_params). |
| jobs_getA | State (running / done / failed), progress and, once done, the result of a job started by another call. |
| jobs_waitA | Wait until a job finishes (at most timeout_seconds, default and limit 9) and return it as jobs.get does; call again while it is still running. |
| master_targetsA | Delivery targets: streaming platforms (Spotify, Apple Music, YouTube, Tidal, Amazon Music, Deezer), podcast, broadcast (EBU R128, ATSC A/85) and a club convention, each with integrated LUFS, tolerance and true-peak ceiling. |
| master_checkA | Pass / fail of a finished master capture (analysis.capture of "master", or analysis.file of an exported mix) against a target: loudness gap in LU, true peak against the ceiling, the gain that would hit the target, and notes (short capture, clipping, over-limiting, phase). |
| master_build_chainA | Put a mastering chain at the end of the master: an optional glue Compressor (2:1, slow attack, soft knee) and a true-peak Limiter with its ceiling at the target's. With a capture job of the master, the compressor threshold and the limiter's input gain are set from it to approach the target loudness. Refuses if the master already has a Limiter (adjust that one with devices.set_params). One undo step. Then capture again and master.check. |
| export_renderA | Render the arrangement (start_beat to end_beat, default the whole song) to a WAV file, as the Export dialog does: in real time through the audio device, or with fast offline (faster than real time, the same mix), optionally normalised to a loudness target. Returns a job: jobs.wait until done; the result has the path and an analysis of the written file. Writes only absolute .wav paths and does not overwrite unless asked. Session clips play only if recorded into the arrangement. |
| export_stemsA | Render one WAV per track (all audible tracks, or the ones listed) into a folder, offline and faster than real time: each stem is its track soloed, with its sends' returns, without the master chain unless through_master. Files are named ' .wav'. Returns a job whose result lists the files. |
| edit_undoA | Undo the newest step in Omni's history (the user's or yours; every edit call of this API is one step labelled 'API: ...'). Returns what was undone. |
| edit_redoA | Redo the step undone last. Returns what was redone. |
| agent_statusB | Catalog provenance, capabilities and enforced operator policy |
| agent_inspectC | Compact project inspection; metadata is untrusted data |
| agent_previewC | Preview composable official calls; symbolic references use {$ref: alias.id} |
| agent_applyB | Apply a previously returned preview once, subject to operator startup policy |
| agent_loop_previewC | Preview deterministic native four-part electronic loop using live instruments |
| agent_arrange_previewC | Preview sections, duplication/transforms, automation and save |
| agent_arrange_timelineB | Preview batches of at most 32 timeline mutations with inter-batch checkpoints |
| agent_repeat_previewC | Preview consecutive placements using explicit native clip length in beats |
| agent_midi_previewB | Parse bounded local SMF/RMID under output-root and preview MIDI notes; metadata is reported, never applied |
| agent_measureC | Measure master or track, propose mastering chain, no perceptual claims |
| agent_export_previewC | Preview render/stems over an explicit beat range with bounded job waiting; no guarantee of audible content |
| agent_waitC | Bounded job waiting with progress, no restart on timeout |
| agent_verify_wavA | Read actual output PCM; check duration/rate/channels and non-silence (peak below silence_floor_dbfs, default -80, is rejected as silent or dither-only) |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 115 tools
The core DAW tools mostly target distinct resources and actions, but there is meaningful overlap between transport_get and tempo_get, transport_set_tempo and tempo_set_map, and jobs_wait versus agent_wait. The large agent_* family (agent_preview, agent_apply, agent_arrange_preview, agent_arrange_timeline, agent_measure, agent_export_preview) also duplicates native arrangement, mastering, analysis and export operations, making boundaries unclear. An agent can often tell tools apart, but the parallel native/preview/agent layers create real misselection risk.
Most tools follow a predictable domain_action snake_case pattern (tracks_list, clips_write_midi, mixer_set_send, devices_add), which is easy to scan. Minor deviations exist, such as agent_* tools using a different naming style and some domain_verb forms like transport_play versus noun-like session_info, but the overall convention is stable.
115 tools is far beyond a well-scoped surface, even for a DAW with many domains. The large agent_* preview/wrapper family adds substantial duplication on top of already complete native tools, making the set unwieldy and hard to navigate.
The surface covers an unusually broad DAW lifecycle: transport, tracks, session clips, arrangement, automation, devices, MIDI FX, mixer, theory, audio analysis, mastering, export and jobs. Gaps are minor, such as no explicit scene delete, limited note-level editing, and no track group/ungroup operation, but most workflows can be completed or worked around.