YouTube Tools

YouTube video search, channel discovery, ranking tracking, and trending content

Overview

YouTube Tools is a production-ready Model Context Protocol (MCP) server built to give AI agents reliable, structured access to youtube tools capabilities.

It acts as a standardized bridge between large language models and real-time data. Instead of relying on static training knowledge, models can retrieve live results, web content, and intelligence through a controlled MCP interface.

By integrating this MCP server, developers enable models such as Claude, GPT-4, Gemini, and open-source LLMs to:

• Execute structured YouTube Tools queries • Access live data in real time • Retrieve specialized information programmatically • Ground responses in verifiable external sources

This architecture significantly improves factual accuracy, reduces hallucination risk, and expands what AI systems can accomplish in research, automation, monitoring, and decision-support workflows.

YouTube Tools is designed for teams building production AI agents that require dependable, real-time access to the youtube within a standardized MCP ecosystem.

Highlights

Protocol
MCP v1.0
Security
OAuth 2.0
Access
Real-time
Tools
11 Tools

Standardized bridge for real-time model context.

Installation

Connect this server to your local or remote agent environment.

mcp_config.json
{
  "mcpServers": {
    "mcp360": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "https://connect.mcp360.ai/v1/youtube/mcp?token=YOUR_API_KEY"
      ]
    }
  }
}
Replace YOUR_API_KEY with your actual key from the dashboard.

Skills & Capabilities

What this MCP server can do for your AI agents.

