analyze_clip_music
Analyzes a MIDI clip to identify key and mode candidates, segment chords with roman numerals, out-of-scale notes, rhythm, and melodic motion, revealing its harmony and structure.
Instructions
Musical analysis of a MIDI clip: key and mode candidates (with coverage and outside notes; relative modes are told apart by the harmony, e.g. a V7 pointing to its tonic), chords per segment with roman numerals, out-of-scale notes, range, rhythm (density, offbeat share, polyphony) and melodic motion of the top line. Also reports Live's song scale.
Parameters:
track_index / clip_index: The clip (Session slot or Arrangement index)
location: "session" (default) or "arrangement"
segment_beats: Chord detection window (2 = two chords per bar by default, 4 = one per bar, 1 per beat); identical neighbours are merged
key_root / key_scale: Force the key used for roman numerals (optional)
vocabulary: "basic" (triads and sevenths: classical, pop, counterpoint) or "jazz" (adds 6, 9, sus and extended chords)
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": "analyze_clip_music"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| key_root | No | ||
| location | No | session | |
| key_scale | No | ||
| clip_index | Yes | ||
| vocabulary | No | basic | |
| track_index | Yes | ||
| segment_beats | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |