Spotify MCP Server

Instructions

Implementation Reference

• src/mcp/tools/albums.ts:83-124 (registration)

  MCP tool registration for 'get_album_tracks', defining metadata, input schema, and handler that delegates to SpotifyService.getAlbumTracks
  get_album_tracks: { title: "Get Album Tracks", description: `Retrieve the complete track listing for any album, including detailed information about each song. 🎯 USE CASES: • Building custom playlists from favorite albums • Checking track order and durations before purchase • Creating "deep cuts" playlists from lesser-known album tracks • Analyzing album structure and flow • Finding specific tracks within concept albums or compilations 📝 WHAT IT RETURNS: • Complete ordered track listing with track numbers • Individual track durations and preview URLs • Track popularity scores and explicit content flags • Artist credits for each track (including featured artists) • External IDs and market availability per track 🔍 EXAMPLES: • "Get all tracks from 'Dark Side of the Moon' album" • "Show me the tracklist for album ID: 4LH4d3cOWNNsVw41Gqt2kv" • "I want to see all songs from this compilation album" • "List the tracks from this soundtrack, limit to 20" 💡 TIPS: • Use this before adding entire albums to playlists • Great for discovering hidden gems in large albums • Check explicit flags if building family-friendly playlists ⚠️ REQUIREMENTS: • Valid Spotify access token • Album must be available in user's market`, schema: createSchema({ token: commonSchemas.token(), albumId: commonSchemas.spotifyId("album"), limit: commonSchemas.limit(1, 50, 50), }), handler: async (args: any, spotifyService: SpotifyService) => { const { token, albumId, limit = 50 } = args; return await spotifyService.getAlbumTracks(token, albumId, limit); }, },
• src/mcp/tools/albums.ts:120-123 (handler)

  Handler function for the get_album_tracks tool, which validates args and calls the Spotify service method
  handler: async (args: any, spotifyService: SpotifyService) => { const { token, albumId, limit = 50 } = args; return await spotifyService.getAlbumTracks(token, albumId, limit); },
• src/mcp/tools/albums.ts:115-119 (schema)

  Input schema definition for get_album_tracks tool using common schemas for token, albumId, and optional limit
  schema: createSchema({ token: commonSchemas.token(), albumId: commonSchemas.spotifyId("album"), limit: commonSchemas.limit(1, 50, 50), }),
• src/spotify.ts:337-349 (helper)

  SpotifyService helper method implementing the core logic to fetch album tracks from Spotify API endpoint /albums/{id}/tracks
  async getAlbumTracks( token: string, albumId: string, limit: number = 50 ): Promise<PagingObject<SpotifyTrack>> { const id = this.extractId(albumId); const params = { limit: Math.min(limit, 50) }; return await this.makeRequest<PagingObject<SpotifyTrack>>( `albums/${id}/tracks`, token, params ); }