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) }],
    };
  }