Skip to main content
Glama

transform_midi_notes

Destructive

Plan or apply exact-ID MIDI note transforms in Ableton Live clips: quantize, legato, duplicate, scaleTime, or reverseTime, with dry-run planning and guarded execution.

Instructions

Plan/apply exact-ID quantize, legato, duplicate, scaleTime or reverseTime MIDI transforms. reverseTime reflects whole selected note spans in an explicit clip-beat window, retaining duration and other exposed properties; hidden expression/envelopes are not reversed.

Input Schema

NameRequiredDescriptionDefault
clipIdYeslist_clips Session ID or supported list_arrangement_clips ID.
dryRunNoFalse executes with token and hash.
noteIdsYesStable note IDs.
trackIdYesID from list_tracks.
planHashNoPlan hash.
operationYes
confirmationTokenNoSingle-use plan token.
expectedStateVersionYesObserved stateVersion.

Output Schema

NameRequiredDescriptionDefault

No arguments

Schema Changelog

Changes observed during successful MCP inspections.

  1. Changed3 schema fields changedv0.3.1
    • changedInput schema / properties / clipId / description
      Previous value: -"Session ID from list_clips; Arrangement ID from list_arrangement_clips where supported."New value: +"list_clips Session ID or supported list_arrangement_clips ID."
    • removedOutput schema / additionalProperties
      Removed value: -true
    • addedOutput schema / anyOf
      Added value: +[
      +  {
      +    "oneOf": [
      +      {
      +        "properties": {
      +          "confirmation": {
      +            "properties": {
      +              "expiresAt": {
      +                "type": "number"
      +              },
      +              "planHash": {
      +                "pattern": "^[a-f0-9]{64}$",
      +                "type": "string"
      +              },
      +              "token": {
      +                "minLength": 1,
      +                "type": "string"
      +              }
      +            },
      +            "required": [
      +              "token",
      +              "planHash",
      +              "expiresAt"
      +            ],
      +            "type": "object"
      +          },
      +          "dryRun": {
      +            "const": true
      +          },
      +          "plan": {
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "dryRun",
      +          "plan",
      +          "confirmation"
      +        ],
      +        "type": "object"
      +      },
      +      {
      +        "properties": {
      +          "dryRun": {
      +            "const": false
      +          },
      +          "operationOutcome": {
      +            "properties": {
      +              "evidence": {
      +                "items": {
      +                  "type": "string"
      +                },
      +                "type": "array"
      +              },
      +              "reason": {
      +                "type": "string"
      +              },
      +              "schemaVersion": {
      +                "const": 1
      +              },
      +              "status": {
      +                "enum": [
      +                  "applied",
      +                  "outcome_unknown",
      +                  "postconditions_failed",
      +                  "pending_postconditions",
      +                  "pending_user_action"
      +                ]
      +              }
      +            },
      +            "required": [
      +              "schemaVersion",
      +              "status",
      +              "reason",
      +              "evidence"
      +            ],
      +            "type": "object"
      +          }
      +        },
      +        "required": [
      +          "dryRun",
      +          "operationOutcome"
      +        ],
      +        "type": "object"
      +      }
      +    ],
      +    "properties": {
      +      "dryRun": {
      +        "type": "boolean"
      +      }
      +    },
      +    "required": [
      +      "dryRun"
      +    ],
      +    "type": "object"
      +  },
      +  {
      +    "properties": {
      +      "error": {
      +        "properties": {
      +          "message": {
      +            "type": "string"
      +          },
      +          "outcome": {
      +            "enum": [
      +              "unknown",
      +              "not_executed"
      +            ]
      +          }
      +        },
      +        "required": [
      +          "message",
      +          "outcome"
      +        ],
      +        "type": "object"
      +      }
      +    },
      +    "required": [
      +      "error"
      +    ],
      +    "type": "object"
      +  }
      +]
  2. Changed13 schema fields changedv0.3.0
    • changedInput schema / properties / clipId / description
      Previous value: -"Stable clip ID: track-N:clip-M from list_clips, or track-N:arrangement-clip-M from list_arrangement_clips for tools that support Arrangement clips."New value: +"Session ID from list_clips; Arrangement ID from list_arrangement_clips where supported."
    • changedInput schema / properties / confirmationToken / description
      Previous value: -"Short-lived, single-use token returned by the matching dry run."New value: +"Single-use plan token."
    • changedInput schema / properties / dryRun / description
      Previous value: -"Omit or true to return a plan; false requires a valid confirmationToken."New value: +"False executes with token and hash."
    • changedInput schema / properties / expectedStateVersion / description
      Previous value: -"Exact stateVersion observed immediately before planning."New value: +"Observed stateVersion."
    • addedInput schema / properties / operation / allOf
      Added value: +[
      +  {
      +    "else": {
      +      "properties": {
      +        "endBeats": false,
      +        "startBeats": false
      +      }
      +    },
      +    "if": {
      +      "properties": {
      +        "type": {
      +          "const": "reverseTime"
      +        }
      +      }
      +    },
      +    "then": {
      +      "properties": {
      +        "endBeats": {},
      +        "factor": false,
      +        "gapBeats": false,
      +        "gridBeats": false,
      +        "offsetBeats": false,
      +        "originBeats": false,
      +        "quantizeDuration": false,
      +        "repeats": false,
      +        "startBeats": {},
      +        "strength": false,
      +        "target": false
      +      },
      +      "required": [
      +        "startBeats",
      +        "endBeats"
      +      ]
      +    }
      +  }
      +]
    • addedInput schema / properties / operation / properties / endBeats
      Added value: +{
      +  "description": "Increasing clip-beat window end; at most 1024 beats wide.",
      +  "exclusiveMinimum": 0,
      +  "type": "number"
      +}
    • addedInput schema / properties / operation / properties / factor
      Added value: +{
      +  "description": "scaleTime multiplies note starts around originBeats and durations. Range 0.25–4 excluding 1; retains bounds and tempo.",
      +  "maximum": 4,
      +  "minimum": 0.25,
      +  "type": "number"
      +}
    • addedInput schema / properties / operation / properties / originBeats
      Added value: +{
      +  "description": "Required scaleTime anchor in clip beats within current playback bounds.",
      +  "minimum": 0,
      +  "type": "number"
      +}
    • addedInput schema / properties / operation / properties / startBeats
      Added value: +{
      +  "description": "Absolute clip-beat window start.",
      +  "minimum": 0,
      +  "type": "number"
      +}
    • changedInput schema / properties / operation / properties / type / enum
      Previous value: -[
      -  "quantize",
      -  "legato",
      -  "duplicate"
      -]New value: +[
      +  "quantize",
      +  "legato",
      +  "duplicate",
      +  "scaleTime",
      +  "reverseTime"
      +]
    • changedInput schema / properties / planHash / description
      Previous value: -"Hash returned by the matching dry run."New value: +"Plan hash."
    • changedInput schema / properties / trackId / description
      Previous value: -"Stable track ID returned by list_tracks."New value: +"ID from list_tracks."
    • changedOutput schema / (root)
      Previous value: -nullNew value: +{
      +  "additionalProperties": true,
      +  "type": "object"
      +}
  3. First observedv0.1.0

TDQS

A3.7/5.0
Behavior4/5

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

Annotations already flag destructiveHint=true and non-idempotent, so the safety profile is covered. The description adds real behavioral context beyond that: reverseTime reflects whole selected note spans within an explicit clip-beat window, preserves duration and exposed properties, and notably leaves hidden expression/envelopes un-reversed. This is meaningful disclosure for a mutation tool.

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?

Two sentences, front-loaded with the purpose and operations before the reverseTime caveat. The second sentence is dense but every clause (span reflection, duration retention, envelope exclusion) carries distinct information, so little is wasted.

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

Completeness4/5

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

For a tool with five operations, a nested operation object, 8 parameters and an output schema, the description covers purpose, the plan/apply workflow and reverseTime specifics adequately. It falls short on routing guidance against the many sibling MIDI tools and on concurrency handling (expectedStateVersion), but nothing critical for a correct call is missing given the rich schema and output schema.

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

Parameters3/5

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

Schema coverage is 88%, so the schema already documents nearly every parameter, establishing a baseline of 3. The description adds a little value by clarifying that reverseTime needs an explicit clip-beat window (relating to startBeats/endBeats), but does not explain the dryRun/confirmationToken/expectedStateVersion interplay beyond the implicit 'plan/apply' framing.

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 (transform) and resource (MIDI notes) and enumerates the five operations (quantize, legato, duplicate, scaleTime, reverseTime) plus the 'exact-ID' scope. This lets an agent distinguish it from the pattern-based siblings like apply_midi_velocity_curve or humanize_midi_notes, though no sibling is named outright.

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

Usage Guidelines3/5

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

The 'Plan/apply' phrasing implies a dry-run-then-apply workflow that maps to the dryRun/planHash/confirmationToken parameters, giving implied usage context. However, it never states when to choose this tool over alternatives such as set_midi_note_properties or the apply_midi_* family, and offers no exclusions.

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