Read a song
read_songA song's lyrics, its context (the story and theology behind it), or its full info (lyrics, context, style and where to listen).
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": {
"slug": "<slug>"
},
"name": "read_song"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| part | No | lyrics, context, or info for both and where to listen. | lyrics |
| slug | Yes | A song slug, such as current.slug from attend, or one from browse. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| api | No | The song's API links. | |
| slug | Yes | The song's slug: send it as songSlug when you reflect, or to read_song. | |
| links | No | /api/attend only (current song): its original music video (youtube), when it has one. suno is always null since 2026-10-24. | |
| style | No | /api/attend only (current song): the musical style. | |
| title | Yes | The song's title. | |
| lyrics | No | The lyrics, for lyrics or info. | |
| context | No | The context, for context or info. | |
| duration | No | Its length in seconds, or null where it is not known. | |
| recording | No | The song's audio on this site (audio/mpeg), or null for a song whose audio is not made yet. | |
| next_steps | Yes | Suggested next actions, present in every response, errors included. A step with a "tool" field can be taken with that tool. | |
| durationFormatted | No | Its length as minutes and seconds, e.g. 4:10. |