YouTube

io.github.mcp-dirPublished by GitHub account mcp-dirv0.1.0Updated Nov 2, 2026

Search, video, channel, playlist, comments, trending and related items from YouTube. Hosted by the p

VerifiedStreamable HTTPWeb executableCommunication & CollaborationMedia & Design

Overview

AI-generated overview

Hosted YouTube MCP server that lets an assistant search videos, channels and playlists, read comments, and post or moderate comments on a connected channel.

What you can do
  • Search and browse YouTube: search videos, channels and playlists, resolve share links, view home feed, trending, hype and hashtag feeds, and related videos
  • Inspect videos and playlists: video metadata and download format/stream info, playlist items, top-level comment threads
  • Inspect channels: home shelves, about info, videos, shorts, playlists, community posts, store shelf, featured channels and in-channel search, with batched ids
  • Manage comments as a connected channel: list connected channels, reply to threads, post new comments, edit, moderate (publish, hold, reject, ban author) and delete
  • Call arbitrary YouTube backend paths through a generic escape-hatch tool
  • Platform utilities…
When to use it
Use it when an assistant needs YouTube research or content work: finding videos and channels, summarizing comment threads, tracking trends, or managing and moderating comments on a channel you own. It is a hosted option that needs no local install.
Requirements
Remote MCP over HTTP at the documented endpoint; no local runtime or package. Reading works without credentials, but comment posting, editing, moderation and deletion act as a connected channel and require logging in (magic-link login or an access token supplied as an Authorization Bearer header). Paid plans apply beyond the free tier.
Before you install
Comment tools write to a live channel: posting, editing, moderating and deleting are real actions, and deletion is permanent with no undo. Quota units are consumed per call, some costing 50 units. The server is proprietary and hosted, and returned data is passed to whichever LLM host you use. The generic backend-path tool can reach routes outside the named tools.

Installation

In SourceWeft

  1. Open YouTube in the dashboard and add it to a workspace.
  2. Enable the server for the chats that should use its tools.

Web executable via Streamable HTTP. Remote servers run from the web runtime once configured in a workspace.

Use with an agent

Paste this prompt into Claude Code, Codex, Cursor or another agent — or into SourceWeft chat. The agent reads this server's install guide, shows you its publisher, endpoint and sign-in, and adds it to your client once you agree. Keys never go into a command.

Read https://sourceweft.com/mcp/io.github.mcp-dir%2Fyoutube-mcp/install.md and connect the MCP server it describes to my client. Before changing any config, show me its publisher, endpoint and sign-in method and wait for my OK. Never put an API key in a command or in a file I would commit; ask me where it should come from.

Read the install guide the agent follows

Other MCP clients

Add this to your client's mcpServers config.

{
  "mcpServers": {
    "youtube": {
      "type": "http",
      "url": "https://api.mcp.ai/p_youtube"
    }
  }
}

README

YouTube

YouTube para Claude, ChatGPT e agentes de IA

Busca, vídeo, canal, playlist, comentários, trending e relacionados do YouTube. Hospedado pela plataforma, sem necessidade de credencial.

  • 📊 22 ferramentas
  • ✏️ Leitura e escrita
  • 💬 Funciona com qualquer cliente MCP: Claude Desktop, Cursor, VS Code, Cline, Continue
  • 🔑 Login via magic-link (sem senha)

English version · Documentação completa · Skill pra agentes

Instalar em 1 clique

Claude (Web e Desktop)

A Anthropic unificou a instalação de MCPs em claude.ai/customize/connectors. O mesmo link serve pra Claude Web e Claude Desktop (basta estar logado):

➕ Abrir no Claude e conectar

Manual (se o deeplink não abrir): claude.ai/customize/connectors → + → Adicionar conector personalizado → cole Nome YouTube e URL https://api.mcp.ai/p_youtube.

Cursor

➕ Instalar YouTube no Cursor

VS Code (Copilot Chat)

➕ Instalar YouTube no VS Code

ChatGPT, Manus, OpenClaw e mais 40+ clientes

Funciona em qualquer cliente MCP que suporte MCP over HTTP. A URL do servidor é sempre:

https://api.mcp.ai/p_youtube

Detalhes por cliente: INSTALL.md.

Exemplos de uso

Busque vídeos sobre "receita fit"Detalhes do vídeo dQw4w9WgXcQTrending nos EUA

22 ferramentas disponíveis

