YouTube Transcript + YouTube Search MCP

Use this when the user shares a YouTube video link or ID, or asks to summarize, explain, quote, translate, take notes on, or chat about a specific YouTube video, lecture, podcast, or talk. Returns the full spoken text (captions) as one block, plus the title and channel. Set timestamps to true when the user wants timestamps, wants to find or quote where something is said, or wants a timeline or chapter breakdown: each caption line then starts with its [m:ss] time. Accepts watch, youtu.be, Shorts, and live URLs. Do not use for non-YouTube videos or for files the user uploads. If a video has no captions, this returns an error: tell the user instead of guessing what the video says.

{
  "type": "object",
  "properties": {
    "video_url": {
      "type": "string",
      "description": "YouTube URL (full or short) or an 11-character video ID"
    },
    "language": {
      "description": "Language code, e.g. 'en', 'es'. Defaults to 'en'.",
      "type": "string"
    },
    "send_metadata": {
      "description": "Include title/author/thumbnail metadata. Defaults to true.",
      "type": "boolean"
    },
    "timestamps": {
      "description": "One line per caption, each starting with its [m:ss] start time. Defaults to false (one block of text).",
      "type": "boolean"
    }
  },
  "required": [
    "video_url"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when the user wants to find YouTube videos or channels on a topic, for example 'find lectures on linear algebra' or 'popular videos about the Apollo missions', before reading or comparing them. Returns each result's title, video ID, link, channel, views, length, and upload date. Pass `continuation` from a previous response for the next page. Does not return what a video says: call get_youtube_transcript with a result's video ID for that.

{
  "type": "object",
  "properties": {
    "query": {
      "description": "Search query. Required unless `continuation` is set.",
      "type": "string"
    },
    "search_type": {
      "description": "'video' (default) or 'channel'.",
      "type": "string",
      "enum": [
        "video",
        "channel"
      ]
    },
    "continuation": {
      "description": "Opaque token from a previous response - fetches the next page. Do not construct this yourself.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when the user asks what a YouTube channel has posted recently, or wants a channel's details (name, description, links) with its newest uploads. Accepts an @handle, channel URL, or UC... ID. For a channel's full upload history use list_channel_videos; to find a topic inside one channel use search_channel_videos.

{
  "type": "object",
  "properties": {
    "channel": {
      "type": "string",
      "description": "Channel @handle, URL, or UC... id"
    }
  },
  "required": [
    "channel"
  ],
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when the user wants videos from one specific YouTube channel about a topic, for example 'what has @hubermanlab said about sleep' or 'find the MIT OpenCourseWare videos on recursion'. Searches only inside that channel. Pass `continuation` from a previous response for the next page.

{
  "type": "object",
  "properties": {
    "channel": {
      "description": "Channel @handle, URL, or UC... id. Required unless `continuation` is set.",
      "type": "string"
    },
    "query": {
      "description": "Query to search within the channel. Required unless `continuation` is set.",
      "type": "string"
    },
    "continuation": {
      "description": "Opaque token from a previous response - fetches the next page.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when the user wants to browse a YouTube channel's uploads beyond its latest videos, for example to see a creator's older episodes or find a video they remember from that channel. Returns the channel's uploads (its Videos tab) one page at a time. Pass `continuation` from a previous response for the next page.

{
  "type": "object",
  "properties": {
    "channel": {
      "description": "Channel @handle, URL, or UC... id. Required unless `continuation` is set.",
      "type": "string"
    },
    "continuation": {
      "description": "Opaque token from a previous response - fetches the next page.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when the user shares a YouTube playlist, or wants to work through a course, lecture series, or podcast playlist video by video (for example to build study notes for each lecture). Returns the videos in playlist order, one page at a time. Pass `continuation` from a previous response for the next page.

{
  "type": "object",
  "properties": {
    "playlist": {
      "description": "Playlist URL or id. Required unless `continuation` is set.",
      "type": "string"
    },
    "continuation": {
      "description": "Opaque token from a previous response - fetches the next page.",
      "type": "string"
    }
  },
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}

Use this when the user asks how many credits their getyoutubetranscript.com account has left, or after another tool reports the account has no credits remaining. Returns plan and top-up credit balances. Calling it does not use credits.

{
  "type": "object",
  "properties": {},
  "$schema": "https://json-schema.org/draft/2020-12/schema"
}