Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
ABLETON_MCP_HOSTNoThe host the Ableton control surface listens on. It listens on localhost only by default; set this deliberately to change that.

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
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
get_session_infoA

Overview of the Live set: tempo, time signature, track and return counts, main track, transport state, song length and loop.

get_remote_script_infoA

Version and command list of the AbletonStudioMCP control surface running in Live, compared with this server. Use it when tools say Live is too old or not responding (ableton-studio-mcp doctor checks the whole setup).

get_session_snapshotA

Everything in the set at once: every track with its mixer, devices, Session and Arrangement clips, plus scenes, returns, the main track and locators. Handy to compare the set before and after a series of edits.

Parameters:

  • include_notes: Include the MIDI notes of every clip (default true)

  • include_params: Include every device parameter value (default true)

set_tempoB

Change the song tempo.

Parameters:

  • tempo: Beats per minute (Live accepts 20–999)

start_playbackA

Start the transport (plays from the playhead).

stop_playbackC

Stop the transport.

switch_to_arrangement_viewB

Bring Live's Arrangement view to the front.

set_arrangement_timeB

Move the playhead.

Parameters:

  • time: Song position in beats (0 = start; in 4/4, bar N starts at 4 × (N − 1))

create_locatorA

Put a named locator in the Arrangement. A locator already at that beat is renamed rather than removed. Playback must be stopped.

Parameters:

  • name: Label shown in Live ("Intro", "Drop", "Break"...)

  • time: Song position in beats

delete_locatorA

Remove a locator, found by position (exact) or by name. When several locators share the name nothing is removed and their positions are listed. Playback must be stopped.

Parameters:

  • name: Label of the locator

  • time: Its song position in beats (wins over name)

get_scenesA

List the Session scenes with their index, name and tempo.

create_sceneB

Add an empty scene.

Parameters:

  • index: Where to insert it (-1 = after the last scene)

delete_sceneB

Remove a scene together with every clip in its row. Ask the user first.

Parameters:

  • scene_index: The scene to remove

duplicate_sceneB

Copy a scene and its clips; the copy goes right below it.

Parameters:

  • scene_index: The scene to copy

fire_sceneC

Launch every clip in a scene's row.

Parameters:

  • scene_index: The scene to launch

set_scene_nameC

Rename a scene.

Parameters:

  • scene_index: The scene to rename

  • name: Its new name

undoA

Undo the last change(s) in Live, like Cmd/Ctrl+Z. Each tool call that changed the set is one step; tools that make many changes at once (drum patterns, progressions, arrangements, MIDI imports…) are one step too, as is everything between start_undo_group and end_undo_group. It is Live's own Undo: if the user edited the set meanwhile, their change comes first.

Parameters:

  • steps: How many steps to undo (1–50)

redoA

Redo what undo just took back (as long as nothing else changed since).

Parameters:

  • steps: How many steps to redo (1–50)

start_undo_groupA

Start grouping: every change until end_undo_group becomes a single undo step, so a whole request ("8 bars of techno with a bassline") can be taken back at once. Always call end_undo_group afterwards; a group left open is closed automatically after two minutes.