CAPABILITIES
--- name: youtube description: Search YouTube videos, channels, and shorts with advanced filters, track video rankings, get detailed video information with transcripts and comments, analyze channel performance, and discover trending content. Use when users need to find videos, research content creators, track video positions for SEO, analyze engagement metrics, or discover trending topics. metadata: author: MCP360 version: "1.0.0" tags: - Video Platform - Content Discovery - YouTube - Video Search - Channel Analytics - Trending Content - Video SEO - Social Media keywords: - youtube - video - videos - channel - channels - trending - shorts - content - creator - vlog - tutorial - entertainment - search videos - video search - youtube search - ranking - position tracking creditsPerUse: 1 isPremium: false --- # YouTube Tools Comprehensive YouTube API for video discovery, channel research, content analytics, and ranking intelligence. Access YouTube's vast video library with advanced search filters, get detailed video metadata including transcripts and comments, track video rankings, and analyze trending content across regions. ## Core Capabilities - **Video Search**: Find videos with filters for region, language, and advanced parameters, and returns video listings with titles, thumbnails, view counts, upload dates, channel information, and engagement metrics - **Channel Search**: Discover YouTube channels by keywords and topics, and returns channel profiles with subscriber counts, video counts, descriptions, and verification status for influencer research - **Shorts Search**: Find trending YouTube Shorts and vertical videos, and returns short-form content with view counts, engagement rates, and viral metrics for content strategy - **Video Details**: Get comprehensive video information including description, tags, and statistics, and returns full metadata with duration, category, license, upload date, and performance analytics - **Video Transcripts**: Extract complete video transcripts and captions in multiple languages, and returns timestamped text content for accessibility, content analysis, and SEO optimization - **Video Comments**: Retrieve top comments and community engagement data, and returns comment threads with like counts, reply counts, and sentiment indicators for audience insights - **Channel Details**: Access complete channel information and statistics, and returns subscriber growth, total views, video count, channel description, and social links - **Channel Videos**: List all videos from a specific channel with sorting options, and returns video catalog with upload schedule, performance metrics, and content patterns - **Trending Videos**: Discover currently trending videos by region and category, and returns viral content with trending scores, view velocity, and popularity indicators - **Video Position Tracking**: Monitor where videos rank for specific search keywords, and returns exact positions, visibility metrics, and ranking changes for YouTube SEO - **Bulk Position Tracking**: Track multiple videos across various keywords simultaneously, and returns comprehensive ranking data with competitive analysis and trend identification ## API Access ### MCP360 Connect Endpoints - **Base URL**: `https://connect.mcp360.ai/api/v1` - **Service Path**: `youtube` - **Authentication**: Bearer token (API key required) ### Service Metadata Endpoint Retrieve service information and available tools: ```bash curl "https://connect.mcp360.ai/api/v1/youtube" \ -H "Authorization: Bearer YOUR_API_KEY" ``` ### Tool Execution Endpoint Execute specific tools by making POST requests: ```bash curl -X POST "https://connect.mcp360.ai/api/v1/youtube/{tool_name}" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{...parameters...}' ``` ## Available Tools ### Search Videos Find YouTube videos using keywords with regional and language filters for localized content discovery. **Tool Name:** `search_videos` **Credits Required:** 1 **Parameters:** - `query` (string, required): Search terms like "python tutorial", "cooking recipes", or "product review" - `country` (string, optional): Country code for regional results like "us", "uk", "jp", "de" - `language` (string, optional): Language code for interface like "en", "es", "fr", "ja" - `sp` (string, optional): Special YouTube filter parameter for advanced filtering (duration, upload date, quality) **Example:** ```bash curl -X POST "https://connect.mcp360.ai/api/v1/youtube/search_videos" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "machine learning tutorial 2024", "country": "us", "language": "en" }' ``` ### Search Channels Discover YouTube channels by topic, niche, or creator name for influencer outreach and competitor research. **Tool Name:** `search_channels` **Credits Required:** 1 **Parameters:** - `query` (string, required): Channel search terms like "tech reviews", "fitness coach", or specific channel name - `country` (string, optional): Country code for regional channels like "us", "uk", "ca" - `language` (string, optional): Language preference like "en", "es", "pt" - `sp` (string, optional): Advanced filter parameter for channel sorting **Example:** ```bash curl -X POST "https://connect.mcp360.ai/api/v1/youtube/search_channels" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "gaming channels", "country": "us", "language": "en" }' ``` ### Search Shorts Find YouTube Shorts and vertical video content for trend analysis and short-form content research. **Tool Name:** `search_shorts` **Credits Required:** 1 **Parameters:** - `query` (string, required): Shorts search query like "quick recipes", "life hacks", or trending topics - `country` (string, optional): Region code like "us", "uk", "in" - `language` (string, optional): Language code like "en", "hi", "es" - `sp` (string, optional): Filter parameter for shorts-specific sorting **Example:** ```bash curl -X POST "https://connect.mcp360.ai/api/v1/youtube/search_shorts" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "query": "fitness tips", "country": "us" }' ``` ### Get Video Details Retrieve comprehensive metadata for a specific video including description, tags, statistics, and performance metrics. **Tool Name:** `get_video_details` **Credits Required:** 1 **Parameters:** - `video_id` (string, required): YouTube video ID like "dQw4w9WgXcQ" from URL youtube.com/watch?v=VIDEO_ID - `country` (string, optional): Country code for regional view counts like "us", "uk" **Example:** ```bash curl -X POST "https://connect.mcp360.ai/api/v1/youtube/get_video_details" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "video_id": "dQw4w9WgXcQ", "country": "us" }' ``` ### Get Video Transcripts Extract video transcripts and closed captions for content analysis, SEO, and accessibility. **Tool Name:** `get_video_transcripts` **Credits Required:** 1 **Parameters:** - `video_id` (string, required): YouTube video ID like "dQw4w9WgXcQ" - `language` (string, optional): Preferred transcript language code like "en", "es", "fr" (Default: auto-detect) **Example:** ```bash curl -X POST "https://connect.mcp360.ai/api/v1/youtube/get_video_transcripts" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "video_id": "dQw4w9WgXcQ", "language": "en" }' ``` ### Get Video Comments Retrieve top comments and engagement data from video comment sections for sentiment analysis. **Tool Name:** `get_video_comments` **Credits Required:** 1 **Parameters:** - `video_id` (string, required): YouTube video ID like "dQw4w9WgXcQ" - `sort_by` (string, optional): Sort order - "top" for most liked, "new" for most recent (Default: "top") - `max_results` (number, optional): Number of comments to retrieve from 1 to 100 (Default: 20) **Example:** ```bash curl -X POST "https://connect.mcp360.ai/api/v1/youtube/get_video_comments" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "video_id": "dQw4w9WgXcQ", "sort_by": "top", "max_results": 50 }' ``` ### Get Channel Details Access complete channel information including statistics, description, and social media links. **Tool Name:** `get_channel_details` **Credits Required:** 1 **Parameters:** - `channel_id` (string, required): YouTube channel ID like "UCuAXFkgsw1L7xaCfnd5JJOw" or channel username **Example:** ```bash curl -X POST "https://connect.mcp360.ai/api/v1/youtube/get_channel_details" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw" }' ``` ### Get Channel Videos List all videos from a specific channel with sorting and filtering options. **Tool Name:** `get_channel_videos` **Credits Required:** 1 **Parameters:** - `channel_id` (string, required): YouTube channel ID or username - `sort_by` (string, optional): Sort order - "date", "popular", "rating" (Default: "date") - `max_results` (number, optional): Number of videos to retrieve from 1 to 50 (Default: 30) **Example:** ```bash curl -X POST "https://connect.mcp360.ai/api/v1/youtube/get_channel_videos" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw", "sort_by": "popular", "max_results": 30 }' ``` ### Get YouTube Trends Discover currently trending videos by region and category for content strategy and trend analysis. **Tool Name:** `get_youtube_trends` **Credits Required:** 1 **Parameters:** - `country` (string, optional): Country code for regional trends like "us", "uk", "jp" (Default: "us") - `category` (string, optional): Video category like "Gaming", "Music", "Technology", "Entertainment" **Example:** ```bash curl -X POST "https://connect.mcp360.ai/api/v1/youtube/get_youtube_trends" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "country": "us", "category": "Technology" }' ``` ### Find Video Position Track where a specific video ranks in YouTube search results for targeted keywords. **Tool Name:** `find_video_position` **Credits Required:** 1 **Parameters:** - `keyword` (string, required): Search query to check video ranking for like "python tutorial" or "best gaming laptop 2024" - `video_url` (string, required): YouTube video URL like "https://youtube.com/watch?v=VIDEO_ID" or just video ID - `country` (string, optional): Country code for regional rankings like "us", "uk" (Default: "us") **Example:** ```bash curl -X POST "https://connect.mcp360.ai/api/v1/youtube/find_video_position" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "keyword": "react tutorial for beginners", "video_url": "https://youtube.com/watch?v=dQw4w9WgXcQ", "country": "us" }' ``` ### Bulk Find Video Position Track multiple keywords for a single video in one request for comprehensive YouTube SEO analysis. **Tool Name:** `bulk_find_video_position` **Credits Required:** 5 **Parameters:** - `keywords` (array of string, required): Array of search queries to check rankings for, maximum 10 keywords like ["react tutorial", "javascript course"] - `video_url` (string, required): YouTube video URL or video ID - `country` (string, optional): Country code for regional tracking like "us", "uk" (Default: "us") **Example:** ```bash curl -X POST "https://connect.mcp360.ai/api/v1/youtube/bulk_find_video_position" \ -H "Authorization: Bearer YOUR_API_KEY" \ -H "Content-Type: application/json" \ -d '{ "keywords": [ "web development tutorial", "learn web development", "full stack course", "coding for beginners" ], "video_url": "dQw4w9WgXcQ", "country": "us" }' ``` ## Authentication All API requests require a Bearer token for authentication: ```bash -H "Authorization: Bearer YOUR_API_KEY" ``` ## Rate Limiting - Standard tools (search, details, comments, transcripts, channel info, trends): 1 credit per request - Bulk position tracking (bulk_find_video_position): 5 credits per request - Rate limit: 1000 requests per hour - Concurrent requests: Up to 10 parallel calls ## Support - **Blog & Tutorials**: https://mcp360.ai/blog - **Contact**: https://mcp360.ai/contact
These capabilities are available through the MCP protocol interface.

