get_album
Retrieve comprehensive album details from Spotify using the album ID, including track listings, artwork, release dates, and artist information for music discovery and playlist management.
Instructions
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
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token | Yes | Spotify access token for authentication | |
| albumId | Yes | Spotify album ID or URI |
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,