Parameters:

  • name: What the group is for (shown in Live's log)

end_undo_groupB

Close the undo group opened with start_undo_group.

get_track_infoB

One track in detail: name, mixer state, clip slots and device chain. Works for return tracks and the main track too.

Parameters:

  • track_index: The track (for "return", its position among returns; ignored for "master")

  • track_type: "track" (default), "return" or "master"

create_midi_trackB

Add a MIDI track (for instruments and drum racks).

Parameters:

  • index: Where to insert it (-1 = after the last track)

create_audio_trackC

Add an audio track (for samples, stems, recordings).

Parameters:

  • index: Where to insert it (-1 = after the last track)

set_track_nameC

Rename a track.

Parameters:

  • track_index: The track to rename

  • name: Its new name

delete_trackA

Remove a track and everything on it. Ask the user first. Tracks after it move up one index.

Parameters:

  • track_index: The track to remove

duplicate_trackA

Copy a track with its clips and devices; the copy goes right after it.

Parameters:

  • track_index: The track to copy

set_track_volumeA

Move a track's fader.

Parameters:

  • track_index: The track (ignored for "master")

  • volume: Fader position 0.0–1.0 (0.85 is 0 dB, 0.0 is silence)

  • track_type: "track" (default), "return" or "master"

set_track_panningB

Pan a track.

Parameters:

  • track_index: The track (ignored for "master")

  • panning: -1.0 hard left, 0.0 centre, 1.0 hard right

  • track_type: "track" (default), "return" or "master"

set_track_sendB

Set how much of a track goes to a return track.

Parameters:

  • track_index: The sending track

  • send_index: Which send (0 = A, the first return track)

  • value: Send amount 0.0–1.0

  • track_type: "track" (default) or "return"

set_track_muteB

Mute or unmute a track.

Parameters:

  • track_index: The track

  • mute: true mutes, false unmutes

  • track_type: "track" (default) or "return"

set_track_soloC

Solo or unsolo a track.

Parameters:

  • track_index: The track

  • solo: true solos, false unsolos

  • track_type: "track" (default) or "return"

set_track_armB

Arm a track for recording, or disarm it.

Parameters:

  • track_index: The track

  • arm: true arms, false disarms

create_clipA

Make an empty MIDI clip in a Session slot (the slot must be empty).

Parameters:

  • track_index: A MIDI track

  • clip_index: The Session slot (scene row)

  • length: Clip length in beats (default 4 = one bar in 4/4)

create_audio_clipA

Put an audio file into an empty Session slot of an audio track (Live 12.0.5 or newer).

Parameters:

  • track_index: An audio track

  • clip_index: The Session slot (must be empty)

  • path: Absolute path of the file (.wav, .aif, .mp3...)

set_clip_nameC

Rename a Session clip.

Parameters:

  • track_index: The track

  • clip_index: The Session slot

  • name: Its new name

set_arrangement_clip_nameA

Rename a clip in the Arrangement.

Parameters:

  • track_index: The track

  • clip_index: Position of the clip in get_arrangement_clips (ordered by start time)

  • name: Its new name

delete_clipC

Empty a Session slot (create_clip refuses occupied slots).

Parameters:

  • track_index: The track

  • clip_index: The Session slot to empty

delete_arrangement_clipA

Remove a clip from the Arrangement. Later clips on the track move down one index.

Parameters:

  • track_index: The track

  • clip_index: Position of the clip in get_arrangement_clips

fire_clipC

Launch a Session clip.

Parameters:

  • track_index: The track

  • clip_index: The Session slot

stop_clipC

Stop a playing Session clip.

Parameters:

  • track_index: The track

  • clip_index: The Session slot

get_clip_notesA

All the MIDI notes of a clip: pitch, start_time, duration, velocity, mute (plus probability and velocity deviation when Live has them). Times are in beats from the clip start. For an Arrangement clip the reply also has arrangement_start / arrangement_end and start_marker: without looping, a note sounds at arrangement_start + (start_time − start_marker).

Parameters:

  • track_index: The track

  • clip_index: Session slot, or position in get_arrangement_clips

  • location: "session" (default) or "arrangement"

add_notes_to_clipA

Add notes to a clip; existing notes stay. To replace notes, clear the clip (clear_notes_from_clip) or a range (remove_notes) first.

Parameters:

  • track_index: The track

  • clip_index: Session slot, or position in get_arrangement_clips

  • notes: [{"pitch": 60, "start_time": 0.0, "duration": 1.0, "velocity": 100, "mute": false}, ...] with start_time in beats from the clip start

  • location: "session" (default) or "arrangement"

clear_notes_from_clipA

Remove every note from a clip. Together with get_clip_notes and add_notes_to_clip this gives read → edit → write: read the notes, change the list, clear the clip, add the new list. For part of a clip use remove_notes.

Parameters:

  • track_index: The track

  • clip_index: Session slot, or position in get_arrangement_clips

  • location: "session" (default) or "arrangement"

remove_notesA

Remove only the notes starting inside a time window and a pitch range — to rewrite one bar, or one drum lane, then add the new notes.

Parameters:

  • track_index: The track

  • clip_index: Session slot, or position in get_arrangement_clips

  • from_time: Window start, in beats from the clip start

  • time_span: Window length in beats (default: until the clip end)

  • from_pitch: Lowest pitch of the range (0–127)

  • pitch_span: How many pitches from from_pitch (128 = all, 1 = just that note)

  • location: "session" (default) or "arrangement"

get_arrangement_clipsB

The clips a track has in the Arrangement, in time order, with their position, length and type. Their order is the clip_index other tools use.

Parameters:

  • track_index: The track

duplicate_to_arrangementA

Copy a Session clip into the Arrangement, on the same track. Repeat the call for every place the clip should play, then switch_to_arrangement_view to look at the result.

Parameters:

  • track_index: The track holding the Session clip

  • clip_index: Its Session slot

  • destination_time: Song position in beats where the copy starts

get_clip_loopB

A clip's loop switch, loop brace and start/end markers, and what actually plays. Beats, except seconds for an unwarped audio clip ("units" says which). Arrangement clips also report their place in the song.

Parameters:

  • track_index: The track

  • clip_index: Session slot, or position in get_arrangement_clips

  • location: "session" (default) or "arrangement"

set_clip_loopA

Change a clip's loop and markers; anything left out stays as it is.

With looping on, playback starts at start_marker and then repeats the brace (loop_start → loop_end); e.g. keep only the first bar of a 4-bar loop with loop_start=0, loop_length=4. With looping off Live plays loop_start → loop_end once, so markers given for such a clip are written to the brace. The writes are ordered so the start never passes the end; the reply shows what Live applied and lists any value it "adjusted". Switching warping off and on again resets an audio clip's warp markers.

Parameters:

  • track_index: The track

  • clip_index: Session slot, or position in get_arrangement_clips

  • location: "session" (default) or "arrangement"

  • looping: Loop switch

  • loop_start, loop_end: The brace (beats; seconds for unwarped audio)

  • loop_length: Alternative to loop_end: loop_end = loop_start + loop_length

  • start_marker, end_marker: Where playback starts and ends

get_clip_warpC

An audio clip's warp state: warping, warp mode (and the modes on offer), warp markers (beat_time ↔ sample_time in seconds), transposition, gain, clip length and file duration.

Parameters:

  • track_index: The track

  • clip_index: Session slot, or position in get_arrangement_clips

  • location: "session" (default) or "arrangement"

set_clip_warpA

Change an audio clip's warp settings; anything left out stays as it is. Give a loop's own tempo as original_bpm (sample names often carry it, "...131...") and it follows the song tempo: warping goes on and the warp markers are rebuilt for that tempo.

Parameters:

  • track_index: An audio track

  • clip_index: Session slot, or position in get_arrangement_clips

  • location: "session" (default) or "arrangement"

  • warping: Warp on or off

  • warp_mode: "beats" (drums), "tones" (monophonic), "texture", "re_pitch" (vinyl-like), "complex" / "complex_pro" (full mixes), or 0–6

  • original_bpm: The loop's own tempo

  • pitch_coarse: Transposition in semitones (−48…48)

  • pitch_fine: Detune in cents (−50…50)

  • gain: Clip gain 0.0–1.0 (the reply shows it in dB)

edit_warp_markersA

Edit the warp markers of a warped audio clip (Live 11+), in this order: remove, then move, then add. get_clip_warp shows the current ones.

Parameters:

  • track_index: An audio track

  • clip_index: Session slot, or position in get_arrangement_clips

  • location: "session" (default) or "arrangement"

  • add: [{"beat_time": 8.0, "sample_time": 3.66}] pins a moment of the file (seconds) to a beat

  • move: [{"beat_time": 8.0, "beat_time_distance": 0.25}] shifts that marker by some beats

  • remove: [8.0, 16.0] beat times of markers to delete

set_clip_automationA

Draw an automation envelope inside a Session clip; it plays whenever the clip plays. (Live's API does not allow writing envelopes in Arrangement clips or the Arrangement's automation lanes.) Target a device parameter (device_index + parameter_index, see get_device_parameters) or a mixer control (mixer_parameter).

Parameters:

  • track_index: The track holding the clip and the parameter

  • clip_index: The Session slot

  • points: [{"time": 0, "value": 0.2}, {"time": 16, "value": 0.9}] — time in beats from the clip start, value in the parameter's own range (clamped); the last value holds to the clip end. [] with clear_first removes the envelope.

  • location: "session" (the only place Live accepts)

  • device_index: Device in the chain (ignored with mixer_parameter)

  • parameter_index: Parameter of that device

  • mixer_parameter: "volume", "panning" or "send:N" (N = return index)

  • interpolation: "linear" (ramps drawn in steps of resolution) or "step"

  • resolution: Ramp step in beats (0.25 = a sixteenth)

  • clear_first: Erase this parameter's envelope in the clip first

get_clip_automationB

Read a clip's envelope for one parameter, sampled every resolution beats; has_envelope=false when that parameter isn't automated in the clip.

Parameters:

  • track_index, clip_index, location: as for set_clip_automation

  • device_index, parameter_index, mixer_parameter: as for set_clip_automation

  • resolution: Sampling step in beats (default 1)

get_device_parametersA

Every parameter of a device with its index, value, range and the value as Live displays it (dB, Hz, %, mode names).

Parameters:

  • track_index: The track (return index for "return", ignored for "master")

  • device_index: Position of the device in the chain

  • track_type: "track" (default), "return" or "master"

set_device_parameterA

Change one device parameter. Look up indexes and ranges with get_device_parameters; the reply shows the old and new values as Live displays them.

Parameters:

  • track_index: The track (return index for "return", ignored for "master")

  • device_index: Position of the device in the chain

  • parameter_index: The parameter's index

  • value: New value, in the parameter's own range

  • track_type: "track" (default), "return" or "master"

device_inventoryA

Everything loaded in the set — every device on every track, return track and the main track, racks with their chains — with what each one is and what it is for (native devices from the Live 12 manual, Max for Live devices, known plug-in families such as Arturia emulations), plus, with installed_plugins=true, the VST/VST3/AU plug-ins installed, by vendor.

Parameters:

  • installed_plugins: Also list the installed plug-ins

device_knowledgeB

What a device does: a native Live device (from the Live 12 manual: kind, category, purpose, key parameters, electronic/techno uses, sidechain, tip), a bundled Max for Live device, or a known plug-in (e.g. "Acid V", "Comp FET-76", "Cthulhu"). Without name, the catalogue of native devices, optionally filtered by kind (instrument, audio_effect, midi_effect, max_for_live). Also says what Live 12's MIDI Tools are and that the API can't drive them.

Parameters:

  • name: Device or plug-in name

  • kind: Filter for the catalogue

get_device_infoB

One device's identity (Live's real device name even when a preset renamed it, kind, latency) and its specific API: sidechain routing and options (Compressor), plug-in presets, Simpler sample/slicing state, rack chains and variations.

