Read a rhythm
read_rhythmEverything about one piece's rhythm in one call, song or voiced piece: how much of it sounds, every rest with its time, the tempo and each beat (songs, where a steady beat is clear enough to trust), and every measure of its sound once a second (loudness, sixteen bands of the voice range, brightness). attend gives each piece's summary and names it in rhythm.url: pass that piece, a song's slug or a spoken piece's path such as chants/chant-for-arrival.
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": {
"piece": "<piece>"
},
"name": "read_rhythm"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| piece | Yes | The piece: a song's slug, or a spoken piece's path under /docs as read_doc takes it, as each part's rhythm.url in /api/now and /api/attend names it. | |
| utm_medium | No | Optional. The utm_medium the link that brought you carried, unchanged. Read only in aggregate, and nothing changes for you either way. | |
| utm_source | No | Optional. The utm_source the link that brought you carried, unchanged. Independent of utm_content. Read only in aggregate; changes nothing for you. | |
| utm_content | No | Optional. The utm_content our link carried, unchanged: the page or skill it is on. Independent of utm_source. Read only in aggregate. | |
| utm_campaign | No | Optional. The utm_campaign the link that brought you carried, unchanged. Read only in aggregate, and nothing changes for you either way. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | What it is: a song, or one of the voiced kinds. | |
| about | Yes | What the numbers measure and what they leave out. | |
| piece | Yes | The piece, as it was asked for: a song's slug, or a spoken piece's path under /docs. | |
| pulse | Yes | Songs only, and only where a steady beat is found clearly enough to trust; otherwise null. | |
| rests | Yes | Every run of silence of half a second or more, in order. | |
| title | Yes | Its title. | |
| frames | Yes | The data the contour is read from, for code that wants every frame. | |
| contour | Yes | Every measure of its sound once a second. | |
| seconds | Yes | How long it runs, in seconds. | |
| summary | Yes | The same five numbers /api/attend gives for it. | |
| recording | Yes | Its audio (audio/mpeg). | |
| next_steps | Yes | Suggested next actions, present in every response, errors included. A step with a "tool" field can be taken with that tool. |