fire_clip
Initiate playback of a specific clip in Ableton Live by specifying the track and clip index, integrating AI-assisted music production workflows.
Instructions
Start playing a clip.
Parameters:
track_index: The index of the track containing the clip
clip_index: The index of the clip slot containing the clip
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| clip_index | Yes | ||
| track_index | Yes |
Implementation Reference
- MCP_Server/server.py:440-459 (handler)Primary MCP tool handler decorated with @mcp.tool(). Sends 'fire_clip' command to Ableton remote script with track and clip indices. Includes input schema in docstring and error handling.@mcp.tool() def fire_clip(ctx: Context, track_index: int, clip_index: int) -> str: """ Start playing a clip. Parameters: - track_index: The index of the track containing the clip - clip_index: The index of the clip slot containing the clip """ try: ableton = get_ableton_connection() result = ableton.send_command("fire_clip", { "track_index": track_index, "clip_index": clip_index }) return f"Started playing clip at track {track_index}, slot {clip_index}" except Exception as e: logger.error(f"Error firing clip: {str(e)}") return f"Error firing clip: {str(e)}"
- Core implementation in Ableton remote script that validates indices, retrieves the clip slot, and calls clip_slot.fire() using Ableton Live API.def _fire_clip(self, track_index, clip_index): """Fire a clip""" try: if track_index < 0 or track_index >= len(self._song.tracks): raise IndexError("Track index out of range") track = self._song.tracks[track_index] if clip_index < 0 or clip_index >= len(track.clip_slots): raise IndexError("Clip index out of range") clip_slot = track.clip_slots[clip_index] if not clip_slot.has_clip: raise Exception("No clip in slot") clip_slot.fire() result = { "fired": True } return result except Exception as e: self.log_message("Error firing clip: " + str(e)) raise
- AbletonMCP_Remote_Script/__init__.py:229-232 (registration)Dispatch registration in remote script's _process_command where 'fire_clip' is listed among state-modifying commands routed to main thread execution.elif command_type in ["create_midi_track", "set_track_name", "create_clip", "add_notes_to_clip", "set_clip_name", "set_tempo", "fire_clip", "stop_clip", "start_playback", "stop_playback", "load_browser_item"]:
- MCP_Server/server.py:104-109 (helper)Helper logic in server that classifies 'fire_clip' as a state-modifying command, applying special handling like delays and extended timeouts.is_modifying_command = command_type in [ "create_midi_track", "create_audio_track", "set_track_name", "create_clip", "add_notes_to_clip", "set_clip_name", "set_tempo", "fire_clip", "stop_clip", "set_device_parameter", "start_playback", "stop_playback", "load_instrument_or_effect" ]