Skip to main content
Glama

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.

Ownership verified
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

A4.1/5.0

Scored across 23 tools

Disambiguation4/5

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.

Naming Consistency4/5

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.

Tool Count3/5

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.

Completeness4/5

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
Vendor relationship
First-party · 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 tools
tubegrade_balanceCredit BalanceA
Read-onlyIdempotent
Inspect

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_bookmarkBookmarkA
DestructiveIdempotent
Inspect

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 ThumbnailsA
Read-onlyIdempotent
Inspect

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 TranscriptsA
Read-onlyIdempotent
Inspect

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 VideosA
Read-onlyIdempotent
Inspect

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 IdeasA
Read-onlyIdempotent
Inspect

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 OutliersA
Read-onlyIdempotent
Inspect

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 ThumbnailsA
Read-onlyIdempotent
Inspect

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 StatsA
Read-onlyIdempotent
Inspect

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 VideosA
Read-onlyIdempotent
Inspect

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 CommentsA
Read-onlyIdempotent
Inspect

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 TranscriptA
Read-onlyIdempotent
Inspect

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 StatsA
Read-onlyIdempotent
Inspect

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 VideosA
Read-onlyIdempotent
Inspect

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 CompetitorsA
Read-onlyIdempotent
Inspect

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 RankingsA
Read-onlyIdempotent
Inspect

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_videosSearchA
Read-onlyIdempotent
Inspect

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 ChannelsA
Read-onlyIdempotent
Inspect

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 VideosA
Read-onlyIdempotent
Inspect

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 ThumbnailsA
Read-onlyIdempotent
Inspect

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 CompetitorA
Idempotent
Inspect

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 CompetitorA
DestructiveIdempotent
Inspect

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 FormatsA
Read-onlyIdempotent
Inspect

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

    Related MCP Servers

    Try in Browser

    Glama MCP Gateway

    Add one secure layer between your agents and this server.

    Resources