Analyse a song from a URL
analyze_songStart the analysis of a song at a public audio URL (MP3, WAV, FLAC, M4A, AAC, OGG or AIFF; 30 s to 10 min). Needs an API key on the MCP connection. Returns a song_id; poll get_song until status is 'done' (typically 60–90 seconds, up to ~2 minutes when busy). Uses one free song, or 25 credits (mode 'full') / 10 credits (mode 'dna').
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": {
"audio_url": "<audio_url>"
},
"name": "analyze_song"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| mode | No | full = Song DNA + video direction (story, shot plan with prompts), 25 credits. dna = Song DNA only (no story, no shot plan), 10 credits. A free song covers either. | full |
| title | No | ||
| artist | No | ||
| lyrics | No | Optional: the song's lyrics as plain text. Used for the exact words (timings still come from the audio). | |
| audio_url | Yes | Public http(s) URL of the audio file |