update_video_metadata

Instructions

Implementation Reference

• src/tools/videos.ts:115-160 (handler)

  The handler function for the update_video_metadata tool. It builds a patch object from the provided fields (title, description, tags, category_id, privacy_status), fetches current video data if needed to fill required snippet fields (categoryId, title), then calls client.updateVideo().

  async (args) => {
    const patch: Record<string, unknown> = {};
    const snippet: Record<string, unknown> = {};
    const status: Record<string, unknown> = {};
  
    if (args.title !== undefined) snippet.title = args.title;
    if (args.description !== undefined) snippet.description = args.description;
    if (args.tags !== undefined) snippet.tags = args.tags;
    if (args.category_id !== undefined) snippet.categoryId = args.category_id;
    if (args.privacy_status !== undefined) status.privacyStatus = args.privacy_status;
  
    if (Object.keys(snippet).length > 0) {
      // Category is required when updating snippet — fetch current if user didn't supply one.
      if (!snippet.categoryId) {
        const current = await client.getVideo(args.video_id);
        const existingCategory = current.items[0]?.snippet?.categoryId;
        if (!existingCategory) {
          throw new Error("Video has no category — pass category_id explicitly");
        }
        snippet.categoryId = existingCategory;
      }
      // Title is required for a snippet update.
      if (!snippet.title) {
        const current = await client.getVideo(args.video_id);
        const existingTitle = current.items[0]?.snippet?.title;
        if (!existingTitle) throw new Error("Cannot update snippet without a title");
        snippet.title = existingTitle;
      }
      patch.snippet = snippet;
    }
    if (Object.keys(status).length > 0) patch.status = status;
  
    if (Object.keys(patch).length === 0) {
      return { content: [{ type: "text" as const, text: "No fields to update." }] };
    }
  
    await client.updateVideo(args.video_id, patch);
    return {
      content: [
        {
          type: "text" as const,
          text: `Updated video ${args.video_id} (${Object.keys(patch).join(", ")})`,
        },
      ],
    };
  },

• src/tools/videos.ts:23-35 (schema)

  Zod schema for update_video_metadata input validation: video_id (required), title, description, tags, category_id, privacy_status (all optional).

  const updateVideoMetadataSchema = {
    video_id: z.string(),
    title: z.string().optional(),
    description: z.string().optional(),
    tags: z.array(z.string()).optional(),
    category_id: z
      .string()
      .optional()
      .describe(
        "YouTube category ID as a string (e.g. '22' = People & Blogs, '27' = Education, '28' = Science & Tech)",
      ),
    privacy_status: z.enum(["public", "unlisted", "private"]).optional(),
  };

• src/tools/videos.ts:111-161 (registration)

  Registration of the 'update_video_metadata' tool on the MCP server via server.tool(), with its schema and handler, inside the registerVideoTools() function.

  server.tool(
    "update_video_metadata",
    "Update a video's metadata — title, description, tags, category, or privacy. Only provide fields you want changed.",
    updateVideoMetadataSchema,
    async (args) => {
      const patch: Record<string, unknown> = {};
      const snippet: Record<string, unknown> = {};
      const status: Record<string, unknown> = {};
  
      if (args.title !== undefined) snippet.title = args.title;
      if (args.description !== undefined) snippet.description = args.description;
      if (args.tags !== undefined) snippet.tags = args.tags;
      if (args.category_id !== undefined) snippet.categoryId = args.category_id;
      if (args.privacy_status !== undefined) status.privacyStatus = args.privacy_status;
  
      if (Object.keys(snippet).length > 0) {
        // Category is required when updating snippet — fetch current if user didn't supply one.
        if (!snippet.categoryId) {
          const current = await client.getVideo(args.video_id);
          const existingCategory = current.items[0]?.snippet?.categoryId;
          if (!existingCategory) {
            throw new Error("Video has no category — pass category_id explicitly");
          }
          snippet.categoryId = existingCategory;
        }
        // Title is required for a snippet update.
        if (!snippet.title) {
          const current = await client.getVideo(args.video_id);
          const existingTitle = current.items[0]?.snippet?.title;
          if (!existingTitle) throw new Error("Cannot update snippet without a title");
          snippet.title = existingTitle;
        }
        patch.snippet = snippet;
      }
      if (Object.keys(status).length > 0) patch.status = status;
  
      if (Object.keys(patch).length === 0) {
        return { content: [{ type: "text" as const, text: "No fields to update." }] };
      }
  
      await client.updateVideo(args.video_id, patch);
      return {
        content: [
          {
            type: "text" as const,
            text: `Updated video ${args.video_id} (${Object.keys(patch).join(", ")})`,
          },
        ],
      };
    },
  );

• src/youtube/client.ts:167-170 (helper)

  The YouTubeClient.updateVideo() helper method that sends a PUT request to the YouTube Data API /videos endpoint with the constructed patch body.

  updateVideo(videoId: string, patch: Partial<Video>): Promise<Video> {
    const body = { id: videoId, ...patch };
    return this.dataPut<Video>("/videos", { part: Object.keys(patch).join(",") }, body);
  }