Which integrations are available for this server?

Provides tools for searching and retrieving trending YouTube videos by category, custom queries, video metadata, daily rankings, RSS feeds, and filtering.

How do I use YouTube Trending MCP Server?

1. Click on "Install Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@YouTube Trending MCP Server show me trending music videos in the US" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

YouTube Trending MCP Server

by AIKONG2024

Overview Schema Related Servers Score Discussions

Python

Local

PyPI version Python License: MIT MCP

Collect trending YouTube videos without web scraping! This MCP server provides stable, API-based YouTube data collection using yt-dlp. No web scraping, no API keys required, no quotas!

Features

No Web Scraping - Uses yt-dlp's stable API access
No API Keys - Completely free forever
No Quotas - Unlimited data collection
Category Filtering - Any topic: Music, Gaming, Cooking, Tech, etc.
Daily Rankings - Track trending videos over time
RSS Fallback - Alternative data source
SQLite Storage - Built-in database support

Related MCP server: mcp-youtube

Installation

pip install youtube-trending-mcp

Or install from source:

git clone https://github.com/AIKONG2024/youtube-trending-mcp.git
cd youtube-trending-mcp
pip install -e .

Quick Start

Claude Code

Add to your MCP config:

{
  "mcpServers": {
    "youtube-trending": {
      "command": "python",
      "args": ["-m", "youtube_trending_mcp"],
      "env": {
        "DATA_DIR": "/path/to/data"
      }
    }
  }
}

Cursor

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "youtube-trending": {
      "command": "python",
      "args": ["-m", "youtube_trending_mcp"]
    }
  }
}

OpenAI Codex

{
  "mcpServers": {
    "youtube-trending": {
      "command": "python",
      "args": ["-m", "youtube_trending_mcp"],
      "env": {
        "DATA_DIR": "./data"
      }
    }
  }
}

LLM Tool Reference

Tools Overview

Tool	Description
`search_trending_videos`	Search trending videos by category
`search_custom_videos`	Search any topic with custom query
`get_video_metadata`	Get detailed metadata for a video
`collect_daily_ranking`	Collect and save daily rankings
`get_youtube_rss_feed`	Fetch RSS feed from channel/playlist
`filter_videos`	Filter videos by views, likes, duration

Parameters:
  category: string (default: "all") - "all", "pets", "music", "gaming", "entertainment", or any topic
  max_results: int (default: 20, range: 1-100)
  region: string (default: "US") - Country code

Returns: { success, count, category, videos: [VideoObject] }

search_custom_videos

Parameters:
  query: string (required) - Any search term
  max_results: int (default: 20)
  min_views: int (default: 0) - Filter by minimum views
  sort_by: string (default: "relevance") - "relevance", "views", "date"

Returns: { success, query, count, videos: [VideoObject] }

get_video_metadata

Parameters:
  video_id: string (required) - YouTube video ID (11 chars)

Returns: { success, video: VideoObject }

collect_daily_ranking

Parameters:
  category: string (default: "all")
  max_results: int (default: 50)
  save_to_db: bool (default: true)
  save_to_json: bool (default: true)

Returns: { success, count, output_paths: [...] }

get_youtube_rss_feed

Parameters:
  channel_id: string - Channel ID (starts with "UC...")
  playlist_id: string - Playlist ID
  (At least one required)

Returns: { success, count, feed_type, videos: [VideoObject] }

filter_videos

Parameters:
  videos: array (required) - List of VideoObjects
  min_views: int - Minimum view count
  min_likes: int - Minimum like count
  max_duration: int - Max duration in seconds
  exclude_keywords: array - Keywords to exclude

Returns: { success, original_count, filtered_count, videos: [VideoObject] }

VideoObject Schema

{
  "video_id": "dQw4w9WgXcQ",
  "title": "Video Title",
  "channel": "Channel Name",
  "channel_id": "UCuAXFkgsw1L7xaCfnd5JJOw",
  "views": 1500000000,
  "likes": 16000000,
  "upload_date": "20091025",
  "duration": 212,
  "description": "Description (max 1000 chars)",
  "categories": ["Music"],
  "tags": ["tag1", "tag2"],
  "thumbnail": "https://i.ytimg.com/vi/.../maxresdefault.jpg",
  "url": "https://www.youtube.com/watch?v=dQw4w9WgXcQ"
}