Parameters:

  • track_index / device_index: The device

  • track_type: "track", "return" or "master"

set_device_sidechainA

Feed a Compressor's sidechain from another track (e.g. duck the bass or pads with the kick) and switch its sidechain on. source is the name of the track as Live lists it (see get_device_info: sidechain.available_types), channel e.g. "Post FX" / "Pre FX". Live's API exposes sidechain routing on the Compressor; other devices with a sidechain (Gate, Glue, Auto Filter...) are routed in the interface.

Parameters:

  • track_index / device_index: The Compressor

  • source: Sidechain source track name (exact, or a unique part of it)

  • channel: Source tap (optional)

  • enable: Turn the sidechain on (default) or off

  • track_type: "track", "return" or "master"

plugin_presetsA

A VST/AU plug-in's preset list (as the plug-in exposes it to Live), or select one by index or name (exact, else first containing the text).

Parameters:

  • track_index / device_index: The plug-in

  • preset_index / preset_name: Preset to load (omit both to list)

  • track_type: "track", "return" or "master"

simpler_sampleB

Load a sample into a Simpler and set it up: playback mode (classic, one_shot, slicing), slicing by transient / beat / region / manual with sensitivity, beat division or region count (e.g. chop a break into 16 slices playable from a Drum Rack-like MIDI layout), voices, warp the sample as N beats, crop, reverse.

