get_new_releases
Find recently released albums on Spotify by specifying genres, regions, or limits. Retrieve album details, artist info, artwork, and popularity scores to stay updated with new music trends.
Instructions
Discover the latest album releases available on Spotify, perfect for staying up-to-date with new music.
🎯 USE CASES: • Weekly music discovery sessions • Finding new releases from favorite genres • Building "New Music Friday" playlists • Keeping up with trending releases in specific regions • Music blog content creation and curation
📝 WHAT IT RETURNS: • Recently released albums with release dates • Artist information and album artwork • Spotify popularity scores and listener counts • Genre classifications and market availability • External links and preview URLs where available
🔍 EXAMPLES: • "Show me the latest album releases this week" • "What new albums came out in the UK recently?" • "Find new releases, limit to 10 albums" • "I want to discover new music that just dropped"
💡 TIPS: • Use country parameter to get region-specific releases • Adjust limit based on how many discoveries you want • Perfect for automated weekly new music updates
⚠️ REQUIREMENTS: • Valid Spotify access token • Optional: Country code for region-specific results
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | Country code for localized content (e.g., 'US', 'GB') | |
| limit | No | ||
| token | Yes | Spotify access token for authentication |
Implementation Reference
- src/spotify.ts:351-363 (handler)Core handler function in SpotifyService that executes the logic to fetch new album releases from the Spotify API's browse/new-releases endpoint.async getNewReleases( token: string, limit: number = 20, country: string | null = null ): Promise<{ albums: PagingObject<SpotifyAlbum> }> { const params: Record<string, any> = { limit: Math.min(limit, 50) }; if (country) params.country = country; return await this.makeRequest<{ albums: PagingObject<SpotifyAlbum> }>( "browse/new-releases", token, params ); }
- src/mcp/tools/albums.ts:40-81 (registration)MCP tool registration for 'get_new_releases', including description, schema definition, and handler that delegates to SpotifyService.get_new_releases: { title: "Get New Album Releases", description: `Discover the latest album releases available on Spotify, perfect for staying up-to-date with new music. 🎯 USE CASES: • Weekly music discovery sessions • Finding new releases from favorite genres • Building "New Music Friday" playlists • Keeping up with trending releases in specific regions • Music blog content creation and curation 📝 WHAT IT RETURNS: • Recently released albums with release dates • Artist information and album artwork • Spotify popularity scores and listener counts • Genre classifications and market availability • External links and preview URLs where available 🔍 EXAMPLES: • "Show me the latest album releases this week" • "What new albums came out in the UK recently?" • "Find new releases, limit to 10 albums" • "I want to discover new music that just dropped" 💡 TIPS: • Use country parameter to get region-specific releases • Adjust limit based on how many discoveries you want • Perfect for automated weekly new music updates ⚠️ REQUIREMENTS: • Valid Spotify access token • Optional: Country code for region-specific results`, schema: createSchema({ token: commonSchemas.token(), limit: commonSchemas.limit(1, 50, 20), country: commonSchemas.country(), }), handler: async (args: any, spotifyService: SpotifyService) => { const { token, limit = 20, country } = args; return await spotifyService.getNewReleases(token, limit, country); }, },
- src/mcp/tools/index.ts:22-36 (registration)Aggregates all tools including albumTools (which contains get_new_releases) into allTools registry used by ToolRegistrar for MCP server.export const allTools: ToolsRegistry = { ...albumTools, ...artistTools, ...trackTools, ...playlistTools, ...playbackTools, ...userTools, ...searchTools, };
- src/mcp/tools/albums.ts:72-76 (schema)Input schema definition for the get_new_releases tool using common schema builders.schema: createSchema({ token: commonSchemas.token(), limit: commonSchemas.limit(1, 50, 20), country: commonSchemas.country(), }),