# YouTube — MCP server on mcp.ai
> Busca, vídeo, canal, playlist, comentários, trending e relacionados do YouTube. Hospedado pela plataforma, sem necessidade de credencial.

By: mcp.ai · official
Page: https://mcp.ai/youtube

## Connect (MCP protocol)
Remote MCP endpoint (HTTP, streamable): https://api.mcp.ai/p_youtube?ms=1781045700000
Add it as a custom/remote MCP connector, then authenticate when prompted.

## REST API (no MCP client required)
Every tool is also a REST endpoint, authed with a workspace API key.
Discover: GET https://api.mcp.ai/api/youtube/_endpoints   # public; lists every endpoint
Call:     POST https://api.mcp.ai/api/youtube/<endpoint>
  Authorization: Bearer sk_live_…   # create one at https://mcp.ai/settings/api-keys
  Content-Type: application/json
  Body: { …args }   →   { "ok": true, "tool": "<id>", "result": { … } }

## Developer docs
How to use (MCP or REST), markdown: https://mcp.ai/youtube/skill.md
Postman collection (v2.1): https://mcp.ai/youtube/postman.json

## Tools
- youtube_api(path: string, method?: string, query?: object, body?: string) — Escape hatch: call any path on the YouTube backend. Pass path (e.g. /search), optional method (default GET), query map, and JSON body for POST. Prefer the named youtube_* tools when available; this is
- youtube_channel_about(id?: string, forUsername?: string, ids?: string[]) — Channel description, links, country, subscriber count, banner.
- youtube_channel_community(id?: string, forUsername?: string, token?: string, ids?: string[]) — Community posts tab for a channel.
- youtube_channel_featured(id?: string, forUsername?: string, token?: string, ids?: string[]) — Featured channels listed on a channel. Note: YouTube deprecated the featured-channels tab; this route exists upstream but typically returns an empty/error envelope.
- youtube_channel_home(id?: string, forUsername?: string, token?: string, ids?: string[]) — Channel home page payload (featured shelves + meta).
- youtube_channel_playlists(id?: string, forUsername?: string, sort_by?: string, token?: string, ids?: string[]) — Channel playlists tab.
- youtube_channel_search(id?: string, forUsername?: string, query: string, token?: string, ids?: string[]) — Search a channel's own videos and playlists.
- youtube_channel_shorts(id?: string, forUsername?: string, token?: string, ids?: string[]) — Channel shorts tab.
- youtube_channel_shorts_post(id?: string, forUsername?: string, params: string, token?: string, ids?: string[]) — POST variant of channel shorts. Requires a `params` continuation token from a prior GET response. Skip in daily smoke (no synthetic params).
- youtube_channel_store(id?: string, forUsername?: string, ids?: string[]) — Store / merch shelf for a channel.
- youtube_channel_videos(id?: string, forUsername?: string, sort_by?: string, token?: string, ids?: string[]) — Channel videos tab.
- youtube_channel_videos_post(id?: string, forUsername?: string, params: string, token?: string, ids?: string[]) — POST variant of channel videos. Requires a `params` continuation token captured from a prior GET response — used to fetch deeper pages or filtered shelves that the GET surface can't address. Skip in d
- youtube_comments(id: string, sort_by?: string, token?: string, ids?: string[]) — Top-level comments thread for a video.
- youtube_download(id: string, cgeo?: string, ids?: string[]) — Stream/download metadata for a video (formats, audio/video URLs, status).
- youtube_hashtag(tag: string, type?: string, token?: string) — Posts under a hashtag (without leading #).
- youtube_home_feed(geo?: string, lang?: string, token?: string) — YouTube home feed (anonymous, geo/lang aware).
- youtube_hype(geo?: string, lang?: string, token?: string) — YouTube Hype: viral / hyped videos feed.
- youtube_playlist(id: string, token?: string, ids?: string[]) — Playlist items by playlist id.
- youtube_resolve_url(url: string) — Resolve a YouTube URL or share link to its videoId / pageType.
- youtube_search(query: string, type?: string, sort_by?: string, duration?: string, upload_date?: string, geo?: string, lang?: string, token?: string) — Search videos, channels, playlists.
- youtube_trending(geo?: string, type?: string, lang?: string) — Trending videos by region.
- youtube_video_related(id: string, token?: string, ids?: string[]) — Related videos for a given video id.

## Example prompts
- "Busque vídeos sobre "receita fit""
- "Detalhes do vídeo dQw4w9WgXcQ"
- "Trending nos EUA"

## Links
Docs: https://mcp.ai/docs/mcps/youtube
Website: https://mcp.ai/mcps/youtube