Spotify
Arcade toolkit · docs.arcade.dev
The Arcade Spotify toolkit integrates with the Spotify Web API, enabling LLMs to control playback, query catalog data, and inspect playback state on behalf of authenticated users.
Capabilities
- Playback control — pause, resume, skip to next/previous track, and seek to an absolute or relative position within the current track (with automatic boundary clamping)
- Playback introspection — retrieve current playback state (track/episode, active device, progress) and the list of available devices
- Track & artist playback — start playback by track name, artist name (auto-queues four additional tracks by the same artist), or a list of track IDs
- Catalog search — search Spotify's catalog with optional field filters (
album,artist,track,year,genre,isrc,upc,tag:new,tag:hipster) and range syntax for years - Track lookup — fetch full track metadata by Spotify track ID
Tools13
Spotify_AdjustPlaybackPosition
Adjust the playback position within the currently playing track. Knowledge of the current playback state is NOT needed to use this tool as it handles clamping the position to valid start/end boundaries to prevent overshooting or negative values. This tool allows you to seek to a specific position within the currently playing track. You can either provide an absolute position in milliseconds or a relative position from the current playback position in milliseconds. Note: Either absolute_position_ms or relative_position_ms must be provided, but not both.
Spotify_GetAvailableDevices
Get the available devices
Spotify_GetCurrentlyPlaying
Get information about the user's currently playing track
Spotify_GetPlaybackState
Get information about the user's current playback state, including track or episode, and active device. This tool does not perform any actions. Use other tools to control playback.
Spotify_GetTrackFromId
Get information about a track
Spotify_PausePlayback
Pause the currently playing track, if any
Spotify_PlayArtistByName
Play a song by an artist and queue four more songs by the same artist
Spotify_PlayTrackByName
Play a song by name
Spotify_ResumePlayback
Resume the currently playing track, if any
Spotify_Search
Search Spotify catalog information Explanation of the q parameter: You can narrow down your search using field filters. Available filters are album, artist, track, year, upc, tag:hipster, tag:new, isrc, and genre. Each field filter only applies to certain result types. The artist and year filters can be used while searching albums, artists and tracks. You can filter on a single year or a range (e.g. 1955-1960). The album filter can be used while searching albums and tracks. The genre filter can be used while searching artists and tracks. The isrc and track filters can be used while searching tracks. The upc, tag:new and tag:hipster filters can only be used while searching albums. The tag:new filter will return albums released in the past two weeks and tag:hipster can be used to return only albums with the lowest 10% popularity. Example: q="remaster track:Doxy artist:Miles Davis"
Spotify_SkipToNextTrack
Skip to the next track in the user's queue, if any
Spotify_SkipToPreviousTrack
Skip to the previous track in the user's queue, if any
Spotify_StartTracksPlaybackById
Start playback of a list of tracks (songs)