Parameters:

  • track_index / device_index: The Simpler

  • file_path: Absolute path of an audio file to load (optional)

  • playback_mode: classic | one_shot | slicing

  • slicing_style: transient | beat | region | manual

  • slicing_sensitivity: 0-1 (transient mode)

  • slicing_beat_division: Live's beat division index (beat mode)

  • slicing_region_count: Number of slices (region mode)

  • voices: Polyphony

  • warp_as_beats: Warp the sample to this many beats

  • crop / reverse: Destructive edits of the sample in Simpler

rack_variationA

A rack's macro variations (Live 11+): list them with the current macro values, recall one, store the current macros as a new variation, or randomize the macros (great for happy accidents, then store the result).

Parameters:

  • track_index / device_index: The rack

  • action: list | recall | store | randomize

  • index: Variation to recall

  • track_type: "track", "return" or "master"

set_drum_chokeA

Put Drum Rack pads in a choke group so they cut each other — the classic: closed and open hi-hat together (e.g. notes [42, 46], group 1). Group 0 removes the choke.

Parameters:

  • track_index: Track with the Drum Rack

  • notes: Pad MIDI notes (see get_drum_map)

  • group: Choke group 1-16, or 0 for none

get_browser_treeA

The folders of Live's browser, as an indented outline with the path of each folder (use the paths with get_browser_items_at_path).

Parameters:

  • category_type: "all", or one root: instruments, sounds, drums, audio_effects, midi_effects, plugins, user_library, packs, samples, max_for_live, current_project

get_browser_items_at_pathA

What a browser folder contains, with each item's URI and whether it can be loaded (load it with load_instrument_or_effect).

Parameters:

  • path: "root/folder/subfolder", e.g. "drums/Drum Rack" or "plugins/Arturia". Roots: instruments, sounds, drums, audio_effects, midi_effects, plugins, user_library, packs, samples, max_for_live, current_project

load_instrument_or_effectA

Load a browser item — instrument, effect, preset, plug-in, User Library file — onto a track, by its URI. Effects can also go on a return track (track_type="return", track_index 0 = A) or on the main track (track_type="master"). Find URIs with get_browser_items_at_path.

Parameters:

  • track_index: The track (return index for "return", ignored for "master")

  • uri: The item's URI, e.g. "query:Synths#Operator"

  • track_type: "track" (default), "return" or "master"

load_drum_kitC

Load a Drum Rack, then the first loadable kit found in a browser folder.

Parameters:

  • track_index: A MIDI track

  • rack_uri: URI of the Drum Rack to load first

  • kit_path: Browser folder holding the kits, e.g. "drums/Drum Hits"

get_track_routingA

Read a track's input/output routing and monitoring, with the options Live offers for each (names as shown in Live's I/O section, in Live's language).

