TubeGrade
Server Details
YouTube research for AI assistants: channel and video stats, transcripts and comments, outlier videos that beat their channel's average, viral title formats, keyword ideas, similar thumbnails and channels, YouTube rankings and competitor tracking.
- Status
- Healthy
- Uptime
- 100.0% over the last 24 hours
- OAuth
- Works in Glama
- Last Tested
- Transport
- Streamable HTTP · MCP 2025-11-25
- URL
- ChatGPT
- –
- Claude
- TubeGrade
TDQS
Scored across 23 tools
Most tools target clearly distinct resources and actions, but there is some overlap among video-search tools such as find_outliers versus search_videos, and thumbnail retrieval is split across thumbnails, channel_thumbnails, and find_similar_thumbnails. Descriptions help resolve these, but an agent still has to parse when to use each.
All names use consistent snake_case with the tubegrade_ prefix, which is predictable. However, the set mixes verb-led names like get_video and search_videos with noun-only names like rankings, viral_formats, and similar_channels, so it is not a uniform verb_noun pattern.
23 tools is heavy for the suite's scope; several families could be consolidated, such as the channel-level versus video-level thumbnail and transcript tools. While each tool has a distinct role, the count is borderline high and increases selection burden.
The surface covers a broad range of YouTube research and account workflows: channel and video stats, transcripts, thumbnails, comments, outliers, rankings, keywords, competitors, and bookmarks. Minor gaps exist, such as no direct keyword channel search or comment-reply retrieval, but core workflows are well covered.
Publisher details
- Operator
- TubeGrade (Vidgrade Media Private Limited) · Publisher source
- Operator website
- https://www.tubegrade.com/ · Publisher source
- Vendor relationship
- First-party · Publisher source
- Documentation
- https://www.tubegrade.com/mcp/ · Publisher source
- Privacy policy
- Not provided
- Trust center
- Not available
- Restrictions
- Requires a TubeGrade account (free sign-in with Google via OAuth). Tools use credits per call: the Free plan includes 100 credits one-time; Pro ($15/month) includes 500 credits every month. · Publisher source
Available Tools
23 toolstubegrade_balanceCredit BalanceARead-onlyIdempotentInspect
The user's current TubeGrade credit balance. Checking it is free and deducts nothing.
Use when the user asks how many credits they have, or before a large paid request.
Cost: 0 credits (free).
Inputs: no named parameters. Returns: object
tubegrade_bookmarkBookmarkADestructiveIdempotentInspect
Save a YouTube video to one of the user's TubeGrade bookmark folders, or remove it: the same saved videos the user sees in the TubeGrade app. Saving a video twice, or removing one that isn't saved, changes nothing. Creating a folder past the account's folder limit returns an error naming the limit.
Use only when the user asks to save, bookmark, or remove a video.
Cost: 0 credits (free).
Inputs: action (required), video, folder. Returns: object
tubegrade_channel_thumbnailsChannel ThumbnailsARead-onlyIdempotentInspect
The actual thumbnail images for one channel's videos (latest, popular or Shorts, up to 30), each preceded by its video id, title and image URL. Default size 480×360; 1280×720 is available. A thumbnail that can't be fetched is noted inline.
Use when the user wants to study a channel's thumbnail style. Accepts a channel id (UC…), an @handle, or a channel URL.
COST: 1 credit PER thumbnail returned.
Inputs: channel_id (required), limit, source, resolution.
tubegrade_channel_transcriptsChannel TranscriptsARead-onlyIdempotentInspect
Full transcripts for many of one channel's videos at once (its latest
or most popular, up to 50), as [MM:SS] text with each video's title.
Videos without captions come back with an error field instead of
failing the request.
Use when the user wants to study a creator's scripts, hooks or talking points across several videos. Accepts a channel id (UC…), an @handle, or a channel URL.
COST: 10 credits PER VIDEO returned, billed on the videos actually found (for example, 50 videos = 500 credits).
Inputs: channel_id (required), limit, source. Returns: object
tubegrade_channel_videosChannel VideosARead-onlyIdempotentInspect
A channel's videos from its latest, most-popular or Shorts tab (up to 100), each with title, views, duration and publish time.
Use when the user wants to see what a channel has been uploading or its most-viewed videos. Accepts a channel id (UC…), an @handle, or a channel URL.
Cost: 3 credits per call.
Inputs: channel_id (required), limit, source. Returns: object
tubegrade_expand_keywordsKeyword IdeasARead-onlyIdempotentInspect
YouTube autocomplete suggestions for a seed phrase, in the order YouTube ranks them. Phrases only: no search volume, competition or difficulty data.
Use when the user wants related search phrases or title wording around a topic.
Cost: 1 credit per call.
Inputs: query (required). Returns: object
tubegrade_find_outliersFind OutliersARead-onlyIdempotentInspect
Breakout videos about a topic: a semantic search over TubeGrade's
corpus of videos that beat their own channel's normal views. Each
result has views, publish date, outlier_ratio (times over the
channel's baseline) and a topical relevance score (0–1). Optional
filters: minimum ratio, minimum views, and published within the last N
days. The corpus covers tens of thousands of breakout videos, not all
of YouTube.
Use when the user asks what is going viral or breaking out on a topic, or wants proven ideas to model.
Cost: 10 credits per call.
Inputs: query (required), days, limit, min_ratio, +1 more. Returns: object
tubegrade_find_similar_thumbnailsSimilar ThumbnailsARead-onlyIdempotentInspect
Videos whose thumbnails look and read like a given video's, ranked by
a blend of visual similarity (60%) and title similarity (40%). Each
result includes views, an outlier score, the channel's subscribers and
its average views. A video TubeGrade hasn't analysed before takes a
few extra seconds; when the analysis isn't ready yet the response has
status: "indexing", and the same request succeeds about 15 seconds
later. Nothing in the user's account or on YouTube changes.
Use when the user wants videos packaged like a reference video, or the thumbnail and hook patterns around it. Accepts an 11-character video id or a YouTube URL.
Cost: 20 credits per call.
Inputs: video_id (required), limit. Returns: object
tubegrade_get_channelChannel StatsARead-onlyIdempotentInspect
Stats for one YouTube channel: subscribers, total views and videos,
average views per recent upload, upload frequency, average video
length, country and description. When TubeGrade has tracked the
channel, the response also includes a growth block with subscriber,
view and video counts over recent months; gained is the change per
period, and where readings are several periods apart it is the per-
period average.
Use when the user asks how big a channel is, how it is growing, or what its typical video gets. Accepts a channel id (UC…), an @handle, or a channel URL. Public data only: no private YouTube Analytics (watch time, retention, CTR, traffic sources, revenue).
Cost: 5 credits per call.
Inputs: channel_id (required). Returns: object
tubegrade_get_channel_outliersBreakout VideosARead-onlyIdempotentInspect
One channel's breakout videos: uploads that beat that channel's own typical views, sorted by outlier ratio, each with views, likes, comments and publish date. Empty when the channel has no flagged outliers.
Use when the user asks what worked best for a specific channel. Accepts a channel id (UC…), an @handle, or a channel URL.
Cost: 10 credits per call.
Inputs: channel_id (required), limit. Returns: object
tubegrade_get_commentsGet CommentsARead-onlyIdempotentInspect
Top-level comments on a YouTube video (most relevant or newest first, up to 100): the commenter's display name, the text, like count, reply count and relative date. Replies are not included; the list is empty when comments are disabled.
Use when the user wants audience reactions, questions or requests about a video. Accepts an 11-character video id or a YouTube URL.
Cost: 5 credits per call.
Inputs: video_id (required), sort, limit. Returns: object
tubegrade_get_transcriptGet TranscriptARead-onlyIdempotentInspect
The full transcript (captions) of one YouTube video as text, one
[MM:SS] timestamped line per caption cue. Returns an error when the
video has no captions.
Use when the user wants to read, summarize or quote what a video says, or study its hook and structure. Accepts an 11-character video id or a YouTube URL.
Cost: 10 credits per call.
Inputs: video_id (required). Returns: object
tubegrade_get_videoVideo StatsARead-onlyIdempotentInspect
Stats for one YouTube video: title, channel, views, likes, comment
count, duration, publish date, tags and category. When TubeGrade has
history for the video, the response also includes a growth block
with views, likes and comments over recent months; many videos have
none yet.
Use when the user asks about a specific video's performance. Accepts an 11-character video id or a YouTube URL. Public data only: no watch time, retention, CTR or traffic sources.
Cost: 5 credits per call.
Inputs: video_id (required). Returns: object
tubegrade_list_bookmarksSaved VideosARead-onlyIdempotentInspect
The user's saved YouTube videos in TubeGrade (one folder or all folders, newest first, each with its folder and save date), or their bookmark folders with how many videos each holds. Read-only.
Use when the user asks what they have saved or which folders they have.
Cost: 0 credits (free).
Inputs: show, folder. Returns: object
tubegrade_my_competitorsMy CompetitorsARead-onlyIdempotentInspect
The competitor channels the user tracks in TubeGrade, each with subscribers, average views, and subscriber and view changes over 7 and 30 days. Empty when they track none.
Use when the user asks how their tracked competitors are doing.
Cost: 2 credits per call.
Inputs: no named parameters. Returns: object
tubegrade_rankingsYouTube RankingsARead-onlyIdempotentInspect
TubeGrade's weekly YouTube channel rankings: fastest-growing (most
subscribers gained in 30 days, channels with 100K+), breakout (biggest
% growth from a 50K–2M start) or most-subscribed, worldwide or for one
country. Each entry has its rank, last week's rank (previous_rank,
null when new), subscribers, the 30-day gain rounded to YouTube's
published precision (gained_30d_text), growth % and a link. Rankings
cover the channels TubeGrade tracks (tracked_channels says how
many), not all of YouTube, and are not filtered by topic. A country
without a list returns an error naming the available regions.
Use when the user asks about the fastest-growing, breakout or biggest YouTube channels.
Cost: 1 credit per call.
Inputs: limit, region, list_type. Returns: object
tubegrade_search_videosSearchARead-onlyIdempotentInspect
Live keyword search across YouTube, with filters for long-form or
Shorts, upload window and duration. Returns up to limit videos with
views, duration, publish time and channel, plus the channel's
subscriber count (subscriberCount, and YouTube-style
subscriberCountText such as '4.24M'), its average views per video
(channelAvgViews), upload frequency, and outlierRatio: the video's
views divided by that channel's average, so 5.0 means five times its
normal views. Channel fields are omitted for the occasional channel
that can't be resolved.
Use when the user wants videos on a topic or a scan of what is being published in a niche. Results include all matching videos, not only breakouts.
Cost: 5 credits per call.
Inputs: query (required), limit, video_type, upload_date, +1 more. Returns: object
tubegrade_similar_channelsSimilar ChannelsARead-onlyIdempotentInspect
Channels that cover the same topic as a given channel and are a
similar size (0.3x–3x its subscribers), matched by TubeGrade's topic
fingerprints of each channel's name, description and tags, gently
favouring the same category and country. Only close matches are
returned, so broad or unusual channels can get few or none. Each
result has a tubegrade_url with the channel's public stats page.
Works on channels TubeGrade has fingerprinted (rebuilt weekly); for
others the request returns an error without charging.
Use when the user asks who their competitors are or for channels like a given one. Accepts a channel id (UC…), an @handle, or a channel URL.
Cost: 5 credits per call.
Inputs: channel_id (required), limit. Returns: object
tubegrade_suggested_videosSuggested VideosARead-onlyIdempotentInspect
The videos YouTube itself suggests next to a given video (its "Up
next" rail), with views, publish time and channel, plus each channel's
subscriber count (subscriberCountText such as '4.24M'), average
views, upload frequency and outlierRatio (the video's views divided
by that channel's average). The rail mixes in older catalog videos
whose lifetime views are compared with the channel's recent average,
so very large ratios on old videos indicate back-catalog hits rather
than fresh breakouts.
Use when the user asks what YouTube recommends alongside a video, or which channels compete around it. Accepts an 11-character video id or a YouTube URL.
Cost: 5 credits per call.
Inputs: video_id (required), limit. Returns: object
tubegrade_thumbnailsVideo ThumbnailsARead-onlyIdempotentInspect
The actual thumbnail images for specific videos (up to 10, from any channels), each preceded by its video id and the image URL served. Served at 1280×720 where YouTube has it, otherwise 480×360, and the summary says how many were smaller. A thumbnail that can't be fetched is noted inline.
Use when the user wants to see or compare the thumbnails of particular videos. Accepts 11-character video ids or YouTube URLs.
COST: 1 credit PER video requested.
Inputs: video_ids (required).
tubegrade_track_competitorTrack CompetitorAIdempotentInspect
Add a channel to the user's tracked competitors in TubeGrade. TubeGrade then refreshes it daily, building its subscriber and view history. Adding a channel that is already tracked changes nothing. The list has a limited size, and the error says when it is full. Only accounts that include competitor tracking can add channels.
Use only when the user asks to track, follow or add a competitor. Accepts a channel id (UC…), an @handle, or a channel URL.
Cost: 0 credits (free).
Inputs: channel (required). Returns: object
tubegrade_untrack_competitorUntrack CompetitorADestructiveIdempotentInspect
Remove a channel from the user's tracked competitors in TubeGrade. The channel's public data is not affected. Removing a channel that isn't tracked changes nothing and says so.
Use only when the user asks to stop tracking or remove a competitor. Accepts a channel id (UC…), an @handle, or a channel URL.
Cost: 0 credits (free).
Inputs: channel (required). Returns: object
tubegrade_viral_formatsViral FormatsARead-onlyIdempotentInspect
Recurring title or thumbnail formats that repeatedly produce breakout videos, found by TubeGrade's clustering and AI labelling. Each format has a label, a template, a description, a lifecycle state (emerging, rising, peaking or declining), a strength score, hit rate, member count, a recent trend and example videos. Formats are mined across all niches; a niche with no formats of its own returns the cross-niche list with a note.
Use when the user wants proven title or thumbnail patterns to model.
Cost: 5 credits per call.
Inputs: kind, sort, limit, niche, +1 more. Returns: object
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
Related MCP Connectors
YouTube research: channel search, viral videos, channel analytics, transcripts, thumbnails, TTS
YouTube transcripts, video metadata, chapters, comments, channels and search for AI assistants.
81The all-in-one YouTube content engine: research, ideas, thumbnails, scripts, and video.
YouTube for AI agents: transcripts, comments, video stats, channel monitor, Shorts captions.
Related MCP Servers
- AlicenseCqualityDmaintenanceEnables AI assistants to research YouTube videos by collecting captions, comments, and channel information for analysis and comparison.1014 PyPI10MIT
- FlicenseAqualityDmaintenanceEnables AI assistants to analyze YouTube channels, videos, transcripts, and content strategy through structured tool calls.17-
- FlicenseNot gradedqualityDmaintenanceEnables AI assistants to search videos, retrieve transcripts and metadata, analyze channels, and access trending and engagement analytics for YouTube content.-
- FlicenseNot gradedqualityDmaintenanceProvides AI assistants with comprehensive YouTube analytics and channel management capabilities, including channel performance, video analytics, audience insights, and content strategy tools.1-
Glama MCP Gateway
Add one secure layer between your agents and this server.