MCP Spotify Server

Instructions

Implementation Reference

• src/handlers/playlists.ts:12-20 (handler)

  Core implementation of the 'get_playlist' tool. Normalizes the playlist ID, handles optional market parameter, and fetches playlist data via Spotify API GET /playlists/{id}.

  async getPlaylist(args: PlaylistArgs) {
    const playlistId = this.extractPlaylistId(args.id);
    const { market } = args;
  
    const params = { market };
    return this.api.makeRequest(
      `/playlists/${playlistId}${this.api.buildQueryString(params)}`
    );
  }

• src/types/playlists.ts:3-5 (schema)

  TypeScript type definition for input arguments: required 'id' (Spotify playlist ID or URI) extending MarketParams (optional market).

  export interface PlaylistArgs extends MarketParams {
    id: string;
  }

• src/index.ts:444-459 (registration)

  MCP tool registration in listTools response, including name, description, and JSON input schema.

  name: 'get_playlist',
  description: 'Get a playlist owned by a Spotify user',
  inputSchema: {
    type: 'object',
    properties: {
      id: {
        type: 'string',
        description: 'The Spotify ID or URI of the playlist'
      },
      market: {
        type: 'string',
        description: 'Optional. An ISO 3166-1 alpha-2 country code'
      }
    },
    required: ['id']
  },

• src/index.ts:829-835 (registration)

  Dispatch handler in CallToolRequest that validates args and calls the playlistsHandler.getPlaylist.

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

• src/handlers/playlists.ts:8-10 (helper)

  Utility method used by getPlaylist to normalize Spotify playlist URI to plain ID.

  private extractPlaylistId(id: string): string {
    return id.startsWith('spotify:playlist:') ? id.split(':')[2] : id;
  }