YouTube transcripts, search, channel browsing, and playlists for AI agents via MCP.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
Use this when the user asks what a YouTube channel has posted recently, or wants a channel's details (name, handle, description, subscribers) with its 15 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.
Channel @handle, URL, or UC... id
Use this when the user asks what a YouTube channel has posted recently, or wants a channel's details (name, handle, description, subscribers) with its 15 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.
| Argument | Type | Description |
|---|---|---|
| channel* | string | Channel @handle, URL, or UC... id |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"channel"
],
"properties": {
"channel": {
"type": "string",
"description": "Channel @handle, URL, or UC... id"
}
}
}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.
No arguments.
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {}
}Use this when the user asks which caption or subtitle languages a YouTube video has, or before requesting a transcript in a non-English language when you don't know whether the video offers it. Returns each language with its code (pass it as `language` to get_youtube_transcript), whether it is creator-uploaded or auto-generated, and the default language. An empty list means the video has captions turned off. Costs 1 credit. Not needed for an ordinary transcript request: get_youtube_transcript already reports which language it returned.
| Argument | Type | Description |
|---|---|---|
| video_url* | string | YouTube URL (full or short) or an 11-character video ID |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"video_url"
],
"properties": {
"video_url": {
"type": "string",
"description": "YouTube URL (full or short) or an 11-character video ID"
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| language | string | Language code, e.g. 'en', 'es'. Defaults to 'en'. |
| translate | string | Language code to machine-translate the transcript into, e.g. 'es', 'zh-CN'. Timestamps stay aligned. Use when the user wants the video's text in another language. |
| video_url* | string | YouTube URL (full or short) or an 11-character video ID |
| timestamps | boolean | One line per caption, each starting with its [m:ss] start time. Defaults to false (one block of text). |
| send_metadata | boolean | Include title/author/thumbnail metadata. Defaults to true. |
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.
| Argument | Type | Description |
|---|---|---|
| channel | string | Channel @handle, URL, or UC... id. Required unless `continuation` is set. |
| continuation | string | Opaque token from a previous response - fetches the next page. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"channel": {
"type": "string",
"description": "Channel @handle, URL, or UC... id. Required unless `continuation` is set."
},
"continuation": {
"type": "string",
"description": "Opaque token from a previous response - fetches the next page."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| playlist | string | Playlist URL or id. Required unless `continuation` is set. |
| continuation | string | Opaque token from a previous response - fetches the next page. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"playlist": {
"type": "string",
"description": "Playlist URL or id. Required unless `continuation` is set."
},
"continuation": {
"type": "string",
"description": "Opaque token from a previous response - fetches the next page."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| query | string | Query to search within the channel. Required unless `continuation` is set. |
| channel | string | Channel @handle, URL, or UC... id. Required unless `continuation` is set. |
| continuation | string | Opaque token from a previous response - fetches the next page. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"query": {
"type": "string",
"description": "Query to search within the channel. Required unless `continuation` is set."
},
"channel": {
"type": "string",
"description": "Channel @handle, URL, or UC... id. Required unless `continuation` is set."
},
"continuation": {
"type": "string",
"description": "Opaque token from a previous response - fetches the next page."
}
}
}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.
| Argument | Type | Description |
|---|---|---|
| query | string | Search query. Required unless `continuation` is set. |
| search_type | string | 'video' (default) or 'channel'. |
| continuation | string | Opaque token from a previous response - fetches the next page. Do not construct this yourself. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"properties": {
"query": {
"type": "string",
"description": "Search query. Required unless `continuation` is set."
},
"search_type": {
"enum": [
"video",
"channel"
],
"type": "string",
"description": "'video' (default) or 'channel'."
},
"continuation": {
"type": "string",
"description": "Opaque token from a previous response - fetches the next page. Do not construct this yourself."
}
}
}{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"video_url"
],
"properties": {
"language": {
"type": "string",
"description": "Language code, e.g. 'en', 'es'. Defaults to 'en'."
},
"translate": {
"type": "string",
"pattern": "^[a-zA-Z]{2,3}(-[a-zA-Z0-9]{2,8})?$",
"description": "Language code to machine-translate the transcript into, e.g. 'es', 'zh-CN'. Timestamps stay aligned. Use when the user wants the video's text in another language."
},
"video_url": {
"type": "string",
"description": "YouTube URL (full or short) or an 11-character video ID"
},
"timestamps": {
"type": "boolean",
"description": "One line per caption, each starting with its [m:ss] start time. Defaults to false (one block of text)."
},
"send_metadata": {
"type": "boolean",
"description": "Include title/author/thumbnail metadata. Defaults to true."
}
}
}