get_new_releases
Discover recently released albums on Spotify to stay current with new music, find genre-specific releases, and build updated playlists.
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 |
|---|---|---|---|
| token | Yes | Spotify access token for authentication | |
| limit | No | ||
| country | No | Country code for localized content (e.g., 'US', 'GB') |
Implementation Reference
- src/mcp/tools/albums.ts:77-80 (handler)The MCP tool handler for 'get_new_releases'. It parses arguments (token, limit, country) and delegates execution to the SpotifyService.getNewReleases method.
handler: async (args: any, spotifyService: SpotifyService) => { const { token, limit = 20, country } = args; return await spotifyService.getNewReleases(token, limit, country); }, - src/mcp/tools/albums.ts:72-76 (schema)The input schema definition for the 'get_new_releases' tool, specifying parameters: token (required), limit (1-50, default 20), country (optional).
schema: createSchema({ token: commonSchemas.token(), limit: commonSchemas.limit(1, 50, 20), country: commonSchemas.country(), }), - src/mcp/tools/index.ts:23-23 (registration)The albumTools object (containing 'get_new_releases') is included in the central allTools registry via object spread. This registry is used by ToolRegistrar for MCP tool listing and execution.
...albumTools, - src/spotify.ts:351-363 (helper)The SpotifyService helper method implementing the core logic: calls Spotify API endpoint 'browse/new-releases' with limit and optional country parameters, returning paging object of new albums.
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 ); }