Ableton Copilot MCP

Instructions

Implementation Reference

• src/tools/track-tools.ts:87-91 (handler)

  The main handler function that executes the tool logic: retrieves the track by ID, duplicates the clip to the arrangement at the specified time, and returns the clip data.

  async duplicateClipToTrack({ clip_id, track_id, time }: { clip_id: string, track_id: string, time: number }) {
      const track = getTrackById(track_id)
      const clip = await track.duplicateClipToArrangement(clip_id, time)
      return Result.data(clip.raw)
  }

• src/tools/track-tools.ts:78-86 (registration)

  Tool registration decorator defining the name, description, and input schema (paramsSchema).

  @tool({
      name: 'duplicate_clip_to_track',
      description: 'duplicate clip to track and return the duplicated clip information',
      paramsSchema: {
          clip_id: z.string(),
          track_id: z.string(),
          time: z.number(),
      }
  })

• src/tools/track-tools.ts:81-86 (schema)

  Zod schema for input parameters: clip_id, track_id, and time.

      paramsSchema: {
          clip_id: z.string(),
          track_id: z.string(),
          time: z.number(),
      }
  })

• src/main.ts:41-41 (registration)

  Registers the TrackTools class (containing duplicate_clip_to_track) with the MCP server.

  tools: [BrowserTools, ClipTools, DeviceTools, HistoryTools, SongTools, TrackTools, ExtraTools, ApplicationTools]