Find songs in the SongUp AI library
find_songsFinds ready-made AI songs from the SongUp AI library and returns each one with a direct link to its audio (MP3). Use it when the user wants to hear AI songs or example songs in a language, genre, mood or for an occasion (for example "an Arabic love song", "Hindi lo-fi", "upbeat birthday pop"). Songs are pre-made library tracks, not made from the user's own words; for a song from their own idea use start_custom_song.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "find_songs"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| limit | No | How many songs to show (default 5). | |
| query | No | Optional genre, mood or occasion to match, in a few words (e.g. "romantic", "lo-fi", "birthday", "rap"). | |
| language | No | Language the songs are sung in, or "Instrumental" for songs without vocals. Defaults to English. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | ||
| query | Yes | ||
| songs | Yes | ||
| language | Yes | ||
| createUrl | Yes |