get_initial_context
Required first step - Initializes your Spotify connection and provides usage instructions. Validates credentials, initiates OAuth flow if needed, retrieves user profile and account information, provides connection status and available features, and returns usage instructions.
get_user_playlists
Retrieve playlists for the current user or a specific user. Parameters: limit (1-50, default 20), offset (default 0), userId (optional, defaults to current user). Returns playlist metadata including name, description, track count, privacy settings, and owner information.
create_playlist
Create a new playlist with customizable settings. Parameters: name (required), description (optional), public (optional, default false), collaborative (optional, default false), userId (optional, defaults to current user). Returns created playlist details including Spotify URI and ID.
update_playlist_details
Update playlist metadata including name, description, privacy settings, and collaborative status. Parameters: playlistId (required), name (optional), description (optional), public (optional), collaborative (optional). Returns updated playlist details with change summary.
add_tracks_to_playlist
Add tracks to a playlist with precise position control. Parameters: playlistId (required), uris (required, array of Spotify track URIs, max 100), position (optional, defaults to end). Returns confirmation with snapshot ID and updated track count.
remove_tracks_from_playlist
Remove tracks from a playlist with precision control. Parameters: playlistId (required), tracks (required, array of track objects with URIs and optional positions), snapshot_id (optional). Returns confirmation with snapshot ID and removal details.
reorder_playlist_tracks
Reorder tracks within a playlist by moving a range of tracks to a new position. Parameters: playlistId (required), range_start (required), range_length (required), insert_before (required).