Parameters:

  • track_index: Index of the track (return index for "return", ignored for "master")

  • track_type: "track" (default), "return" or "master" (these two only have an output)

set_track_routingA

Set a track's input/output routing and monitoring. Arguments left out are untouched. Names are matched against the options get_track_routing lists: exact (case-insensitive) first, else a unique substring.

Examples:

  • Layer one MIDI part on several instruments: on each extra MIDI track, input_type="", monitoring="in".

  • Record the main output (resampling): on an audio track, input_type="Resampling" (French Live: "Rééchantillonnage").

  • Send a track to a return or another track: output_type="".

Parameters:

  • track_index: Index of the track (return index for "return")

  • input_type / input_channel: Input routing ("MIDI From" / "Audio From")

  • output_type / output_channel: Output routing ("MIDI To" / "Audio To")

  • monitoring: "in", "auto" or "off"

  • track_type: "track" (default), "return" or "master" (output only)

record_arrangementA

Record the armed tracks into the Arrangement between two song positions (in beats): moves the playhead, turns Arrangement Record on, plays, and stops at end_time. Arm tracks first (set_track_arm).

Parameters:

  • start_time: Song position to start at (beats)

  • end_time: Song position to stop at (beats)

  • wait: Block until the recording ends (default) or return at once (then poll get_recording_status)

  • max_wait_seconds: Safety limit when waiting; recording is stopped past it

get_recording_statusB

State of the current or last record_arrangement run (finished, reason, stop position), plus Arrangement Record, transport and armed tracks.

stop_arrangement_recordingA

Stop a running record_arrangement now (turns Arrangement Record off and stops playback).

get_audio_clip_fileB

Path of the audio file behind an audio clip (for example a take just recorded with record_arrangement), with its length and sample rate.

Parameters:

  • track_index: The track holding the clip

  • clip_index: Arrangement clip index (get_arrangement_clips) or Session slot

  • location: "arrangement" (default) or "session"

analyze_audio_fileA

Measure a WAV or AIFF file: peak and RMS levels (dBFS), clipping, crest factor, loudness over time (one value per segment), leading/trailing silence, stereo correlation and a coarse spectral balance (low < 250 Hz, mid, high > 4 kHz), with warnings. Use it to check a mix or a recorded take.

Parameters:

  • file_path: Absolute path of the audio file

  • segment_seconds: Length of each loudness segment (default 1 s)

get_track_metersA

Live's output meters right now for every track, return track and the main track (0.0-1.0 on Live's meter scale, as in the mixer). Meaningful while the song plays; listen_to_arrangement samples them for you.

analyze_mixA

Mastering-engineer report on a WAV/AIFF mix: loudness per ITU-R BS.1770 / EBU R128 (integrated, short-term and momentary max, loudness range), true peak (4x oversampled), PLR, crest factor, long-term 1/3-octave spectrum with tilt and per-region deviation from a balanced -4.5 dB/oct reference (mud, harshness, sibilance, air, sub), narrow resonances (with note names), stereo correlation and width overall and per band (low-end mono), DC. Returns findings ranked problème / attention / ok with concrete fixes against the delivery target, plus a spectrogram image (log frequency, with the short-term loudness curve) to look at.

Parameters:

  • file_path: Absolute path of the audio file

  • target: "streaming" (default, -14 LUFS), "club", "classical", "broadcast" (EBU -23 LUFS) or "podcast"

  • spectrogram: Also return the spectrogram image (default True)

listen_to_arrangementA

"Listen" to the song like a mastering engineer: record the main output between two song positions (beats) onto a temporary resampling audio track, sample every track's meter during the take, then analyze it.

report="mix" (default) returns the full analyze_mix report (LUFS, true peak, PLR, tonal balance, resonances, stereo, findings with fixes against target) plus a spectrogram image, and each track's meter level during the take (which tracks carry the mix). report="basic" returns only levels, loudness per segment and a coarse spectral balance. Plays the song in real time, so it takes as long as the passage.

Parameters:

  • start_time: Song position to start at (beats)

  • end_time: Song position to stop at (beats); add a few beats to hear reverb tails

  • target: Delivery target for the mix report: "streaming", "club", "classical", "broadcast" or "podcast"

  • report: "mix" (default) or "basic"

  • keep_track: Keep the recording track and its take in the set (default: delete both once analysed)

  • keep_audio: Keep the recorded file in the project's Samples/Recorded folder after deleting the track (default: delete it, so listening never piles up audio files in the project)

  • segment_seconds: Length of each loudness segment (basic report)

  • max_wait_seconds: Safety limit for the recording

import_midi_fileA

Import the notes of a Standard MIDI File (.mid) into a clip. Without track_index, only describes the file (tracks, note counts, channels, length) so you can pick midi_track / channel first.