ToolDescrição
youtube_home_feedYouTube home feed (anonymous, geo/lang aware).
youtube_trendingTrending videos by region.
youtube_searchSearch videos, channels, playlists.
youtube_resolve_urlResolve a YouTube URL or share link to its videoId / pageType.
youtube_downloadStream/download metadata for a video (formats, audio/video URLs, status).
youtube_hypeYouTube Hype: viral / hyped videos feed.
youtube_hashtagPosts under a hashtag (without leading #).
youtube_playlistPlaylist items by playlist id.
youtube_commentsTop-level comments thread for a video.
youtube_video_relatedRelated videos for a given video id.
youtube_channel_homeChannel home page payload (featured shelves + meta).
youtube_channel_aboutChannel description, links, country, subscriber count, banner.
youtube_channel_videosChannel videos tab. Bulk support: accepts ids for batched execution.
youtube_channel_shortsChannel shorts tab. Bulk support: accepts ids for batched execution.
youtube_channel_playlistsChannel playlists tab. Bulk support: accepts ids for batched execution.
youtube_channel_communityCommunity posts tab for a channel.
youtube_channel_featuredFeatured channels listed on a channel.
youtube_channel_storeStore / merch shelf for a channel.
youtube_channel_searchSearch a channel's own videos and playlists.
youtube_channel_videos_postPOST variant of channel videos.
youtube_channel_shorts_postPOST variant of channel shorts.
youtube_apiEscape hatch: call any path on the YouTube backend.

Detalhe de cada tool: docs/ferramentas.md

Preços

Planos a partir do tier grátis. Veja docs/precos.md.

Privacidade & LGPD

  • Sub-processadores: o LLM host que você escolher (Claude, ChatGPT, Cursor, agente próprio). Lista completa em docs/privacidade-lgpd.md.
  • Os dados retornados pelas tools são enviados ao LLM host que você escolher, sub-processador fora do nosso controle. Recomendamos planos com opt-out de treinamento.

Perguntas frequentes

O servidor é open source? O servidor é proprietário (hosted). Este repositório é o wrapper público com manifestos, docs e skills — tudo MIT.

Posso usar com agente próprio (não Claude/Cursor)? Sim — qualquer cliente que suporte MCP over HTTP. URL: https://api.mcp.ai/p_youtube.

Suporte

Licença

MIT — veja LICENSE. O servidor MCP em api.mcp.ai/p_youtube é proprietário (hosted); este repositório (manifestos, docs, skills) é MIT.

Source: README.md at commit 1cf7430

Tools

35

youtube_home_feed

YouTube home feed (anonymous, geo/lang aware).

Parametersgeolangtoken

youtube_resolve_url

Resolve a YouTube URL or share link to its videoId / pageType.

Parametersurlrequired

youtube_download

Stream/download metadata for a video (formats, audio/video URLs, status). Bulk support: accepts ids for batched execution.

Parametersidrequiredidscgeo

youtube_hype

YouTube Hype: viral / hyped videos feed.

Parametersgeolangtoken

youtube_hashtag

Posts under a hashtag (without leading #).

Parameterstagrequiredtypetoken

youtube_playlist

Playlist items by playlist id. Bulk support: accepts ids for batched execution.

Parametersidrequiredidstoken

youtube_comments

Top-level comments thread for a video. Bulk support: accepts ids for batched execution.

Parametersidrequiredidstokensort_by

youtube_channel_home

Channel home page payload (featured shelves + meta). Bulk support: accepts ids for batched execution.

ParametersididstokenforUsername

youtube_channel_about

Channel description, links, country, subscriber count, banner. Bulk support: accepts ids for batched execution.

ParametersididsforUsername

youtube_channel_videos

Channel videos tab. Bulk support: accepts ids for batched execution.

Parametersididstokensort_byforUsername

youtube_channel_shorts

Channel shorts tab. Bulk support: accepts ids for batched execution.

ParametersididstokenforUsername

youtube_channel_playlists

Channel playlists tab. Bulk support: accepts ids for batched execution.

Parametersididstokensort_byforUsername

youtube_channel_community

Community posts tab for a channel. Bulk support: accepts ids for batched execution.

ParametersididstokenforUsername

youtube_channel_store

Store / merch shelf for a channel. Bulk support: accepts ids for batched execution.

ParametersididsforUsername

youtube_channel_videos_post

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 daily smoke (no synthetic params). Bulk support: accepts ids for batched execution.

ParametersididstokenparamsrequiredforUsername

youtube_channel_shorts_post

POST variant of channel shorts. Requires a `params` continuation token from a prior GET response. Skip in daily smoke (no synthetic params). Bulk support: accepts ids for batched execution.

ParametersididstokenparamsrequiredforUsername

youtube_api

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 for routes not in the manifest.

Parametersbodypathrequiredquerymethod

youtube_my_channels

Lista os canais do YouTube conectados (os que podem responder e moderar comentários), com id, nome e estatísticas. Use antes de responder para confirmar de qual canal a resposta vai sair. Custa 1 unidade da cota.

Parametersaccount

youtube_comment_threads

Comentários de TOPO pela API oficial, com as respostas já existentes. É daqui que sai o `parent_id` usado em youtube_comment_reply (o id do thread), então prefira esta tool a youtube_comments quando a intenção for responder. Sem `video_id`, traz os comentários do canal conectado inteiro (bom para 'o que ainda não respondi'). Custa 1 unidade da cota. Bulk support: accepts video_ids, channel_ids for batched execution.

Parametersorderaccountvideo_idvideo_idschannel_idpage_tokenchannel_idsmax_resultssearch_termsmoderation_status

youtube_comment_reply

Responde comentários como o canal conectado. Aceita VÁRIAS respostas numa chamada (`replies`), e um item que falha não derruba os outros. `parent_id` tem que ser o id de um comentário de TOPO (campo `id` do thread devolvido por youtube_comment_threads), nunca o id de uma resposta. Cada resposta consome 50 unidades da cota da API do YouTube, então responda o que importa em vez de varrer o canal.

Parametersaccountrepliesrequired

youtube_comment_post

Publica um comentário NOVO de topo em um vídeo, como o canal conectado. Para responder alguém, use youtube_comment_reply. Custa 50 unidades da cota. Bulk support: accepts video_ids for batched execution.

Parameterstextrequiredaccountvideo_idrequiredvideo_ids

youtube_comment_update

Edita o texto de um comentário ou resposta PUBLICADO pelo canal conectado (corrigir um erro sem apagar e repostar, o que perderia as curtidas e o encadeamento). Só funciona em comentário de autoria do próprio canal. Custa 50 unidades da cota. Bulk support: accepts comment_ids for batched execution.

Parameterstextrequiredaccountcomment_idrequiredcomment_ids

youtube_comment_moderate

Modera comentários no canal conectado: publica (`published`), segura para revisão (`heldForReview`) ou rejeita (`rejected`). `ban_author` só é aceito junto de `rejected`. Vale apenas para comentários em vídeos do próprio canal. Custa 50 unidades por comentário.

Parametersstatusrequiredaccountban_authorcomment_idsrequired

youtube_comment_delete

Apaga DEFINITIVAMENTE um comentário (não tem desfazer). Só funciona em comentário do próprio canal ou em vídeo do canal conectado. Para esconder sem apagar, prefira youtube_comment_moderate com `rejected`. Custa 50 unidades da cota. Bulk support: accepts comment_ids for batched execution.

Parametersaccountcomment_idrequiredcomment_ids

show_version

Show Version

Show the current MCP platform and adapter versions.

Takes no parameters.

report_bug

Report Bug

Report a bug, missing feature, or send feedback. Include the conversation array with recent messages for reproduction.

Parameterscontextmessagerequiredconversation

connect

Connection Status

Returns connection status and URLs. When all providers are connected, returns authenticated:true and empty pending[]. When credentials are missing, returns connect_url for the toolkit and per-install URLs.

Takes no parameters.

toolkit_info

Toolkit Info

Returns the current toolkit state: installed MCPs, their connection status, the accounts connected to each one, and how many catalog tools each exposes.

Takes no parameters.

marketplace

Marketplace

The official mcp.ai marketplace — the in-platform catalog of every MCP/tool, AND the way to run them. Covers capability requests like "find an MCP that does X", "consulta um CPF", "is there a tool for Y". Core flow: action=search discovers MCPs by intent → describe returns one MCP's full profile (every tool with its id + params, pricing, auth) so you pick the right tool_id → invoke RUNS that tool. KEY: invoke works even when the MCP is NOT installed — it runs the tool pontualmente (one-off), without adding the MCP to the toolkit and without bloating the tool list. If the MCP needs a credential/login, invoke returns a connect link; if it is paid and the wallet is empty, invoke returns a checkout/top-up link (the user opens it, then you retry). Use install only to make an MCP PERMANENT in the active toolkit (its tools then show up natively in future sessions); prefer invoke for a single/occasional use. list_tools lists what is callable right now. subscribe/cancel handle per-MCP billing; report_bug sends feedback; request_mcp asks us to build a NEW MCP when nothing fits. Search/describe flag installed_in_toolkit vs installed_in_workspace. Writes (install/uninstall/subscribe/cancel and the one-off install behind invoke) require workspace owner/admin. It also carries the mcp.ai PROMPT LIBRARY, which is about ready-made prompt TEXT rather than MCPs: search_prompts finds one, get_prompt returns its full text with {{variables}} filled, and publish_prompt saves a prompt and returns a shareable mcp.ai/p/<slug> link that opens without login.

Parameterslimitqueryactionmcp_idmessagetool_idargumentsimmediatetier_slugprompt_bodyprompt_slugprompt_tool+11 more

authenticate

Authenticate

MCP.AI for IDE agents (Cursor, etc.): log in in the browser, copy the access token. Best: add it to this server's config as a header `Authorization: Bearer <token>` for a permanent, non-expiring connection. Or paste it here for a session-only login: call with { token: "<jwt>" } after the user pastes, or with no args to get the link.

Parameterstoken

Version history

1
  1. v0.1.0LatestSep 16, 2026

Score

100% of the applicable checks met

How complete this listing is, computed from the registry entry, the endpoint and public sources. Not a rating of the server and not a statement that it is safe or working today: reachability is a dated check, and no installs or reviews go into the score.

  • Reached in the last 30 daysRequired25 pts
  • Auth declaredRequired10 pts
  • Tools listedRequired15 pts
  • DescriptionRequired15 pts
  • Logo10 pts
  • Documentation15 pts
  • License10 pts