get_category_playlists

Retrieve Spotify playlists by category ID to discover curated music collections for specific genres or moods. Specify category and optional limits to browse relevant playlists.

Instructions

Get a list of Spotify playlists tagged with a particular category

Input Schema

TableJSON Schema

Name	Required	Description
`category_id`	Yes	The Spotify category ID
`limit`	No	Optional. Maximum number of playlists (1-50)
`offset`	No	Optional. Index of the first playlist to return

Implementation Reference

src/handlers/playlists.ts:131-142 (handler)

The core handler function that implements the logic for 'get_category_playlists' by making a Spotify API request to retrieve playlists for a given category.

async getCategoryPlaylists(args: GetCategoryPlaylistsArgs) {
  const { category_id, limit, offset } = args;

  const params = {
    ...(limit !== undefined && { limit }),
    ...(offset !== undefined && { offset })
  };

  return this.api.makeRequest(
    `/browse/categories/${category_id}/playlists${this.api.buildQueryString(params)}`
  );
}

src/types/playlists.ts:51-55 (schema)
TypeScript interface defining the input arguments for the get_category_playlists tool.
```
export interface GetCategoryPlaylistsArgs {
  category_id: string;
  limit?: number;
  offset?: number;
}
```

src/index.ts:664-688 (registration)

Tool registration in the ListTools response, defining name, description, and input schema.

{
  name: 'get_category_playlists',
  description: 'Get a list of Spotify playlists tagged with a particular category',
  inputSchema: {
    type: 'object',
    properties: {
      category_id: {
        type: 'string',
        description: 'The Spotify category ID'
      },
      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
      }
    },
    required: ['category_id']
  },
}

src/index.ts:893-899 (registration)

Dispatch handler in the CallToolRequest that routes to the playlistsHandler.getCategoryPlaylists method.

case 'get_category_playlists': {
  const args = this.validateArgs<GetCategoryPlaylistsArgs>(request.params.arguments, ['category_id']);
  const result = await this.playlistsHandler.getCategoryPlaylists(args);
  return {
    content: [{ type: 'text', text: JSON.stringify(result, null, 2) }],
  };
}

MCP Spotify Server