Skip to main content
Glama

stop_clip

Stops a playing Session clip on a specified track and clip slot, letting you halt playback of individual clips in Ableton Live without stopping the entire set.

Instructions

Stop a playing Session clip.

Parameters:

  • track_index: The track

  • clip_index: The Session slot

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "track_index": "<track_index>",
      "clip_index": "<clip_index>"
    },
    "name": "stop_clip"
  }
}

Input Schema

NameRequiredDescriptionDefault
clip_indexYes
track_indexYes

Output Schema

NameRequiredDescriptionDefault
resultYes

Schema Changelog

Changes observed during successful MCP inspections.

  1. First observedv2.1.1

TDQS

C2.7/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

No annotations exist, so the description carries the full behavioral burden and delivers very little. It does not say whether stopping is immediate or quantized to launch quantization, whether it is idempotent on an already-stopped clip, or whether an invalid slot errors or no-ops — all material for a playback-control mutation.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The core action is front-loaded in one sentence and the parameter list is short with no filler. The parameter block is largely a restatement of the schema property names, but the cost is minor.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

An output schema exists so return values need not be explained, but for a zero-coverage two-parameter playback control the description omits indexing conventions and edge-case behavior. An agent could guess correctly but has no documented basis for doing so.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters2/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema description coverage is 0%, so the description must compensate and only partially does: it labels clip_index as "The Session slot," which usefully disambiguates Session vs arrangement context. However, it gives no indexing base (0- or 1-based), no valid range, and no hint on how to discover indices, leaving both required params under-specified.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

States a specific verb+resource pair ("Stop a playing Session clip") that is unambiguous about scope: Session clips, not arrangement clips. It does not name or contrast with the obvious sibling fire_clip/stop_playback, so an agent must infer the boundary, keeping it below a 5.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

There is no guidance on when to call this rather than stop_playback (transport-level stop) or fire_clip, both of which are adjacent siblings. The only implied condition is the word "playing," with no exclusions or prerequisites described.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Deploy Server

Other Tools