livepilot 1.2.0 → 1.2.1

package/CHANGELOG.md

@@ -1,21 +1,34 @@
 # Changelog
 
+## 1.2.1 — 2026-03-17
+
+### Fixes
+- Remove 3 tools that don't work in Live 12's ControlSurface API: `create_group_track`, `freeze_track`, `flatten_track`
+- Fix `set_scene_name` — now allows empty string to clear scene name
+- Fix `set_scene_tempo` — removed invalid "0 to clear" (Live 12 range is 20-999 BPM)
+- All 96 tools live-tested against Ableton Live 12
+
 ## 1.2.0 — 2026-03-17
 
-### New Tools (+8, total 99)
-- **`create_group_track`** — group a range of tracks into a foldable group track
+### New Tools (+5, total 96)
 - **`set_group_fold`** — fold/unfold a group track to show/hide children
-- **`freeze_track`** — freeze a track to reduce CPU load
-- **`flatten_track`** — flatten a frozen track to audio permanently
 - **`set_track_input_monitoring`** — set input monitoring state (In/Auto/Off)
 - **`set_clip_warp_mode`** — set warp mode for audio clips (Beats/Tones/Texture/Re-Pitch/Complex/Complex Pro)
 - **`set_scene_color`** — set scene color (0-69)
-- **`set_scene_tempo`** — set per-scene tempo that triggers on launch
+- **`set_scene_tempo`** — set per-scene tempo that triggers on launch (20-999 BPM)
+
+### Removed Tools (-3)
+- **`create_group_track`** — removed due to Live 12 API limitations
+- **`freeze_track`** — removed due to Live 12 API limitations
+- **`flatten_track`** — removed due to Live 12 API limitations
 
 ### Enhancements
 - `get_clip_info` now returns `is_midi_clip`, `is_audio_clip`, and audio warp fields (`warping`, `warp_mode`)
 - `get_track_info` now returns `is_foldable`, `is_grouped`, `fold_state`, and `current_monitoring_state`
 
+### Fixes
+- `set_scene_name` now allows empty string to clear scene name
+
 ## 1.1.2 — 2026-03-17
 
 ### Fixes

package/README.md

