YouTube MCP Server

Instructions

Implementation Reference

• src/services/playlist.ts:37-52 (handler)

  The core handler function that executes the playlists_getPlaylist tool logic by calling the YouTube API to retrieve playlist details.

  async getPlaylist({ 
    playlistId 
  }: PlaylistParams): Promise<any> {
    try {
      this.initialize();
      
      const response = await this.youtube.playlists.list({
        part: ['snippet', 'contentDetails'],
        id: [playlistId]
      });
      
      return response.data.items?.[0] || null;
    } catch (error) {
      throw new Error(`Failed to get playlist: ${error instanceof Error ? error.message : String(error)}`);
    }
  }

• src/server.ts:222-229 (registration)

  Registers the tool handler in the MCP server's CallToolRequestHandler switch statement, delegating to PlaylistService.getPlaylist.

  case 'playlists_getPlaylist': {
      const result = await playlistService.getPlaylist(args as unknown as PlaylistParams);
      return {
          content: [{
              type: 'text',
              text: JSON.stringify(result, null, 2)
          }]
      };

• src/server.ts:131-144 (schema)

  Defines the tool schema (name, description, inputSchema) returned by ListToolsRequestHandler.

  {
      name: 'playlists_getPlaylist',
      description: 'Get information about a YouTube playlist',
      inputSchema: {
          type: 'object',
          properties: {
              playlistId: {
                  type: 'string',
                  description: 'The YouTube playlist ID',
              },
          },
          required: ['playlistId'],
      },
  },

• src/types.ts:69-71 (schema)

  TypeScript interface for the input parameters used in the tool handler and cast in the registration.

  export interface PlaylistParams {
    playlistId: string;
  }