Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
--domainsNoComma-separated list of API domains to expose, e.g. session,tracks,clips,theory. CLI flag: --domains <list>.
--allow-riskNoSet to "true" to explicitly authorize risky operations. CLI flag: --allow-risk.false
--allow-writeNoSet to "true" to explicitly authorize project edits within the authorized --output-root. CLI flag: --allow-write.false
--output-rootNoAuthorized root directory for project edits and exports. CLI flag: --output-root <path>.
--allow-overwriteNoSet 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

CapabilityDetails
tools
{
  "listChanged": false
}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.1/5.0

Scored across 115 tools

Disambiguation3/5

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.

Naming Consistency4/5

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.

Tool Count1/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues