get_new_releases
Retrieve recently added albums from Spotify's catalog to discover fresh music content.
Instructions
Get a list of new album releases featured in Spotify
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| country | No | Optional. A country code (ISO 3166-1 alpha-2) | |
| limit | No | Maximum number of releases to return (1-50) | |
| offset | No | The index of the first release to return |
Implementation Reference
- src/handlers/albums.ts:65-91 (handler)Implements the core logic for fetching new album releases from Spotify's /browse/new-releases endpoint, including parameter validation and API request.
async getNewReleases(args: NewReleasesArgs) { const { country, limit = 20, offset = 0 } = args; if (limit < 1 || limit > 50) { throw new McpError( ErrorCode.InvalidParams, 'Limit must be between 1 and 50' ); } if (offset < 0) { throw new McpError( ErrorCode.InvalidParams, 'Offset must be non-negative' ); } const params = { country, limit, offset }; return this.api.makeRequest( `/browse/new-releases${this.api.buildQueryString(params)}` ); } - src/types/albums.ts:13-15 (schema)TypeScript interface defining the input arguments for the getNewReleases tool, extending PaginationParams with optional country.
export interface NewReleasesArgs extends PaginationParams { country?: string; } - src/index.ts:319-343 (registration)Registers the get_new_releases tool in the MCP server's listTools response, including name, description, and input schema.
name: 'get_new_releases', description: 'Get a list of new album releases featured in Spotify', inputSchema: { type: 'object', properties: { country: { type: 'string', description: 'Optional. A country code (ISO 3166-1 alpha-2)' }, limit: { type: 'number', description: 'Maximum number of releases to return (1-50)', minimum: 1, maximum: 50, default: 20 }, offset: { type: 'number', description: 'The index of the first release to return', minimum: 0, default: 0 } } }, }, - src/index.ts:789-795 (registration)Dispatches calls to the get_new_releases tool by invoking the AlbumsHandler's getNewReleases method with validated arguments.
case 'get_new_releases': { const args = this.validateArgs<NewReleasesArgs>(request.params.arguments || {}, []); const result = await this.albumsHandler.getNewReleases(args); return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], }; }