Send a command to Ableton and return the response

Get or create a persistent Ableton connection

Get the global telemetry collector instance

Read self._song.<attr> with cast, returning default on common failures. Catches only narrow exceptions so genuine bugs still surface.

Record a telemetry event (non-blocking)

Find a browser item by its URI. Top-level lookups are memoised on ``self._uri_cache`` so repeated loads of the same URI don't re-walk

Disconnect from the Ableton Remote Script

Extract relevant params from kwargs for logging. Only extracts non-sensitive structural params by default. With consent, can capture more det

Recursive walk used by :py:meth:`_find_browser_item_by_uri`.

Connect to the Ableton Remote Script socket server

Add MIDI notes to a clip

Check if user has consented to detailed data collection

Create an audio clip in the specified audio track clip slot by importing a file. Requires Ableton Live 12.0.5 or newer (the underlying

Create a new MIDI clip in the specified track and clip slot

Create a new MIDI track at the specified index

Copy a Session-view clip into the Arrangement timeline. Uses the real Live API: track.duplicate_clip_to_arrangement(clip, destinati

Fire a clip

Return all clips placed in the Arrangement timeline for a track. Each clip dict contains: name, start_time, end_time, length, color

Get a browser item by URI or path

Get directory for storing telemetry data

Get the type of a device

Get or create anonymous customer UUID

Get information about the current session

Get information about a track

Check if telemetry is disabled via environment variables

Load a browser item onto a track by its URI

Reorder ``roots`` so the URI's likely root is walked first.

Process a command from the client and return a response

Send event to Supabase

Set the name of a clip

Move the arrangement playhead to a position in beats

Set the tempo of the session

Set the name of a track

Start playing the session

Stop a clip

Stop playing the session

Switch Ableton's main window to the Arrangement view

Get browser items at a specific path. Args: path: Path in the format "category/folder/subfolder"

Get a simplified tree of browser categories. Args: category_type: Type of categories to get ('all', 'instruments

Get version from pyproject.toml

Get the current telemetry consent status

Run the MCP server

Receive the complete response, potentially in multiple chunks

Record server startup event

Set the user's telemetry consent status

Start the socket server in a separate thread

Initialize the control surface

Initialize telemetry collector

Print debug message to stderr so it shows in MCP logs

Handle communication with a connected client

Server thread implementation - handles client connections

Background worker that sends telemetry

Add MIDI notes to a clip. Parameters: - track_index: The index of the track containing the clip - clip_index: The index of the clip

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 ClipSl

Create a new MIDI clip in the specified track and clip slot. Parameters: - track_index: The index of the track to create the clip in

Create and return the AbletonMCP script instance

Create a new MIDI track in the Ableton session. Parameters: - index: The index to insert the track at (-1 = end of list) - user_prom

Called when Ableton closes or the control surface is removed

Copy a Session-view clip into the Arrangement timeline. Uses Live's track.duplicate_clip_to_arrangement() API (Live 11 / 12). The clip i

Start playing a clip. Parameters: - track_index: The index of the track containing the clip - clip_index: The index of the clip slot

List all clips placed in the Arrangement timeline for a track. Returns each clip's name, start_time, end_time, length, and type. Parame

Get browser items at a specific path in Ableton's browser. Parameters: - path: Path in the format "category/folder/subfolder"

Get a hierarchical tree of browser categories from Ableton. Parameters: - category_type: Type of categories to get ('all', 'instruments'

Get detailed information about the current Ableton session Parameters: - user_prompt: The original user prompt that led to this tool call (fo

Get detailed information about a specific track in Ableton. Parameters: - track_index: The index of the track to get information about

Check if telemetry is enabled

Load a drum rack and then load a specific drum kit into it. Parameters: - track_index: The index of the track to load on - rack_uri:

Load an instrument or effect onto a track using its URI. Parameters: - track_index: The index of the track to load the instrument on

Convenience function to record tool usage

Decorator that records tool execution with rich metadata. Stores params and other context in metadata for analysis. Args: tool_name:

Manage server startup and shutdown lifecycle

Move the arrangement playhead to a specific position. Parameters: - time: Position in beats from the start of the arrangement (e.g. 8.0

Set the name of a clip. Parameters: - track_index: The index of the track containing the clip - clip_index: The index of the clip sl

Set the tempo of the Ableton session. Parameters: - tempo: The new tempo in BPM - user_prompt: The original user prompt that led to

Set the name of a track. Parameters: - track_index: The index of the track to rename - name: The new name for the track - user_p

Start playing the Ableton session. Parameters: - user_prompt: The original user prompt that led to this tool call (for telemetry)

Stop playing a clip. Parameters: - track_index: The index of the track containing the clip - clip_index: The index of the clip slot

Stop playing the Ableton session. Parameters: - user_prompt: The original user prompt that led to this tool call (for telemetry)

Switch Ableton's main window to the Arrangement view. Parameters: - user_prompt: The original user prompt that led to this tool call (for tel

Decorator to add basic telemetry tracking to MCP tools. Always collects: tool_name, success/failure, duration With consent: user_prompt