@@ -11,7 +11,7 @@
 [![CI](https://github.com/dreamrec/LivePilot/actions/workflows/ci.yml/badge.svg)](https://github.com/dreamrec/LivePilot/actions/workflows/ci.yml)
 [![GitHub stars](https://img.shields.io/github/stars/dreamrec/LivePilot)](https://github.com/dreamrec/LivePilot/stargazers)
 
-**AI copilot for Ableton Live 12** — 99 MCP tools for music production, sound design, and mixing.
+**AI copilot for Ableton Live 12** — 96 MCP tools for music production, sound design, and mixing.
 
 Control your entire Ableton session through natural language. Create tracks, program MIDI, load instruments, tweak parameters, arrange songs, and mix — all without leaving the keyboard.
 
@@ -156,16 +156,16 @@ npx -y github:dreamrec/LivePilot --status
 
 ---
 
-## 91 Tools Across 9 Domains
+## 96 Tools Across 9 Domains
 
 | Domain | Tools | What you can do |
 |--------|:-----:|-----------------|
 | **Transport** | 12 | Play/stop, tempo, time signature, loop, undo/redo, metronome, diagnostics |
-| **Tracks** | 12 | Create MIDI/audio/return tracks, name, color, mute, solo, arm |
-| **Clips** | 10 | Create, delete, duplicate, fire, stop, loop settings, launch mode |
+| **Tracks** | 14 | Create MIDI/audio/return tracks, name, color, mute, solo, arm, group fold, input monitoring |
+| **Clips** | 11 | Create, delete, duplicate, fire, stop, loop settings, launch mode, warp mode |
 | **Notes** | 8 | Add/get/remove/modify MIDI notes, transpose, quantize, duplicate |
 | **Devices** | 12 | Load instruments & effects, tweak parameters, rack chains, presets |
-| **Scenes** | 6 | Create, delete, duplicate, fire, rename |
+| **Scenes** | 8 | Create, delete, duplicate, fire, rename, color, per-scene tempo |
 | **Mixing** | 8 | Volume, pan, sends, routing, return tracks, master |
 | **Browser** | 4 | Search Ableton's library, browse categories, load presets |
 | **Arrangement** | 19 | Create clips, full MIDI note CRUD, cue points, recording, automation |
@@ -176,11 +176,11 @@ npx -y github:dreamrec/LivePilot --status
 ### Transport (12)
 `get_session_info` · `set_tempo` · `set_time_signature` · `start_playback` · `stop_playback` · `continue_playback` · `toggle_metronome` · `set_session_loop` · `undo` · `redo` · `get_recent_actions` · `get_session_diagnostics`
 
-### Tracks (12)
-`get_track_info` · `create_midi_track` · `create_audio_track` · `create_return_track` · `delete_track` · `duplicate_track` · `set_track_name` · `set_track_color` · `set_track_mute` · `set_track_solo` · `set_track_arm` · `stop_track_clips`
+### Tracks (14)
+`get_track_info` · `create_midi_track` · `create_audio_track` · `create_return_track` · `delete_track` · `duplicate_track` · `set_track_name` · `set_track_color` · `set_track_mute` · `set_track_solo` · `set_track_arm` · `stop_track_clips` · `set_group_fold` · `set_track_input_monitoring`
 
-### Clips (10)
-`get_clip_info` · `create_clip` · `delete_clip` · `duplicate_clip` · `fire_clip` · `stop_clip` · `set_clip_name` · `set_clip_color` · `set_clip_loop` · `set_clip_launch`
+### Clips (11)
+`get_clip_info` · `create_clip` · `delete_clip` · `duplicate_clip` · `fire_clip` · `stop_clip` · `set_clip_name` · `set_clip_color` · `set_clip_loop` · `set_clip_launch` · `set_clip_warp_mode`
 
 ### Notes (8)
 `add_notes` · `get_notes` · `remove_notes` · `remove_notes_by_id` · `modify_notes` · `duplicate_notes` · `transpose_notes` · `quantize_clip`
@@ -188,8 +188,8 @@ npx -y github:dreamrec/LivePilot --status
 ### Devices (12)
 `get_device_info` · `get_device_parameters` · `set_device_parameter` · `batch_set_parameters` · `toggle_device` · `delete_device` · `load_device_by_uri` · `find_and_load_device` · `get_rack_chains` · `set_simpler_playback_mode` · `set_chain_volume` · `get_device_presets`
 
-### Scenes (6)
-`get_scenes_info` · `create_scene` · `delete_scene` · `duplicate_scene` · `fire_scene` · `set_scene_name`
+### Scenes (8)
+`get_scenes_info` · `create_scene` · `delete_scene` · `duplicate_scene` · `fire_scene` · `set_scene_name` · `set_scene_color` · `set_scene_tempo`
 
 ### Mixing (8)
 `set_track_volume` · `set_track_pan` · `set_track_send` · `get_return_tracks` · `get_master_track` · `set_master_volume` · `get_track_routing` · `set_track_routing`

package/mcp_server/tools/scenes.py

@@ -53,10 +53,8 @@ def fire_scene(ctx: Context, scene_index: int) -> dict:
 
 @mcp.tool()
 def set_scene_name(ctx: Context, scene_index: int, name: str) -> dict:
-    """Rename a scene."""
+    """Rename a scene. Pass empty string to clear the name."""
     _validate_scene_index(scene_index)
-    if not name.strip():
-        raise ValueError("Scene name cannot be empty")
     return _get_ableton(ctx).send_command("set_scene_name", {
         "scene_index": scene_index,
         "name": name,
@@ -81,10 +79,10 @@ def set_scene_color(ctx: Context, scene_index: int, color_index: int) -> dict:
 
 @mcp.tool()
 def set_scene_tempo(ctx: Context, scene_index: int, tempo: float) -> dict:
-    """Set scene tempo in BPM. Fires when the scene launches. Set to 0 to clear."""
+    """Set scene tempo in BPM (20-999). Fires when the scene launches."""
     _validate_scene_index(scene_index)
-    if tempo != 0 and (tempo < 20 or tempo > 999):
-        raise ValueError("Tempo must be 0 (clear) or between 20.0 and 999.0 BPM")
+    if tempo < 20 or tempo > 999:
+        raise ValueError("Tempo must be between 20.0 and 999.0 BPM")
     return _get_ableton(ctx).send_command("set_scene_tempo", {
         "scene_index": scene_index,
         "tempo": tempo,

package/mcp_server/tools/tracks.py

@@ -1,6 +1,6 @@
-"""Track MCP tools — create, delete, rename, mute, solo, arm, group, freeze, monitor.
+"""Track MCP tools — create, delete, rename, mute, solo, arm, group fold, monitor.
 
-17 tools matching the Remote Script tracks domain.
+14 tools matching the Remote Script tracks domain.
 """
 
 from fastmcp import Context
@@ -148,30 +148,6 @@ def stop_track_clips(ctx: Context, track_index: int) -> dict:
     return _get_ableton(ctx).send_command("stop_track_clips", {"track_index": track_index})
 
 
-@mcp.tool()
-def create_group_track(
-    ctx: Context,
-    start_index: int,
-    end_index: int,
-    name: str | None = None,
-    color: int | None = None,
-) -> dict:
-    """Create a group track containing tracks from start_index to end_index (inclusive)."""
-    _validate_track_index(start_index)
-    _validate_track_index(end_index)
-    if end_index < start_index:
-        raise ValueError("end_index must be >= start_index")
-    params = {"start_index": start_index, "end_index": end_index}
-    if name is not None:
-        if not name.strip():
-            raise ValueError("Track name cannot be empty")
-        params["name"] = name
-    if color is not None:
-        _validate_color_index(color)
-        params["color_index"] = color
-    return _get_ableton(ctx).send_command("create_group_track", params)
-
-
 @mcp.tool()
 def set_group_fold(ctx: Context, track_index: int, folded: bool) -> dict:
     """Fold or unfold a group track to show/hide its children."""
@@ -182,20 +158,6 @@ def set_group_fold(ctx: Context, track_index: int, folded: bool) -> dict:
     })
 
 
-@mcp.tool()
-def freeze_track(ctx: Context, track_index: int) -> dict:
-    """Freeze a track to reduce CPU load. Frozen tracks render to audio cache."""
-    _validate_track_index(track_index)
-    return _get_ableton(ctx).send_command("freeze_track", {"track_index": track_index})
-
-
-@mcp.tool()
-def flatten_track(ctx: Context, track_index: int) -> dict:
-    """Flatten a frozen track to audio permanently. Use undo to revert."""
-    _validate_track_index(track_index)
-    return _get_ableton(ctx).send_command("flatten_track", {"track_index": track_index})
-
-
 @mcp.tool()
 def set_track_input_monitoring(ctx: Context, track_index: int, state: int) -> dict:
     """Set input monitoring (0=In, 1=Auto, 2=Off). Only for regular tracks, not return tracks."""

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "livepilot",
-  "version": "1.2.0",
+  "version": "1.2.1",
   "mcpName": "io.github.dreamrec/livepilot",
-  "description": "AI copilot for Ableton Live 12 — 99 MCP tools for music production, sound design, and mixing",
+  "description": "AI copilot for Ableton Live 12 — 96 MCP tools for music production, sound design, and mixing",
   "author": "Pilot Studio",
   "license": "MIT",
   "type": "commonjs",

package/plugin/plugin.json

@@ -1,7 +1,7 @@
 {
   "name": "livepilot",
-  "version": "1.2.0",
-  "description": "AI copilot for Ableton Live 12 — 99 MCP tools for music production, sound design, and mixing",
+  "version": "1.2.1",
+  "description": "AI copilot for Ableton Live 12 — 96 MCP tools for music production, sound design, and mixing",
   "author": "Pilot Studio",
   "skills": [
     "skills/livepilot-core"

package/plugin/skills/livepilot-core/SKILL.md

@@ -1,11 +1,11 @@
 ---
 name: livepilot-core
-description: Core discipline for controlling Ableton Live 12 through LivePilot's 99 MCP tools. Use whenever working with Ableton Live through MCP tools.
+description: Core discipline for controlling Ableton Live 12 through LivePilot's 96 MCP tools. Use whenever working with Ableton Live through MCP tools.
 ---
 
 # LivePilot Core — Ableton Live 12 AI Copilot
 
-LivePilot gives you 99 MCP tools to control Ableton Live 12 in real-time: transport, tracks, clips, MIDI notes, devices, scenes, mixing, browser, and arrangement.
+LivePilot gives you 96 MCP tools to control Ableton Live 12 in real-time: transport, tracks, clips, MIDI notes, devices, scenes, mixing, browser, and arrangement.
 
 ## Golden Rules
 
@@ -16,7 +16,7 @@ LivePilot gives you 99 MCP tools to control Ableton Live 12 in real-time: transp
 5. **Track indices are 0-based** — track 0 is the first track, scene 0 is the first scene
 6. **Color indices 0-69** — Ableton's fixed palette. Don't guess — use the index
 7. **Volume is 0.0-1.0, pan is -1.0 to 1.0** — these are normalized, not dB
-8. **Tempo range 20-999 BPM** — validated before sending to Ableton
+8. **Tempo range 20-969 BPM** — validated before sending to Ableton
 9. **Always name your tracks and clips** — organization is part of the creative process
 
 ## Track Health Checks — MANDATORY
@@ -57,16 +57,16 @@ LivePilot gives you 99 MCP tools to control Ableton Live 12 in real-time: transp
 - MIDI track with no instrument loaded
 - Notes programmed but clip not fired
 
-## Tool Domains (91 total)
+## Tool Domains (96 total)
 
 ### Transport (12)
 `get_session_info` · `set_tempo` · `set_time_signature` · `start_playback` · `stop_playback` · `continue_playback` · `toggle_metronome` · `set_session_loop` · `undo` · `redo` · `get_recent_actions` · `get_session_diagnostics`
 
-### Tracks (12)
-`get_track_info` · `create_midi_track` · `create_audio_track` · `create_return_track` · `delete_track` · `duplicate_track` · `set_track_name` · `set_track_color` · `set_track_mute` · `set_track_solo` · `set_track_arm` · `stop_track_clips`
+### Tracks (14)
+`get_track_info` · `create_midi_track` · `create_audio_track` · `create_return_track` · `delete_track` · `duplicate_track` · `set_track_name` · `set_track_color` · `set_track_mute` · `set_track_solo` · `set_track_arm` · `stop_track_clips` · `set_group_fold` · `set_track_input_monitoring`
 
-### Clips (10)
-`get_clip_info` · `create_clip` · `delete_clip` · `duplicate_clip` · `fire_clip` · `stop_clip` · `set_clip_name` · `set_clip_color` · `set_clip_loop` · `set_clip_launch`
+### Clips (11)
+`get_clip_info` · `create_clip` · `delete_clip` · `duplicate_clip` · `fire_clip` · `stop_clip` · `set_clip_name` · `set_clip_color` · `set_clip_loop` · `set_clip_launch` · `set_clip_warp_mode`
 
 ### Notes (8)
 `add_notes` · `get_notes` · `remove_notes` · `remove_notes_by_id` · `modify_notes` · `duplicate_notes` · `transpose_notes` · `quantize_clip`
@@ -74,8 +74,8 @@ LivePilot gives you 99 MCP tools to control Ableton Live 12 in real-time: transp
 ### Devices (12)
 `get_device_info` · `get_device_parameters` · `set_device_parameter` · `batch_set_parameters` · `toggle_device` · `delete_device` · `load_device_by_uri` · `find_and_load_device` · `set_simpler_playback_mode` · `get_rack_chains` · `set_chain_volume` · `get_device_presets`
 
-### Scenes (6)
-`get_scenes_info` · `create_scene` · `delete_scene` · `duplicate_scene` · `fire_scene` · `set_scene_name`
+### Scenes (8)
+`get_scenes_info` · `create_scene` · `delete_scene` · `duplicate_scene` · `fire_scene` · `set_scene_name` · `set_scene_color` · `set_scene_tempo`
 
 ### Mixing (8)
 `set_track_volume` · `set_track_pan` · `set_track_send` · `get_return_tracks` · `get_master_track` · `set_master_volume` · `get_track_routing` · `set_track_routing`
@@ -152,7 +152,7 @@ Deep production knowledge lives in `references/`. Consult these when making crea
 
 | File | What's inside | When to consult |
 |------|--------------|-----------------|
-| `references/overview.md` | All 91 tools mapped with params, units, ranges | Quick lookup for any tool |
+| `references/overview.md` | All 96 tools mapped with params, units, ranges | Quick lookup for any tool |
 | `references/midi-recipes.md` | Drum patterns by genre, chord voicings, scales, hi-hat techniques, humanization, polymetrics | Programming MIDI notes, building beats |
 | `references/sound-design.md` | Stock instruments/effects, parameter recipes for bass/pad/lead/pluck, device chain patterns | Loading and configuring devices |
 | `references/mixing-patterns.md` | Gain staging, parallel compression, sidechain, EQ by instrument, bus processing, stereo width | Setting volumes, panning, adding effects |

package/plugin/skills/livepilot-core/references/overview.md

@@ -1,6 +1,6 @@
 # LivePilot Architecture & Tool Reference
 
-LivePilot is an MCP server that controls Ableton Live 12 in real-time through 99 tools across 9 domains. This document maps every tool to what it actually does in Ableton, so you know exactly which tool to reach for.
+LivePilot is an MCP server that controls Ableton Live 12 in real-time through 96 tools across 9 domains. This document maps every tool to what it actually does in Ableton, so you know exactly which tool to reach for.
 
 ## Architecture
 
@@ -14,7 +14,7 @@ Claude Code  ──MCP──►  FastMCP Server  ──TCP/9878──►  Remote
 - **Protocol**: JSON over TCP, newline-delimited. Every command gets a response.
 - **Thread safety**: All Live Object Model (LOM) access happens on Ableton's main thread
 
-## The 91 Tools — What Each One Does
+## The 96 Tools — What Each One Does
 
 ### Transport (12) — Playback, tempo, global state, diagnostics
 
@@ -33,7 +33,7 @@ Claude Code  ──MCP──►  FastMCP Server  ──TCP/9878──►  Remote
 | `get_recent_actions` | Returns log of recent commands sent to Ableton (newest first) | `limit` (1-50, default 20) |
 | `get_session_diagnostics` | Analyzes session for issues: armed tracks, solo leftovers, unnamed tracks, empty clips | — |
 
-### Tracks (17) — Create, delete, configure, group, freeze tracks
+### Tracks (14) — Create, delete, configure, group tracks
 
 | Tool | What it does | Key params |
 |------|-------------|------------|
@@ -41,7 +41,6 @@ Claude Code  ──MCP──►  FastMCP Server  ──TCP/9878──►  Remote
 | `create_midi_track` | Creates a new MIDI track | `index` (-1=end), `name`, `color` (0-69) |
 | `create_audio_track` | Creates a new audio track | `index` (-1=end), `name`, `color` (0-69) |
 | `create_return_track` | Creates a new return track | — |
-| `create_group_track` | Groups a range of tracks into a group track | `start_index`, `end_index`, `name`, `color` |
 | `delete_track` | Deletes a track | `track_index` |
 | `duplicate_track` | Duplicates track with all contents | `track_index` |
 | `set_track_name` | Renames a track | `track_index`, `name` |
@@ -51,8 +50,6 @@ Claude Code  ──MCP──►  FastMCP Server  ──TCP/9878──►  Remote
 | `set_track_arm` | Arms/disarms for recording | `track_index`, `armed` (bool) |
 | `stop_track_clips` | Stops all playing clips on track | `track_index` |
 | `set_group_fold` | Folds/unfolds a group track | `track_index`, `folded` (bool) |
-| `freeze_track` | Freezes a track to reduce CPU | `track_index` |
-| `flatten_track` | Flattens a frozen track to audio (use undo to revert) | `track_index` |
 | `set_track_input_monitoring` | Sets input monitoring state | `track_index`, `state` (0=In, 1=Auto, 2=Off) |
 
 ### Clips (11) — Clip lifecycle, properties, warp
@@ -123,7 +120,7 @@ Claude Code  ──MCP──►  FastMCP Server  ──TCP/9878──►  Remote
 | `fire_scene` | Launches all clips in a scene | `scene_index` |
 | `set_scene_name` | Renames a scene | `scene_index`, `name` |
 | `set_scene_color` | Sets scene color | `scene_index`, `color_index` (0-69) |
-| `set_scene_tempo` | Sets tempo that triggers when scene fires (0 to clear) | `scene_index`, `tempo` (20-999 or 0) |
+| `set_scene_tempo` | Sets tempo that triggers when scene fires | `scene_index`, `tempo` (20-999 BPM) |
 
 ### Mixing (8) — Levels, panning, routing
 

package/remote_script/LivePilot/scenes.py

@@ -86,14 +86,14 @@ def set_scene_color(song, params):
 
 @register("set_scene_tempo")
 def set_scene_tempo(song, params):
-    """Set a scene's tempo (BPM). Set to 0 to clear the scene tempo."""
+    """Set a scene's tempo (BPM, 20-999)."""
     scene_index = int(params["scene_index"])
     scene = get_scene(song, scene_index)
     tempo = float(params["tempo"])
-    if tempo != 0 and (tempo < 20 or tempo > 999):
-        raise ValueError("Tempo must be 0 (clear) or between 20 and 999 BPM")
+    if tempo < 20 or tempo > 999:
+        raise ValueError("Tempo must be between 20 and 999 BPM")
     scene.tempo = tempo
     return {
         "index": scene_index,
-        "tempo": scene.tempo if scene.tempo > 0 else None,
+        "tempo": scene.tempo,
     }

package/remote_script/LivePilot/tracks.py

@@ -1,5 +1,5 @@
 """
-LivePilot - Track domain handlers (17 commands).
+LivePilot - Track domain handlers (14 commands).
 """
 
 from .router import register
@@ -235,39 +235,6 @@ def stop_track_clips(song, params):
     return {"index": track_index, "stopped": True}
 
 
-@register("create_group_track")
-def create_group_track(song, params):
-    """Create a group track containing the specified track range."""
-    start = int(params["start_index"])
-    end = int(params["end_index"])
-    tracks = list(song.tracks)
-    if start < 0 or start >= len(tracks):
-        raise IndexError(
-            "start_index %d out of range (0..%d)" % (start, len(tracks) - 1)
-        )
-    if end < start or end >= len(tracks):
-        raise IndexError(
-            "end_index %d out of range (%d..%d)" % (end, start, len(tracks) - 1)
-        )
-    # Select the range of tracks, then use the API
-    song.view.selected_track = tracks[start]
-    for i in range(start, end + 1):
-        tracks[i].is_part_of_selection = True
-    song.create_group_track()
-    # The new group track is inserted at start_index
-    new_tracks = list(song.tracks)
-    group_track = new_tracks[start]
-    if "name" in params:
-        group_track.name = str(params["name"])
-    if "color_index" in params:
-        group_track.color_index = int(params["color_index"])
-    return {
-        "index": start,
-        "name": group_track.name,
-        "is_foldable": group_track.is_foldable,
-    }
-
-
 @register("set_group_fold")
 def set_group_fold(song, params):
     """Fold or unfold a group track."""
@@ -282,28 +249,6 @@ def set_group_fold(song, params):
     }
 
 
-@register("freeze_track")
-def freeze_track(song, params):
-    """Freeze a track to reduce CPU load."""
-    track_index = int(params["track_index"])
-    track = get_track(song, track_index)
-    if track_index < 0:
-        raise ValueError("Cannot freeze a return track")
-    track.freeze()
-    return {"index": track_index, "frozen": True}
-
-
-@register("flatten_track")
-def flatten_track(song, params):
-    """Flatten a frozen track to audio (irreversible — use undo to revert)."""
-    track_index = int(params["track_index"])
-    track = get_track(song, track_index)
-    if track_index < 0:
-        raise ValueError("Cannot flatten a return track")
-    track.flatten()
-    return {"index": track_index, "flattened": True}
-
-
 @register("set_track_input_monitoring")
 def set_track_input_monitoring(song, params):
     """Set input monitoring state for a track (0=In, 1=Auto, 2=Off)."""