Common Workflows

# Find popular videos on any topic
search_custom_videos(query="machine learning", max_results=30, sort_by="views")

# Get trending by category
search_trending_videos(category="gaming", max_results=50, region="KR")

# Filter results
videos = search_custom_videos(query="cooking", max_results=100)
filter_videos(videos=videos, min_views=50000, max_duration=600)

# Save daily rankings
collect_daily_ranking(category="music", max_results=100)

Notes

Video IDs: 11 characters (e.g., dQw4w9WgXcQ)
Channel IDs: Start with UC + 22 characters
Duration: In seconds
Upload date: YYYYMMDD format

Why yt-dlp Instead of Web Scraping?

Web Scraping	yt-dlp Approach
Requires Playwright (heavy)	No browser needed
Breaks with site changes	Stable internal APIs
Anti-bot protection issues	Community maintained (143k+ stars)
Legal concerns (ToS)	Weekly updates
High maintenance	Reliable & fast

Development

git clone https://github.com/AIKONG2024/youtube-trending-mcp.git
cd youtube-trending-mcp
pip install -e ".[dev]"
pytest tests/ -v

yt-dlp-mcp - Download videos and transcripts via MCP

License

MIT License - see LICENSE file for details.

Made with love by AIKONG2024

This server cannot be installed

license - permissive license

quality - not tested

maintenance

How are these scores calculated?

Maintenance

–Maintainers

–Response time

–Release cycle

–Releases (12mo)

Commit activity

Resources

GitHub Repository

Need Help?

Related Servers

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

yt-fetch
Entertainment & Media Search
smith-nathanh
F
license
-
quality
D
maintenance
An MCP server that enables interaction with the YouTube Data API, allowing users to search videos, get video and channel details, analyze trends, and fetch video transcripts.
Updated a year ago (2025-07-27 15:40 UTC)
mcp-youtube
RAG Systems Search Entertainment & Media
kirbah
A
license
A
quality
A
maintenance
High-efficiency YouTube MCP server: Get token-optimized, structured data for your LLMs using the YouTube Data API v3.
Updated 4 days ago (2026-08-12 20:17 UTC)
9
351
28
MIT
YouTube MCP Server
Entertainment & Media Search
iceener
A
license
-
quality
C
maintenance
Streamable HTTP MCP server for YouTube that enables video search, channel exploration, playlist browsing, and video detail retrieval via the YouTube Data API.
Updated 21 days ago (2026-07-27 13:22 UTC)
16
6
MIT
youtube-mcp
Entertainment & Media Search
PPiai
F
license
B
quality
C
maintenance
MCP server for YouTube Data API v3 enabling video search, channel lookup, trending content, comments, and playlist management.
Updated 2 months ago (2026-06-13 06:26 UTC)
11

View all related MCP servers

Related MCP Connectors

Youtube
YouTube MCP — wraps the YouTube Data API v3 (BYO API key)
Trends API
Trend data from Google, TikTok, Amazon, Reddit, YouTube, Steam, npm and more as JSON
youtube-transcripts
YouTube transcripts, subtitles, and video metadata as structured JSON via an Apify Actor.

View all MCP Connectors

Latest Blog Posts

Who's Calling? MCP Hosts Are an Identity Blind Spot (And the Spec Knows It)
By Om-Shree-0709 on July 25, 2026.
mcp
Agent Identity
OAuth 2.1
Your AI Chatbot Just Exposed Your CEO's Salary to an Intern
By Om-Shree-0709 on July 2, 2026.
Agent Identity
MCP Security
OAuth Delegation
Why MCP Servers Need Execution Sandboxing (And Why Your Current Stack Isn't Enough)
By Om-Shree-0709 on June 30, 2026.
Agentic Ai
Prompt Injection
WebAssembly

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/AIKONG2024/youtube-trending-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server