Session: an empty slot gets a new clip as long as the notes (rounded up to a 4-beat bar) or clip_length; an existing clip receives the notes (after clearing it when replace=True). Arrangement: the clip must exist (index from get_arrangement_clips). Times are in beats; the file's tempo is ignored.

Parameters:

  • file_path: Absolute path of the .mid file

  • track_index: Target MIDI track (omit to only describe the file)

  • clip_index: Session slot, or Arrangement clip index

  • midi_track: Track of the MIDI file to import (default: all, merged)

  • channel: MIDI channel to keep, 0-15 (default: all)

  • transpose: Semitones to add to every pitch

  • location: "session" (default) or "arrangement"

  • replace: Clear the target clip's notes first

  • clip_length: Length in beats of a newly created Session clip

music_scalesA

Scales and modes knowledge. Without arguments, lists all ~50 scales (church modes, harmonic/melodic minor families, pentatonics, blues, bebop, symmetric, Japanese, gamelan, flamenco...) with their character and typical styles; query filters (e.g. "flamenco", "jazz", "sombre"). With root and scale, details one scale: notes spelled in the key, degrees, characteristic note, character, styles, diatonic seventh chords with roman numerals and functions, the other modes with the same notes, and Live 12's scale name (for set_song_scale).

Parameters:

  • query: Text to filter the list

  • root: Tonic (e.g. "D", "Eb") to detail one scale

  • scale: Scale name (e.g. "dorian", "phrygian dominant", "hijaz", "harmonic minor")

music_stylesA

Style sheets for composing or re-arranging: without style, the list; with it, what makes the style: tempo, metre, scales/modes, harmonic language, typical progressions (roman numerals for write_progression), rhythm/groove and swing amount, bass, melody, arrangement, accompaniment patterns, and which Live devices/tools help. Styles: baroque, classical_romantic, jazz, bossa_nova, blues, gospel_neo_soul, funk, pop, rock, house, techno, trance, drum_and_bass, hip_hop_boom_bap, lofi, trap, rnb, reggae, reggaeton, afrobeat, flamenco, film_epic, ambient, synthwave (aliases such as "Bach", "lo-fi", "dnb" work).

Parameters:

  • style: Style name (optional)

music_chord_ideasA

Reharmonisation ideas for a chord (tritone substitution, ii-V preparation, relative chords, extensions, borrowed chords in the key), with the reason for each, plus the chord's notes.

Parameters:

  • chord: Chord symbol, e.g. "G7", "Fmaj7", "Am", "Bø", "Ebmaj7/G"

  • key_root: Key tonic, to suggest borrowed chords (optional)

analyze_clip_musicA

Musical analysis of a MIDI clip: key and mode candidates (with coverage and outside notes; relative modes are told apart by the harmony, e.g. a V7 pointing to its tonic), chords per segment with roman numerals, out-of-scale notes, range, rhythm (density, offbeat share, polyphony) and melodic motion of the top line. Also reports Live's song scale.

Parameters:

  • track_index / clip_index: The clip (Session slot or Arrangement index)

  • location: "session" (default) or "arrangement"

  • segment_beats: Chord detection window (2 = two chords per bar by default, 4 = one per bar, 1 per beat); identical neighbours are merged

  • key_root / key_scale: Force the key used for roman numerals (optional)

  • vocabulary: "basic" (triads and sevenths: classical, pop, counterpoint) or "jazz" (adds 6, 9, sus and extended chords)

transform_clipA

Re-arrange a MIDI clip with a chain of music-theory operations, applied in order. Writes the result back into the clip, or into an empty Session slot target_clip_index (keeps the original: safer for trying ideas).

Each operation is {"op": name, ...arguments}:

  • transpose: semitones

  • transpose_diatonic: steps, root, scale (moves along the scale)

  • change_mode: root, from_scale, to_scale[, to_root] (C major -> C dorian...)

  • snap_to_scale: root, scale[, direction nearest|up|down]

  • invert: axis ("C4" or 60)[, root, scale for a diatonic mirror]

  • retrograde: [length]

  • time_scale: factor (2 = half speed, 0.5 = double)

  • quantize: [grid=0.25, strength=1.0, durations=false]

  • swing: [amount_pct=60 (50 straight, 66.7 triplet), grid=0.5]

  • humanize: [timing=0.01 beats, velocity=8, seed=0]

  • accent: [pattern=[1,0.7,0.85,0.7], grid=1.0, base=110]

  • articulate: factor (0.5 = staccato) or legato=true

  • fold_range: low, high (e.g. "C3", "C5")

  • harmonize: root, scale[, steps=[2] (2 = third above, -2 below, 4 fifth, 5 sixth), keep_original=true]

  • arpeggiate: [rate=0.25, pattern up|down|updown|random, octaves=1, gate=0.9]

  • strum: [spread=0.03, direction down|up]

  • voice_chords: voicing close|drop2|open|spread Notes are written as C4 = MIDI 60 (Live displays it as C3).