Available Tools

Technical specifications for the 11 available protocol tools.

11 tools

bulk_find_video_position tool

Input Specification
{
  "type": "object",
  "required": [
    "keywords",
    "video_url"
  ],
  "properties": {
    "country": {
      "type": "string",
      "description": "Country code for localized results (e.g., 'us', 'uk')"
    },
    "keywords": {
      "type": "array",
      "items": {
        "type": "string"
      },
      "maxItems": 10,
      "minItems": 1,
      "description": "Array of keywords or phrases to check your video's position for (max 10 keywords, e.g., ['how to bake', 'baking tutorial'])"
    },
    "language": {
      "type": "string",
      "description": "Language code (e.g., 'en', 'es')"
    },
    "video_url": {
      "type": "string",
      "description": "Your YouTube video URL (e.g., 'https://youtube.com/watch?v=VIDEO_ID' or just 'VIDEO_ID')"
    }
  },
  "additionalProperties": false
}
Output Response
{
  "type": "object",
  "properties": {
    "results": {
      "type": "array",
      "items": {
        "type": "object",
        "properties": {
          "keyword": {
            "type": "string"
          },
          "video_id": {
            "type": "string"
          },
          "occurrences": {
            "type": "number"
          },
          "top_position": {
            "type": "number"
          },
          "all_positions": {
            "type": "array",
            "items": {
              "type": "number"
            }
          },
          "top_10_videos": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "link": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "views": {
                  "type": "number"
                },
                "channel": {
                  "type": "object",
                  "properties": {
                    "id": {
                      "type": "string"
                    },
                    "link": {
                      "type": "string"
                    },
                    "title": {
                      "type": "string"
                    },
                    "thumbnail": {
                      "type": "string"
                    },
                    "is_verified": {
                      "type": "boolean"
                    }
                  }
                },
                "position": {
                  "type": "number"
                },
                "video_id": {
                  "type": "string"
                }
              }
            }
          },
          "video_results": {
            "type": "array",
            "items": {
              "type": "object",
              "properties": {
                "link": {
                  "type": "string"
                },
                "title": {
                  "type": "string"
                },
                "position": {
                  "type": "number"
                },
                "thumbnail": {
                  "type": "string"
                }
              }
            }
          }
        }
      }
    },
    "summary": {
      "type": "object",
      "properties": {
        "failed": {
          "type": "number"
        },
        "ranked": {
          "type": "number"
        },
        "country": {
          "type": "string"
        },
        "language": {
          "type": "string"
        },
        "video_id": {
          "type": "string"
        },
        "not_ranked": {
          "type": "number"
        },
        "successful": {
          "type": "number"
        },
        "total_keywords": {
          "type": "number"
        },
        "average_position": {
          "type": "number"
        }
      }
    }
  }
}

