Spotify MCP Server

Instructions

Implementation Reference

• src/tools/play.ts:65-79 (handler)

  The primary handler function implementing the 'play_random_song' tool logic: fetches a random track using SpotifyClient.getRandomTrack() and plays it on the specified or default device.
  export async function playRandomSong(client: SpotifyClient, deviceId?: string) { const track = await client.getRandomTrack(); await client.playTrack(track.uri, deviceId); return { success: true, message: `Playing random track: ${track.name} by ${track.artist}`, track: { id: track.id, name: track.name, artist: track.artist, album: track.album, }, }; }
• src/server.ts:116-128 (registration)

  Tool registration in the ListToolsRequestSchema handler, defining the tool's name, description, and input schema.
  { name: 'play_random_song', description: 'Play a random song from Spotify', inputSchema: { type: 'object', properties: { deviceId: { type: 'string', description: 'Optional device ID to play on', }, }, }, },
• src/server.ts:307-319 (handler)

  Server-side dispatch handler in CallToolRequestSchema that invokes the playRandomSong function with resolved client and device.
  case 'play_random_song': const randomSongResult = await playTools.playRandomSong( client, deviceManager.getDevice(args?.deviceId as string | undefined) ); return { content: [ { type: 'text', text: JSON.stringify(randomSongResult, null, 2), }, ], };