# YouTube MCP MCP > YouTube MCP connects your AI agent directly to YouTube's full data API, letting you search for videos and retrieve deep analytics instantly. Find specific video metadata, pull channel performance stats, or analyze user comments from any content—all through natural conversation. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** video-hosting, content-metadata, channel-analytics, video-search, audience-engagement, media-intelligence ## Description Need to know what’s working on YouTube without manually clicking every dashboard? This connector gives your AI agent the ability to function as a dedicated video analyst. You can search for videos by keyword and get lists of metadata, then deep-dive into specific pieces of content to pull view counts, like totals, and upload dates. Want to see how popular a channel is? Get full branding stats, including subscriber volume and total video count. The tool also pulls the most relevant comments from any video, letting you analyze user sentiment quickly. If your workflow requires combining this video intelligence with other platforms—say, running YouTube analytics alongside data stored in a CRM—you can build those automations across multiple services using Vinkius. This means you connect your AI client once and manage complex workflows spanning different applications, all while Vinkius handles the security and stability. ## Tools ### get_channel Retrieves full statistics and brand details for an entire YouTube channel. ### get_video Gets the complete metadata, description, and performance metrics for one specific video. ### list_comments Fetches the most relevant comments from a given YouTube video ID to gauge audience feedback. ### search_videos Returns a list of videos found by keyword or precise phrase, including titles and descriptions. ## Prompt Examples **Prompt:** ``` Search YouTube for 'generative AI tutorials' and show me the top 5 results. ``` **Response:** ``` I found the top 5 videos for 'generative AI tutorials'. Highlights include: 1. 'GenAI for Beginners' (ID: abc-123), 2. 'Advanced LLM Prompting' (ID: def-456), and 3. 'Building with Stable Diffusion' (ID: ghi-789). Which one would you like the full details for? ``` **Prompt:** ``` What are the statistics for video ID 'dQw4w9WgXcQ'? ``` **Response:** ``` Video 'Never Gonna Give You Up' (ID: dQw4w9WgXcQ) has 1.5 billion views, 17 million likes, and approximately 2.1 million comments. It was uploaded on Oct 25, 2009. Would you like me to list the latest comments? ``` **Prompt:** ``` Check the subscriber count for channel ID 'UC_x5XG1OV2P6uYZ5M1D2ogw'. ``` **Response:** ``` The channel 'Google for Developers' (ID: UC_...) currently has 2.45 million subscribers and a total of 1,250 videos. The total view count across all videos is approximately 450 million. ``` ## Capabilities ### Search for videos Find video listings based on keywords or exact phrases. ### Analyze channel health Retrieve complete statistics, including subscriber counts and total content volume, for any YouTube account. ### Pull specific video stats Get detailed technical data like view counts, likes, and descriptions for a single video ID. ### Gauge community feedback Fetch the most relevant comments from a video to analyze user sentiment or common topics. ### Monitor content patterns Examine titles, descriptions, and statistics across multiple videos to spot trends. ## Use Cases ### Competitor Deep Dive A marketer needs to know how often their top three competitors publish content and what kind of engagement they get. They ask the agent to `get_channel` for all three, then use `search_videos` to list recent titles, giving them a quick performance snapshot. ### Campaign Feedback Loop A content creator releases a video and needs to know if people are reacting negatively to a specific topic. They ask the agent to run `get_video` for stats, followed by `list_comments` to see immediate user sentiment. ### Topic Trend Spotting A research team wants to know what kind of videos are getting traction in a niche area. They use the agent to run `search_videos` for 'sustainable farming' and analyze the resulting titles and descriptions. ### Quarterly Performance Review A data scientist needs comprehensive stats on their own channel's growth. They ask the agent to `get_channel` to get subscriber counts, then follow up with `get_video` for a specific milestone video. ## Benefits - Stop guessing about content success. You can use `get_video` to pull exact view counts, like totals, and upload timestamps for any piece of media. - Gauge public opinion immediately. Use `list_comments` to surface the top comments from a video, letting you analyze sentiment without reading hundreds of replies. - Quickly audit brand reach. The `get_channel` tool gives total subscriber counts and overall channel volume in one request. - Spot market gaps fast. By using `search_videos`, your agent returns metadata for multiple videos, helping you identify popular topics or trending formats. - Avoid building custom scrapers. Instead of writing brittle code to pull this data, the MCP handles all the API calls and structure cleanup. ## How It Works The bottom line is: you talk to your agent like talking to a human analyst; it handles all the API calls and spits out structured data. 1. Subscribe to the MCP and input your YouTube Data API Key. 2. Connect this MCP within your preferred AI client (Claude, Cursor, etc.). 3. Prompt your agent with a natural language request—like 'Search for tutorials on generative AI'—and it performs the data retrieval. ## Frequently Asked Questions **How do I check channel statistics using the `get_channel` tool?** You just ask your agent to run `get_channel` and provide the channel ID. The response will give you the current subscriber count, total video volume, and branding info. **Can I find videos by keyword using `search_videos`?** Yes. Give your agent a phrase like 'best practices for cloud computing' and it returns a list of metadata, including titles and descriptions for top results. **Does the `list_comments` tool only show recent comments?** No. The tool fetches the most relevant comment threads, giving you a high-signal summary of community feedback that helps analyze overall sentiment. **What if I need stats for multiple videos? Should I run `get_video` repeatedly?** You can pass a list of video IDs to the agent and ask it to aggregate the results using `get_video`. It manages the calls, giving you a consolidated report. **When I use the `get_video` tool, how is my API key handled for security?** Your keys pass through a zero-trust proxy; they are never stored on disk. Vinkius uses these credentials only when running the call in transit, ensuring your private data stays secure throughout the process. **Are there rate limits if I run many searches using `search_videos`?** Yes, all API calls are subject to external platform rate limits. We recommend checking the YouTube Data API documentation for specific quotas and planning your workflow accordingly to avoid hitting those caps. **Does the `get_video` tool provide every single piece of metadata available on a video?** It provides all core technical metrics, including full descriptions, view counts, like totals, and upload timestamps. We structure the data to give you robust insights without needing to build custom scrapers. **Can I combine `get_channel` results with videos found via `search_videos` in one automation?** Absolutely. The power is combining tools. You can chain the output from your search query directly into a channel audit, letting your agent analyze both simultaneously. **Can I see how many likes and views a video has through the agent?** Yes. The `get_video_details` tool allows your AI agent to retrieve full real-time statistics for any YouTube video ID, including view counts, like counts, and the total number of comments. **How do I find out the subscriber count for a specific channel?** You can use the `get_channel_details` tool. Provide the unique channel ID, and your agent will return the channel's performance statistics, including subscriber counts, total views, and video counts. **Is it possible to read the comments on a video via chat?** Absolutely. Use the `list_video_comments` tool to retrieve the top most relevant or recent comment threads from any video ID, helping you perform rapid sentiment analysis through conversation.