Parameters:

  • track_index / clip_index: Source clip

  • operations: List of operations (see above)

  • location: "session" (default) or "arrangement"

  • target_clip_index: Empty Session slot on the same track for the result (optional)

write_progressionA

Write a chord progression into an empty Session slot (clip created to fit) or an existing clip, voiced with smooth voice leading and played with an accompaniment pattern.

Give numerals (roman numerals in the key: "ii7", "V7", "Imaj7", "bVII", "iv", "V/V", "N6", "viiø7"...) or a style (its typical progression number progression_index, its scale and pattern are used unless given). Patterns: block, pulse, pulse8, offbeat, arp8, arp16, alberti, bossa, waltz, ballad, stabs.

Parameters:

  • track_index / clip_index: Target MIDI track and Session slot

  • root: Key tonic ("C", "F#", "Bb")

  • scale: Scale/mode of the key (default major)

  • numerals: Roman numerals (optional if style)

  • style: Style name (see music_styles)

  • progression_index: Which of the style's progressions

  • beats_per_chord: Harmonic rhythm (4 = one chord per bar)

  • pattern: Accompaniment pattern (default: the style's first, else block)

  • low / high: Range of the chord voicings

  • bass: Add a bass line (root, an octave or two below)

  • repeat: Times to repeat the progression

  • voices: Notes per chord voicing (3-5)

get_song_scaleA

Live 12's song scale: root, scale name, intervals and the Scale Mode switch (which highlights the scale in the piano roll and drives devices set to "Use Current Scale", e.g. the Scale, Arpeggiator and Chord devices).

set_song_scaleA

Set Live 12's song scale so the piano roll shows it and scale-aware devices follow it. scale accepts this server's names (dorian, hijaz, harmonic minor...) and maps them to Live's name when Live has the scale.

Parameters:

  • root: Tonic ("C", "Eb", "F#")

  • scale: Scale name

  • scale_mode: Turn Live's Scale Mode on/off

drum_patternsA

Drum pattern library for electronic music. Without arguments, lists the styles (techno_four, techno_rolling, techno_hypnotic, minimal_techno, dub_techno, hard_techno, acid_techno, detroit_techno, house_classic, deep_house, tech_house, afro_house, uk_garage, breakbeat, electro, drum_and_bass, dubstep, trap, ebm). With style, its grids per role, tempo, swing, production notes and the available fills. With euclid_hits, returns a Euclidean rhythm grid, e.g. 3/8 = tresillo.

Grid language (one string per role, 16 steps = one bar of 16ths): x hit · X accent · o ghost · . rest · 2 3 4 ratchet · ? 50 % chance · * 25 % chance ghost.

Parameters:

  • style: Pattern style (optional)

  • euclid_hits / euclid_steps / euclid_rotate: Euclidean rhythm (optional)

get_drum_mapA

The Drum Rack on a track: every filled pad (MIDI note, name, devices) and the role each one plays (kick, clap, closed_hat, open_hat, rim, ride, perc...), read from the pad names, as used by write_drum_pattern.

Parameters:

  • track_index: Track holding the Drum Rack

write_drum_patternA

Program drums into a Session slot (clip created to fit) on a track with a Drum Rack. Roles are mapped to the kit's pads by their names (a similar free pad stands in for a missing role; missing ones are reported); without a Drum Rack, General MIDI notes are used.

Start from a library style and/or give layers: {role: grid} or {role: {"euclid": [hits, steps, rotate]}}; layers override or extend the style. Roles: kick, clap, snare, rim, closed_hat, open_hat, pedal_hat, ride, crash, tom_low, tom_mid, tom_high, perc, shaker, tambourine, conga, bongo, clave, cowbell, fx. A grid shorter or longer than a bar cycles over the whole clip (a 12-step loop drifts against 16-step bars). Grid: x hit · X accent · o ghost · . rest · 2/3/4 ratchet · ? 50 % · * 25 % ghost (probabilities use Live 12's per-note chance, so the loop varies as it plays).

Parameters:

  • track_index / clip_index: Drum track and Session slot

  • style: Library pattern (see drum_patterns)

  • layers: Extra or replacement grids per role

  • bars: Clip length in bars (4/4)

  • steps_per_bar: Grid resolution (16 = 16ths, 12 = 8th-note triplets, 32)

  • swing_pct: Swing on odd steps, 50 = straight (default: the style's)

  • fill: Every fill_every bars: roll, drop, open_hat, ratchet or crash

  • variation: 0-1, chance of extra ghost hats (written with low probability)

  • humanize: Timing spread in beats (e.g. 0.005), with small velocity changes

  • replace: Clear an existing clip in the slot first

  • seed: Random seed for variation/humanize

get_groove_poolA

Live's Groove Pool: the grooves loaded in the set (name, base, timing, random, velocity and quantization amounts) and the global Groove amount. Grooves live in the browser under Packs (e.g. get_browser_items_at_path("packs/Core Library/Grooves")) and in the User Library; apply one with set_clip_groove. A groove only acts when the global amount is above 0 (set_groove_params global_amount).

set_clip_grooveA

Apply a Groove Pool groove to a clip (Live's own swing/groove engine, non-destructive), or remove it with groove_index omitted.

Parameters:

  • track_index / clip_index: The clip

  • groove_index: Index from get_groove_pool (omit to remove the groove)

  • location: "session" (default) or "arrangement"

set_groove_paramsA

Adjust a groove in the Groove Pool (amounts in %, as in Live) and/or the global Groove amount (0-1.3, i.e. 0-130 %).

Parameters:

  • groove_index: Groove to change (from get_groove_pool)

  • timing_amount / random_amount / velocity_amount / quantization_amount: New amounts

  • global_amount: Global Groove amount

arrangement_templatesA

Arrangement templates for electronic music and the automation curve shapes. Without template: the list (techno_dj, techno_64, minimal, house) and the shapes. With it: its sections (name, bars, energy 0-1, roles that play, production tip).

Parameters:

  • template: Template name (optional)

write_clip_evolutionA

Make a Session clip evolve over many bars: optionally extend it to bars (a MIDI loop is tiled, e.g. 4 -> 64 bars), then write one automation envelope per lane with a musical curve. Copied to the Arrangement (e.g. by build_arrangement), the envelopes become the track's automation there.

Each lane: {"mixer_parameter": "volume" | "panning" | "send:N"} or {"device_index": d, "parameter_index": p}, plus "start", "end" (in the parameter's units, see get_device_parameters: min/max/display), "shape" (linear, exp, log, s_curve, swell, sine, triangle, steps, random_walk, hold), optional "cycles" (sine/triangle), "steps" (steps), "power" (exp/log curvature, default 2.5), "from_bar"/"to_bar" to limit the curve to part of the clip (the value holds outside), "seed".

Example, a 64-bar techno build: filter cutoff exp from 0.3 to 0.9, reverb send swell, hats volume in 8 steps.

Parameters:

  • track_index / clip_index: Session clip

  • lanes: Curves to write (see above)

  • bars: Extend the clip to this many bars first (MIDI clips; 4/4)

  • resolution: Envelope step in beats (1 = a point per beat)

build_arrangementA

Build the Arrangement from Session clips, section by section, like a producer laying out a track: each section plays the clips of the tracks whose role is active there, tiled to fill it, with a named locator at its start. Clip envelopes (see write_clip_evolution) come along as track automation, so a filter build or a reverb swell plays in the Arrangement.

Use a template (techno_dj, techno_64, minimal, house; see arrangement_templates) or your own sections: [{"name", "bars", "roles": [...]} or {"name", "bars", "play": {"track_index": slot}}]. Track roles come from track names (kick, drums, hats, perc, rumble, bass, chords, pad, lead, vocal, fx) unless track_roles {"track_index": role} overrides them. section_slots {"Section name": {"track_index": slot}} picks another clip for a section (e.g. the automated build variant). Run with dry_run=true first to see the plan.

Parameters:

  • template / sections: Structure to build

  • track_roles: Role per track index, overriding names

  • start_bar: Arrangement bar to start at (0 = beginning)

  • default_slot: Session slot used by default for every track

  • section_slots: Per-section slot overrides

  • locators: Add a locator at each section (transport must be stopped)

  • dry_run: Only return the plan

arrangement_overviewB

A map of the Arrangement: for every track, one character per block of block_bars bars ('#' = a clip plays, '.' = silent), so the structure, the entries and exits of each element and the phrasing are visible at a glance.

Parameters:

  • block_bars: Bars per character (default 8)

Prompts

Interactive templates invoked by user choice

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.3/5.0

Scored across 96 tools

Disambiguation4/5

Most tools map to a distinct DAW object or action, and detailed descriptions disambiguate close pairs such as set_clip_automation vs write_clip_evolution and analyze_audio_file vs analyze_mix. There are still several near-overlapping analysis, knowledge, and device-inspection tools, but clear boundaries generally exist.

Naming Consistency4/5

Most action tools use a consistent snake_case verb_noun pattern (get_, set_, create_, delete_, write_, build_), while informational catalog tools use noun phrases (device_inventory, music_styles). The deviations are minor and readable.

Tool Count1/5

96 tools is far beyond a practical tool set and well past the 25+ 'too many' threshold, even for a deep DAW controller. Many related operations could be consolidated, and the volume increases selection risk.

Completeness4/5

The surface covers session control, tracks, clips, MIDI editing, devices, browser access, routing, recording, mix analysis, and music generation/arrangement in depth. Remaining gaps are relatively minor, such as return-track lifecycle and device-chain reordering/deletion.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues