YouTube MCP Server

Instructions

Implementation Reference

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

  Core handler function in ChannelService that fetches YouTube channel details using the YouTube Data API v3, calling channels.list with snippet, statistics, and contentDetails parts.

  async getChannel({ 
    channelId 
  }: ChannelParams): Promise<unknown> {
    try {
      this.initialize();
      
      const response = await this.youtube.channels.list({
        part: ['snippet', 'statistics', 'contentDetails'],
        id: [channelId]
      });
  
      return response.data.items?.[0] || null;
    } catch (error) {
      throw new Error(`Failed to get channel: ${error instanceof Error ? error.message : String(error)}`);
    }
  }

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

  MCP tool registration for 'channels_getChannel', defining input schema, description, and handler that delegates to ChannelService.getChannel.

  server.registerTool(
      'channels_getChannel',
      {
          title: 'Get Channel Information',
          description: 'Get information about a YouTube channel',
          annotations: { readOnlyHint: true, idempotentHint: true },
          inputSchema: {
              channelId: z.string().describe('The YouTube channel ID'),
          },
      },
      async ({ channelId }) => {
          const result = await channelService.getChannel({ channelId });
          return {
              content: [{
                  type: 'text',
                  text: JSON.stringify(result, null, 2)
              }]
          };
      }
  );

• src/types.ts:54-56 (schema)

  TypeScript interface defining the input parameters for channel operations, used by the ChannelService.getChannel method.

  export interface ChannelParams {
    channelId: string;
  }