MCP Spotify Server

Instructions

Implementation Reference

• src/handlers/playlists.ts:117-129 (handler)

  The core handler function that implements the logic for fetching featured playlists from the Spotify Browse API endpoint /browse/featured-playlists, constructing query parameters from input args.
  async getFeaturedPlaylists(args: GetFeaturedPlaylistsArgs) { const { locale, limit, offset } = args; const params = { ...(locale !== undefined && { locale }), ...(limit !== undefined && { limit }), ...(offset !== undefined && { offset }) }; return this.api.makeRequest( `/browse/featured-playlists${this.api.buildQueryString(params)}` ); }
• src/types/playlists.ts:45-49 (schema)

  TypeScript interface defining the optional input parameters (locale, limit, offset) for the get_featured_playlists tool.
  export interface GetFeaturedPlaylistsArgs { locale?: string; limit?: number; offset?: number; }
• src/index.ts:640-663 (registration)

  Registration of the get_featured_playlists tool in the MCP server's ListTools response, including name, description, and input schema.
  { name: 'get_featured_playlists', description: 'Get a list of Spotify featured playlists', inputSchema: { type: 'object', properties: { locale: { type: 'string', description: 'Optional. Desired language (format: es_MX)' }, limit: { type: 'number', description: 'Optional. Maximum number of playlists (1-50)', minimum: 1, maximum: 50 }, offset: { type: 'number', description: 'Optional. Index of the first playlist to return', minimum: 0 } } }, },
• src/index.ts:885-891 (registration)

  Dispatch logic in the CallToolRequestSchema handler that validates arguments and delegates to the playlistsHandler.getFeaturedPlaylists method.
  case 'get_featured_playlists': { const args = this.validateArgs<GetFeaturedPlaylistsArgs>(request.params.arguments || {}, []); const result = await this.playlistsHandler.getFeaturedPlaylists(args); return { content: [{ type: 'text', text: JSON.stringify(result, null, 2) }], }; }