LiveSession MCP
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| ABLETON_HOST | No | Host of the Remote Script. Default: localhost | |
| ABLETON_PORT | No | Port of the Remote Script. Default: 9877 | |
| LIVESESSION_TOOLSETS | No | Tool groups to expose (e.g. core,compose,mix,listen). Default: all | |
| LIVESESSION_LISTEN_DIR | No | Where you export bounces for listening. Default: ~/Music/LiveSession/Listen | |
| LIVESESSION_CATALOG_DIR | No | Plug-in catalogue, snapshots, layouts directory. Default: app data folder |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
LiveSession MCP controls a running Ableton Live (11 or 12) through its Remote Script, and reads Live Sets on disk with Live closed.
Conventions
Indices are zero-based (tracks, clips/scenes, devices, returns). Time is in beats (quarter notes); a 4/4 bar is 4 beats. Session clips are addressed by (track_index, clip_index = scene row).
Start with get_session_snapshot (or get_session_info + get_track_tree) before editing.
Prefer semantic tools (add_effect, set_control, apply_chain_recipe, write_chords...) over raw parameters.
Group several edits with run_batch: one round trip, one undo step.
Safety
Tools marked destructive delete or overwrite material. Before a destructive step on a saved set, the server saves it first so Live keeps the previous version in the project's Backup folder.
undo reverts the last steps. Mix snapshots (save_mix_snapshot) capture faders, sends and device values.
What Live's API can't do, and what this server does instead
Export: prepare_export opens the Export dialog; listen_latest then analyses the bounce.
Save / freeze / bounce / group: run through Live's menu (save_live_set, freeze_track, group_tracks).
Third-party plug-in parameters: only those Live exposes (Configure); get_plugin_profile knows them all, and process_audio_with_plugins renders audio through any plug-in offline.
Arrangement automation envelopes and tempo automation are not reachable; use clip automation.
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
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_session_infoB | Get detailed information about the current Ableton session Parameters:
|
| get_remote_script_infoA | Report Ableton Remote Script version and capabilities (handshake). Use this to verify the Live-side bridge matches this MCP server package. |
| get_track_infoC | Get detailed information about a specific track in Ableton. Parameters:
|
| get_clip_notesA | Read all MIDI notes from a Session-view clip. Returns pitch, start_time, duration, velocity, mute (and extended fields when available). Parameters:
|
| get_device_parametersB | Read all parameters for a device on a track (name, value, min, max). Parameters:
|
| set_device_parameterA | Set a device parameter to a specific value. Use get_device_parameters first to discover parameter indices and ranges. Parameters:
|
| get_session_snapshotA | Capture a full project state snapshot for trajectory recording. Includes session metadata, every track (mixer, devices, session clips, arrangement clips), optional MIDI notes, and optional device parameters. Used to version musical state S_t → S_{t+1}. Parameters:
|
| create_midi_trackB | Create a new MIDI track in the Ableton session. Parameters:
|
| create_audio_trackA | Create a new audio track in the Ableton session. Use this for recorded or imported audio (samples, stems, vocals). For MIDI instruments use create_midi_track instead. Parameters:
|
| set_track_nameB | Set the name of a track. Parameters:
|
| create_clipB | Create a new MIDI clip in the specified track and clip slot. Parameters:
|
| create_audio_clipA | Create a new audio clip in an audio track's clip slot by importing a file. Requires Ableton Live 12.0.5 or newer — the underlying ClipSlot.create_audio_clip Live API was introduced in 12.0.5 and is not available in earlier 12.0.x releases. Parameters:
|
| add_notes_to_clipB | Add MIDI notes to a clip. Parameters:
|
| clear_notes_from_clipA | Remove all MIDI notes from a Session clip. Writes are additive (add_notes_to_clip only appends), so to truly modify a clip you clear it first, then add the new notes. Use this with get_clip_notes and add_notes_to_clip for a real read -> modify -> write loop: read the notes, edit the list, clear_notes_from_clip, then add_notes_to_clip the edited notes. Parameters:
|
| set_clip_nameA | Set the name of a clip. Parameters:
|
| set_arrangement_clip_nameA | Set the name of a clip placed in the Arrangement timeline. Parameters:
|
| set_tempoB | Set the tempo of the Ableton session. Parameters:
|
| load_instrument_or_effectB | Load an instrument or effect onto a track using its URI. Parameters:
|
| fire_clipC | Start playing a clip. Parameters:
|
| stop_clipC | Stop playing a clip. Parameters:
|
| delete_clipA | Delete the clip in the given clip slot, freeing it for reuse. Use this before create_clip when you want to overwrite an existing clip (create_clip itself refuses to write into an occupied slot). Parameters:
|
| start_playbackB | Start playing the Ableton session. Parameters:
|
| stop_playbackB | Stop playing the Ableton session. Parameters:
|
| get_browser_treeA | Get a hierarchical tree of browser categories from Ableton. Parameters:
|
| get_browser_items_at_pathB | Get browser items at a specific path in Ableton's browser. Parameters:
|
| load_drum_kitA | Load a drum rack and then load a specific drum kit into it. Parameters:
|
| switch_to_arrangement_viewB | Switch Ableton's main window to the Arrangement view. Parameters:
|
| set_arrangement_timeA | Move the arrangement playhead to a specific position. Parameters:
|
| get_arrangement_clipsA | List all clips placed in the Arrangement timeline for a track. Returns each clip's name, start_time, end_time, length, and type. Parameters:
|
| duplicate_to_arrangementA | Copy a Session-view clip into the Arrangement timeline. Uses Live's track.duplicate_clip_to_arrangement() API (Live 11 / 12). The clip is placed at destination_time beats from the start of the arrangement on the same track it lives in. Typical workflow:
Parameters:
|
| create_locatorA | Create a named locator (cue point) in the Arrangement at a beat position. If a locator already exists at that beat (within ~1e-3 tolerance) it is renamed instead of toggled off. Time is in beats from the start of the arrangement (e.g. 0.0 = start, 16.0 = bar 5 in 4/4). Parameters:
|
| get_mixerB | Volume, pan, mute, solo, arm, sends, colour and device names for every track, return and master. Volume is Live's 0.0-1.0 fader value (0.85 = 0 dB); volume_display shows dB. |
| set_mixerA | Set any of a track's mixer controls in one call; omitted controls are left alone.
|
| delete_trackB | Delete a track or return track. Undo with undo() if it was a mistake. |
| duplicate_trackB | Duplicate a track with its clips and devices; the copy lands right after it. |
| set_track_colorB | Set a track's colour by Live palette index (0-69). |
| delete_deviceB | Remove a device or plug-in from a track, by index or (fuzzy) name. |
| set_device_onC | Turn a device on or off (bypass), by index or (fuzzy) name. |
| move_deviceB | Reorder a device in its chain, or move it to another track (target_track_index). |
| undoA | Undo the last N actions in Live (same as Ctrl+Z). |
| redoA | Redo N undone actions in Live (same as Ctrl+Y). |
| list_pluginsA | List installed VST3/AU plug-ins Live can load, with vendor folder. Filter with query (name or vendor). |
| load_pluginA | Load a plug-in onto a track by (fuzzy) name, e.g. "Pro-Q 4", "valhalla vintage", "Keyscape". Effects append to the end of the chain; instruments replace the track's instrument. track_type: "track" (default), "return" or "master" (track_index is ignored for master) |
| list_racksB | List device/rack presets (.adg/.adv) saved in the User Library — e.g. your vocal-chain templates. |
| load_rackC | Load a saved rack/preset from the User Library onto a track by (fuzzy) name. |
| get_device_paramsB | Read a device's or plug-in's parameters with readable values (e.g. "300 Hz", "-3.0 dB"). query filters by parameter name. For plug-ins exposing only 'Device On', the result carries a hint: use Configure in Live (or plugin_window tools + computer use) to expose more controls. |
| set_device_paramA | Set one parameter on a device or plug-in, found by (fuzzy) name or index. Give exactly one of:
|
| get_plugin_presetsB | List the presets/programs a plug-in exposes to Live, and which one is selected. |
| set_plugin_presetC | Switch a plug-in to one of its exposed presets, by (fuzzy) name or index. |
| select_deviceB | Select a device and show Live's device view, so its Configure button and plug-in window toggle are on screen for computer use. |
| create_sceneB | Create a scene (row in Session view) at index (-1 = end), optionally named. |
| delete_sceneC | Delete a scene row. |
| fire_sceneC | Launch every clip in a scene row. |
| set_scene_nameC | Rename a scene (e.g. "Verse", "Chorus"). |
| set_clip_loopC | Set a Session clip's loop region in beats and/or turn looping on/off. |
| quantize_clipC | Quantize a clip. grid: 1/4, 1/8, 1/8t, 1/8+t, 1/16, 1/16t, 1/16+t, 1/32. amount 0.0-1.0. |
| transpose_clipB | Transpose a clip: MIDI notes are moved; audio clips get their pitch shifted. |
| set_clip_colorC | Set a clip's colour by Live palette index (0-69). |
| set_clip_automationC | Draw automation inside a Session clip as steps.
|
| clear_clip_automationB | Clear one parameter's automation from a clip, or all of it when parameter is omitted. |
| set_transportC | Arrangement record, Session record, overdub, metronome, loop region (beats) and time signature. Arm the tracks first with set_mixer(arm=True). |
| get_routingC | A track's audio/MIDI input and output routing, with every available option. |
| set_routingC | Set routing by (fuzzy) display name, e.g. input_type="Ext. In", input_channel="1". |
| list_live_windowsA | List open Ableton Live windows (main window and every floating plug-in window) with their screen position and size — use these coordinates to aim computer-use clicks. |
| focus_live_windowA | Bring an Ableton window (main or plug-in, matched by part of its title) to the front. |
| screenshot_live_windowA | Screenshot one Ableton window — e.g. a plug-in like "Pro-Q 4" — cropped to just that window. Bring it to the front first (focus_live_window) if something covers it. Image pixel (px, py) maps to screen (x + pxscale, y + pyscale) using the returned x, y, scale. |
| get_metersA | Live peak levels (0.0-1.0, 1.0 = 0 dBFS) of every track, return and the master, read right now. Call while playback runs to spot clipping or quiet tracks without exporting. |
| get_song_scaleA | The song's key and scale as set in Live 12 (root note, scale name, intervals). |
| set_song_scaleA | Set the song key, e.g. root="A", scale_name="Minor"; scale_mode=True highlights it in MIDI clips. |
| create_return_trackB | Add a return track (for shared reverb/delay); returns its return index for set_mixer sends. |
| create_arrangement_clipA | Create an empty MIDI clip directly in the Arrangement at beat |
| delete_arrangement_clipB | Delete an Arrangement clip (index as listed by get_arrangement_clips). |
| set_audio_clipB | Audio clip settings: gain (0-1), warping, warp_mode (beats, tones, texture, re-pitch, complex, complex pro — use complex pro for vocals/full mixes), pitch in semitones/cents, name. |
| search_browserA | Search Live's whole browser: instruments, audio_effects, midi_effects, sounds, drums, samples, plugins, user_library, packs. Load a result with load_browser_uri. |
| load_browser_uriB | Load any browser item (preset, sample, device, kit) by URI onto a track, return or the master. |
| set_sidechainB | Route a track (by name, e.g. "Drums") into a Compressor's sidechain input and switch S/C On. Live's API routes sidechains only into Compressor (not Glue Compressor, Gate or Auto Filter). |
| scan_plugin_catalogA | Profile installed VST3 plug-ins outside Live: every parameter (not just what Live exposes), presets, and a role (eq, compressor, reverb, piano...). Resumes where it stopped; call again while 'remaining' > 0; retry_failed re-tries plug-ins that failed before (e.g. after activating them). Modified binaries (broken signature, R2R imports) are listed as excluded, never loaded. |
| find_pluginsB | Catalogued plug-ins filtered by role (eq, compressor, limiter, deesser, gate, multiband, reverb, delay, saturation, modulation, mastering, pitch, piano, strings, drums, bass, synth) or name/vendor. |
| get_plugin_profileB | Full catalogue profile of one plug-in: all parameters with ranges and options, presets, roles, and its semantic map (mix/threshold/decay... -> real parameter names). |
| add_effectA | Add an effect or instrument by role — "reverb", "eq", "compressor", "deesser", "delay", "saturation", "limiter", "glue", "plate", "hall", "piano", "strings", "bass", "drums"... — using the best installed plug-in and falling back to Live's own device. prefer forces a specific one. |
| set_controlB | Set a musical control on ANY device without knowing its parameter names: control is one of mix, threshold, ratio, attack, release, output, input, decay, predelay, size, feedback, delay_time, cutoff, resonance, high_cut, low_cut, width, ceiling, gain, frequency. device is the device's name on the track. If the plug-in hasn't exposed it to Live, the reply names the exact plug-in parameter and the expose step. |
| build_chainC | Build an effect chain by purpose from whatever is installed: vocal, piano, strings, cello, bass, drums, bus, master. |
| create_song_templateB | Build a Nir Canaan-style singer-songwriter session: Piano, Cello, Strings, Bass, Drums, Lead and Backing Vocal tracks with instruments and chains, plus Vocal Plate / Hall / Delay returns and sensible sends. Uses the best installed plug-ins for each role. |
| write_chordsB | Write a chord progression by symbol into a Session clip (created if empty), with smooth voice leading.
|
| write_progressionC | Write a progression in roman numerals in any key, e.g. key="A", scale="minor", numerals=["i", "VI", "III", "VII"] or key="C", numerals=["I", "vi7", "IV", "V7", "bVII"]. |
| write_melodyB | Write a melody from scale degrees (1 = root, 8 = octave up, 0 = rest) and durations in beats. Scales: major, minor, harmonic minor, melodic minor, dorian, phrygian, lydian, mixolydian, locrian, major/minor pentatonic, blues, phrygian dominant. |
| humanize_clipB | Loosen an existing MIDI clip: small random timing (beats) and velocity changes. |
| chord_infoB | Spell chords without writing them: notes of each voicing, e.g. to check a progression. |
| save_mix_snapshotA | Save every track's mixer state and exposed device parameter values under a name (A/B compare). |
| list_mix_snapshotsB | List saved mix snapshots. |
| restore_mix_snapshotB | Bring the mixer (and device parameters) back to a saved snapshot. Tracks are matched by index and name. |
| expose_plugin_paramsA | Prepare exposing a plug-in's controls to Live (needed when get_device_params shows only 'Device On'). Selects the device, finds its window, lists the exact parameter names to touch (from the catalogue) and any saved GUI layout, and returns the computer-use steps. |
| save_plugin_layoutA | Remember where controls sit in a plug-in's window, as fractions of the window (0-1): {"Mix": {"x": 0.07, "y": 0.38}, "Decay": {"x": 0.21, "y": 0.42}}. Reused on any later session. |
| get_plugin_layoutC | A remembered plug-in GUI layout (control positions as window fractions), if one was saved. |
| process_audio_with_pluginsA | Render an audio file through catalogued plug-ins outside Live, to audition settings before committing. chain: [{"plugin": "ValhallaVintageVerb", "params": {"Mix": 25, "Decay": 2.5}}, ...] Values are in the units the plug-in displays (25 = 25 %, 2.5 = 2.5 s, 300 = 300 Hz) or option names; see get_plugin_profile for each parameter's range and units. Then analyse the result with listen_file (optionally against the original). |
| prepare_exportB | Set the loop/export range and open Live's Export Audio/Video dialog (Live's API has no export call), then return the steps to render into the listen folder for listen_latest / match_reference. |
| write_basslineA | Write a bass part that follows the chords (slash basses respected) into a Session clip. style: whole, root_fifth, pop8, ballad (root + passing note), walking, octaves, arp. low/high: MIDI range (28 = E1, the lowest bass string). |
| generate_melodyB | Generate a singable melody over a progression: chord tones on strong beats, mostly steps, a phrase shape and breaths. contour: arch, rise, fall, wave, question_answer. density 0..1 (0.3 ballad, 0.7 busy). Change seed for another idea; same seed = same melody. |
| write_drum_patternB | Write a drum pattern for a Drum Rack (GM layout: kick 36, rim 37, snare 38, hat 42, crash 49). style: ballad, pop, halftime, six_eight, brush_rim, four_floor, fill. notes remaps pads, e.g. {"crash": 48} — get_drum_pads shows what each pad holds. |
| swing_clipA | Swing a Session MIDI clip: delay off-beat 8ths (or 16ths) by amount (0..1 of the grid; 0.33 ≈ triplet feel). For Live's own grooves use set_clip_groove. |
| build_song_structureA | Lay a song out in the Arrangement from Session scenes, with a named locator per section. sections: [{"name": "Intro", "scene": 0}, {"name": "Verse 1", "scene": 1}, {"name": "Chorus", "scene": 2, "bars": 8}, ...] — each section copies every clip in that scene row to the timeline (repeated to fill "bars" if given, else the longest clip in the row). Tracks without a clip in the row stay silent. |
| get_locatorsA | All Arrangement locators (name, beat) and the song length. |
| set_locatorB | Create or rename a locator at a beat (reliable: waits for Live's playhead to move first). |
| delete_locatorC | Delete the locator at a beat. |
| duplicate_clip_loopC | Double a clip's loop with its notes (Live's 'Duplicate Loop'). |
| crop_clipC | Crop a clip to its loop/start-end region. |
| duplicate_clip_regionB | Copy a time range of a MIDI clip's notes to another beat inside the same clip. |
| get_track_treeB | Every track with its group membership, fold and freeze state. |
| set_track_foldB | Fold or unfold a group track. |
| press_live_shortcutA | Bring Live to the front and press keys there, e.g. "tab" (switch view), "ctrl+shift+r" (export), "shift+tab". Live ignores some synthetic Ctrl shortcuts (Ctrl+S, Ctrl+G): use run_live_menu for those. |
| run_live_menuA | Run any command from Live's menu bar by its label — "Save Live Set", "Freeze Tracks", "Flatten", "Bounce Tracks in Place", "Consolidate", "Group Tracks", "Ungroup Tracks", "Duplicate", "Insert Audio Track"... track_index selects that track first. No keyboard focus needed. Commands that act on a selection use what is selected in Live; check the result afterwards. |
| save_live_setA | Save the current Live Set (File > Save Live Set). A never-saved set opens Live's Save dialog for a name. |
| group_tracksA | Group a contiguous range of tracks into a Group Track and optionally name it. One track is grouped straight away. For a range, Live needs the track names selected by mouse (its API selects only one track): click the first track's name and shift-click the last, then call this. Anything other than exactly those tracks getting grouped is undone. |
| freeze_trackA | Freeze a track (Edit > Freeze Tracks) and wait until Live finishes rendering it; flatten=True instead prints it to audio for good (Edit > Bounce Tracks in Place: the track becomes an audio track and its devices are removed — undo restores them). Frees CPU from heavy plug-ins. |
| get_drum_padsC | The pads of the track's Drum Rack (also inside an Instrument Rack): note, name, devices. |
| load_drum_padB | Load a sample or instrument from the browser onto one Drum Rack pad (36 = C1 = first pad). query searches samples/drums/sounds/packs (e.g. "brush snare"); uri loads an exact search_browser hit. |
| load_sampleA | Put a sample into Simpler. query/uri: from Live's browser onto the track (an empty MIDI track gets a new Simpler). path: a .wav/.aif on disk replaces the sample in the track's existing Simpler. |
| set_simplerC | Simpler playback: mode classic / one-shot / slicing; slice_by transient, beat, region, manual; sensitivity 0..1 for transient slicing; warp the sample on/off. |
| insert_deviceA | Insert one of Live's own devices by name ("EQ Eight", "Compressor", "Utility"...) at a chain position (-1 = end) — faster than a browser search. |
| get_warp_markersB | Warp markers of an audio clip (beat_time in the song, sample_time in seconds in the file). |
| add_warp_markerB | Add a warp marker at beat_time (pinning the audio at sample_time seconds, or where it currently plays). |
| move_warp_markerB | Move the warp marker at beat_time by distance beats (stretches the audio around it). |
| remove_warp_markerC | Remove the warp marker at beat_time. |
| get_groovesB | Grooves in the Groove Pool and the song's global groove amount. |
| set_clip_grooveA | Apply a Groove Pool groove to a clip by name; amount = global groove amount (0-1.3, 0 = no effect). Live's API can't detach a groove again (pick None in the clip's Groove box in Live), so prefer swing_clip for a reversible swing. Load grooves into the pool by double-clicking them in Live's Grooves browser. |
| get_take_lanesC | A track's take lanes (comping) and the clips on each. |
| create_take_laneB | Add a take lane to a track (for comping several takes). |
| import_audio_to_arrangementA | Place an audio file on an audio track's Arrangement timeline at a beat (e.g. a vocal take or a reference). |
| match_referenceA | Compare a bounce with a reference song (level-matched tonal balance, loudness, width) and turn the differences into EQ moves. apply=True puts an EQ Eight named "Ref Match" on the master (or track_type/track_index) with those moves — strength 0..1 of the difference, capped at max_db. |
| gain_stageA | Play the song and watch every track's peak meter for a few seconds, then set faders so each track peaks around target_peak_db (default -6 dBFS) — a clean starting balance before mixing. Tracks that stay silent are left alone. apply=False only reports. |
| learn_plugin_profileA | Record the parameters a loaded plug-in exposes in Live into the catalogue. This is the fallback profile for plug-ins the offline scanner can't load (Keyscape, Pianoteq, LABS, Serum 2, MODO BASS...) and it refreshes what Live exposes for any plug-in after Configure. Then get_plugin_profile, set_control and add_effect can use it. |
| apply_chain_recipeC | Build a ready-dialled chain from Live's own devices (works on any machine, every parameter set): vocal_pop (EQ Eight HPF + presence, Compressor 3:1, de-ess, Glue), piano_ballad (gentle HPF, warm low-mid dip, light compression), strings_pad (HPF, air, wide), cello_solo, bass_warm, drums_soft, master_soft (gentle glue, EQ tilt, limiter at -1 dB). |
| inspect_live_apiA | Read-only look at Live's Python API: list the attributes (and simple values) of the object at a dotted path such as 'song', 'song.tracks[0].mixer_device' or 'app.browser'. contains filters names. Use it to check whether Live exposes something before writing a new command. |
| listen_latestA | Analyse the newest audio file in the listen folder (where bounces are exported): loudness, true peak, tonal balance, stereo, key and likely problems, plus a picture (spectrogram, spectrum, loudness over time). Use after the user (or prepare_export) bounced something from Live. |
| listen_fileA | Analyse a specific WAV/AIFF/FLAC file, optionally against a reference track (a commercial song in the same style): loudness and tonal-balance differences, level-matched. |
| list_exportsB | Audio files in the listen folder, newest first. |
| run_batchA | Run several tools in one call as ONE undo step in Live (one Ctrl+Z reverts them all). steps: [{"tool": "create_midi_track", "args": {"index": -1}}, {"tool": "set_track_name", "args": {"track_index": 3, "name": "Pad"}}, ...]. Results come back in order; with stop_on_error the batch stops at the first failure (earlier steps stay applied — call undo once to revert the batch). Desktop, export and analysis tools can't be batched. |
| session_diffA | See what changed in the open set. mark=True records the current state (do it before an edit); mark=False compares now with the last mark: tracks added/removed/reordered, devices, clips, faders, mute/solo, groups, returns, locators, tempo. |
| song_starterA | Start a song in a genre in one step: the session template (instruments, chains, returns) plus a first scene with chords, bass, drums and a melody that fit together. Genres: ballad, pop, mizrahi_pop, singer_songwriter, cinematic, house, six_eight. key/tempo override the genre's; change seed for another idea. build_template=False writes the parts into the existing Piano/Bass/Drums tracks instead. |
| write_euclideanB | Euclidean rhythms (pulses spread as evenly as possible over steps) into a Session clip. layers: [{"pitch": 36, "pulses": 4, "steps": 16}, {"pitch": 42, "pulses": 7, "steps": 16, "rotation": 2}, {"pitch": 37, "pulses": 3, "steps": 8}] — different step counts make polyrhythms. Classics: 3/8 tresillo, 5/8 cinquillo, 7/16 samba, 5/16 bossa. Pitches are Drum Rack pads (36 kick, 38 snare, 42 hat). |
| transform_clipA | Develop a motif from a Session MIDI clip and write the result to another slot (default: the next empty slot below; the same slot overwrites the source). Operations, all staying in the key: invert, retrograde, augment, diminish (amount = factor, default 2), transpose (amount = scale steps), sequence (repeats copies, each amount steps higher), additive (minimalist build-up), displace (amount = beats). key/scale default to the song's scale. |
| find_progressionsA | The progression library (45 named progressions): search by name, genre or mood — "pop", "sad", "mizrahi", "jazz", "house", "cinematic", "israeli"... Empty query lists them all. Play one with write_named_progression. |
| write_named_progressionC | Write a progression from the library (find_progressions) in any key, e.g. name="andalusian", key="A" -> Am G F E. style: close, open, spread, drop2, shell, rootless, quartal. |
| als_summaryA | Summarise a saved Live Set without opening Live: tempo, time signature, length, locators, scenes, every track with its devices and clips, returns, plug-ins used. path = an .als file or a project folder (newest set). detail=True includes full device trees and every clip. |
| als_lintA | Check a saved Live Set before sharing, mixing or archiving: missing samples, plug-ins missing or not installed here, uncollected files, tracks routed nowhere, soloed or muted tracks, MIDI without an instrument, faders above +6 dB, default names, no locators. Errors first. |
| als_diffA | What changed between two versions of a Live Set: tempo, tracks added/removed/renamed, fader, mute, routing and device changes, clips and note counts, locators, scenes, plug-ins. With only old_path: compares the newest copy in the project's Backup folder (old) with that set (new). |
| als_export_midiA | Export the MIDI clips of a saved Live Set as .mid files (one per clip, set tempo), with Live closed. track filters by track name; out_dir defaults to '/MIDI Export'. Also estimates the key. |
| preset_infoA | Look inside an .adg rack or .adv device preset: devices and chains, macro names and values, plug-ins and Max for Live devices it needs, and whether it needs Live Suite. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
| start_a_song | Start a new song: template, chords, bass, drums and a melody that fit together. |
| make_a_beat | Program drums: kit, groove, variation and fill. |
| mix_and_master | Balance, process and check the mix with real measurements (export -> listen -> fix loop). |
| analyze_and_improve | Review a song: structure, arrangement, technical problems and mix, with concrete fixes. |
| prepare_for_collaboration | Get a Live Set ready to send to another producer or a mixing engineer. |
| sound_design | Build a sound from installed instruments and effects. |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 148 tools
There are direct near-duplicate pairs (get_device_params vs get_device_parameters, set_device_param vs set_device_parameter) and many overlapping effect-loading paths (load_instrument_or_effect, insert_device, add_effect, load_plugin, load_browser_uri). Three separate progression-writing tools (write_chords, write_progression, write_named_progression) and multiple mixer/device-setting routes make tool selection error-prone.
Most names are snake_case verb_noun, but noun-only tools (chords, song_starter, session_diff, preset_info, song_starter) and inconsistent verb choices break predictability. The _param vs _parameter duplication and mixed legacy/new naming further muddy the convention.
148 tools is an extreme mismatch for a DAW-control server; even with broad Ableton functionality, the surface is far beyond a reasonable scope. Many niche tools (als_lint, als_diff, inspect_live_api, scan_plugin_catalog, save_plugin_layout) overwhelm the core workflow.
Coverage is very broad: tracks, clips, notes, mixer, devices, plug-ins, arrangement, browser, mixing, export, analysis, and songwriting are all represented. Only minor gaps (e.g., granular per-note editing and some clip lifecycle operations) keep it from perfect completeness.