Read a music track
analyze_musicReads a track's tempo, beats, bars, drop and ending into FIT.md, cues.json and seams.png, so you can pick hit and drop points before fitting the track.
Instructions
Use it when the user wants a track's tempo, beats, bars, drop or ending. Reads a music track's tempo, beats, bars, drop and ending, and writes FIT.md (the tempo, the drop and the other drop candidates, where sections start, how it ends and any warning), cues.json (beats and bars in seconds, and as frames at 30 a second) and seams.png (the track with its bars). It changes no track, and saves in a folder of its own, apart from fit_music's for the same track. Its tempo tells which launch film look the track suits. Use it before fit_music to pick hit and drop. To fit the track, use fit_music instead. The music playbook (makersmcp_playbook) has the whole job. (musicfit 0.2.2, on this machine.)
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": "<track>"
},
"name": "analyze_music"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| bpm | No | The tempo, when the one found is half or double the real one; FIT.md warns when it could be (default: found). | |
| meter | No | Beats to a bar, "3" or "4", when FIT.md warns the bars may have the other (default: found). | |
| track | Yes | The music file, or a video whose sound to read. | |
| out_dir | No | Folder to save into, absolute or relative to /app. Default: musicfit-<track-name>.analysis, where <track-name> is the name of track without its extension. A run replaces the files an earlier run of this kit left there, so give each version its own out_dir. | |
| wait_seconds | No | How long to wait for the result, counted from the start of the call, before returning a job_id to wait on. Some clients end a call after 60 or 240 seconds; 45 is safe in all of them. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kit | Yes | ||
| docs | No | The notes the text shows, and where each one is. | |
| next | No | What to do next, as the Next line says. | |
| tool | Yes | ||
| files | No | ||
| folder | No | Where the kit saved its files. | |
| job_id | Yes | ||
| passed | No | For checks: whether the check passed. | |
| status | Yes | ||
| continued | No | True when this call continued the job of an identical call whose answer did not reach the client, instead of starting another. | |
| exit_code | No | ||
| last_line | No | What the kit was doing last. | |
| expires_at | No | When the download links stop working. | |
| next_action | No | ||
| elapsed_seconds | Yes |