Direct API Access

Production-ready REST endpoints for custom integrations.

POSTServer Metadata
/api/v1/youtube
curl "https://connect.mcp360.ai/api/v1/youtube" \
  -H "Authorization: Bearer YOUR_API_KEY"
POSTExecute Tool
/api/v1/youtube/{tool_name}
curl -X POST "https://connect.mcp360.ai/api/v1/youtube/bulk_find_video_position" \
  -H "Authorization: Bearer YOUR_API_KEY" \
  -H "Content-Type: application/json" \
  -d '{
  "keywords": [
    "string"
  ],
  "video_url": "string"
}'
Authentication

To authenticate, include your API key in the Authorization header using the Bearer scheme. Alternatively, you can use the X-API-KEY header.

Infrastructure

Unified MCP Gateway

One hub for 100+ production-ready tools with centralized management.

Unified API Key

Access 100+ MCP servers with a single authentication token.

Instant Testing

Test and debug any MCP server instantly in our integrated environment.

Centralized Billing

One monthly subscription for all your AI tool integrations and credits.

Scenarios

Standard Use Cases

Automated research and data gathering
Real-time monitoring and alerting systems
Content generation with current information
Competitive analysis and market intelligence
Decision support with live data feeds
API integration for AI applications

Frequently Asked Questions

What is YouTube Tools?

YouTube Tools is an MCP server that provides structured access to youtube tools capabilities through a standardized protocol, enabling AI models to retrieve and process real-time data.

Which AI models are supported?

Any model that supports MCP protocol including Claude (via Claude Desktop), GPT-4, Gemini, and open-source LLMs through compatible frameworks.

How do I authenticate?

The server supports OAuth 2.0 authentication with API keys. You'll receive credentials upon registration which can be configured in your MCP client.

Is there rate limiting?

Yes, rate limits apply based on your subscription tier. Free tier includes generous limits for development, with higher limits available in paid plans.

Can I use this in production?

Absolutely. YouTube Tools is designed for production use with enterprise-grade reliability, security, and performance.

Deploy AI agent with YouTube Tools today.

Start building production-ready AI agent integrations in minutes with standardized protocol access.

Enterprise Ready
Secure OAuth
24/7 Support