create_playlist_from_songs
Creates a TIDAL playlist by searching for songs from descriptions and adding best matches, reporting match rate and unmatched songs.
Instructions
Creates a TIDAL playlist by searching for songs and adding the best matches.
This is the RECOMMENDED way to create a playlist when you have song names/descriptions.
USE THIS TOOL WHEN:
- A user provides a list of song names to add to a playlist
- You need to create a playlist from song descriptions (not track IDs)
- You want to build a playlist based on user-provided song names
This tool handles the entire workflow efficiently:
1. Batch search for all songs concurrently
2. Collect the best matching track IDs
3. Create the playlist with all found tracks
This is MUCH faster than searching for songs one-by-one and then creating a playlist.
Args:
title: Name for the new playlist
song_descriptions: List of song descriptions to search for.
Include artist name for better matching.
Examples: ["Bohemian Rhapsody by Queen", "Yesterday Beatles",
"Stairway to Heaven Led Zeppelin"]
Maximum 100 songs per request.
description: Optional playlist description
Returns:
Dictionary with:
- playlist: Created playlist details including URL
- matched_songs: List of songs that were found with their track info
- unmatched_songs: List of songs that couldn't be found
- match_rate: e.g., "45/50" showing how many songs were matched
Example:
create_playlist_from_songs(
title="My 80s Favorites",
song_descriptions=[
"Take On Me a-ha",
"Livin' on a Prayer Bon Jovi",
"Sweet Child O' Mine Guns N' Roses"
],
description="Classic 80s hits"
)
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| title | Yes | ||
| description | No | ||
| song_descriptions | Yes |