YouTube MCP Server

Instructions

Implementation Reference

• src/services/channel.ts:79-98 (handler)

  Core handler function implementing the channels_listVideos tool using YouTube Data API v3 search.list to retrieve videos from a channel.

  async listVideos({ 
    channelId, 
    maxResults = 50 
  }: ChannelVideosParams): Promise<any[]> {
    try {
      this.initialize();
      
      const response = await this.youtube.search.list({
        part: ['snippet'],
        channelId,
        maxResults,
        order: 'date',
        type: ['video']
      });
  
      return response.data.items || [];
    } catch (error) {
      throw new Error(`Failed to list channel videos: ${error instanceof Error ? error.message : String(error)}`);
    }
  }

• src/server.ts:212-219 (registration)

  Dispatch handler in MCP CallToolRequestHandler that calls the ChannelService.listVideos method.

  case 'channels_listVideos': {
      const result = await channelService.listVideos(args as unknown as ChannelVideosParams);
      return {
          content: [{
              type: 'text',
              text: JSON.stringify(result, null, 2)
          }]
      };

• src/server.ts:113-130 (registration)

  Tool registration in ListToolsRequestHandler including name, description, and JSON input schema.

  {
      name: 'channels_listVideos',
      description: 'Get videos from a specific channel',
      inputSchema: {
          type: 'object',
          properties: {
              channelId: {
                  type: 'string',
                  description: 'The YouTube channel ID',
              },
              maxResults: {
                  type: 'number',
                  description: 'Maximum number of results to return',
              },
          },
          required: ['channelId'],
      },
  },

• src/types.ts:61-64 (schema)

  TypeScript interface defining the input parameters (ChannelVideosParams) used by the handler and schema.

  export interface ChannelVideosParams {
    channelId: string;
    maxResults?: number;
  }