Spotify MCP Server

Instructions

Implementation Reference

• src/mcp/tools/albums.ts:5-38 (registration)

  Primary registration of the 'get_album' MCP tool, defining title, description, input schema, and handler function
  get_album: { title: "Get Album", description: `Retrieve comprehensive information about a specific album from Spotify using its unique identifier. 🎯 USE CASES: • Check album details before adding to playlist • Get track listing for a specific album • View album artwork, release date, and artist information • Research album metadata for music discovery 📝 WHAT IT RETURNS: • Album name, artists, and release date • Complete track listing with durations • Album artwork in multiple resolutions • Spotify popularity metrics and genre information • External URLs and market availability 🔍 EXAMPLES: • "Get details for the album 'Abbey Road' by The Beatles" • "Show me information about album ID: 1klALx0u4AavZNEvC4LrTL" • "I need the track list for this album I found" ⚠️ REQUIREMENTS: • Valid Spotify access token with appropriate scopes • Album must exist and be available in user's market`, schema: createSchema({ token: commonSchemas.token(), albumId: commonSchemas.spotifyId("album"), }), handler: async (args: any, spotifyService: SpotifyService) => { const { token, albumId } = args; return await spotifyService.getAlbum(token, albumId); }, },
• src/mcp/tools/albums.ts:34-37 (handler)

  The executable handler logic for the get_album tool, which parses arguments and delegates to SpotifyService
  handler: async (args: any, spotifyService: SpotifyService) => { const { token, albumId } = args; return await spotifyService.getAlbum(token, albumId); },
• src/mcp/tools/albums.ts:30-33 (schema)

  Input schema for get_album tool using common token and Spotify album ID validators
  schema: createSchema({ token: commonSchemas.token(), albumId: commonSchemas.spotifyId("album"), }),
• src/spotify.ts:332-335 (helper)

  Core helper function in SpotifyService that fetches album data from Spotify API endpoint
  async getAlbum(token: string, albumId: string): Promise<SpotifyAlbum> { const id = this.extractId(albumId); return await this.makeRequest<SpotifyAlbum>(`albums/${id}`, token); }
• src/mcp/tools/index.ts:22-23 (registration)

  Aggregation of all tools including albumTools (containing get_album) into central registry used by MCP server
  export const allTools: ToolsRegistry = { ...albumTools,