Check whether the server is signed in to YouTube, which channel it reads, and which permissions were granted. Call this first if any other tool reports a sign-in problem.

Start Google sign-in in the user's browser and return the sign-in URL immediately.

The user must approve access in the browser (choosing the account or Brand Account that owns the channel). Afterwards call get_auth_status to confirm. Only works when the MCP server runs on the user's own computer. Signing in again replaces the stored token.

The signed-in channel's profile and lifetime public stats: subscribers, total views, video count, creation date, country, handle, description, keywords and topics.

List the channel's uploads (including private/unlisted/scheduled, newest first) with public lifetime stats: views, likes, comments, engagement rate, duration, format guess. Costs ~1 quota unit per 50 videos. For period-specific performance use get_top_videos.

Full metadata and lifetime public stats for specific videos: title, description, tags, category, privacy, duration, captions, live-stream details, views, likes, comments.

The channel's playlists with item counts and privacy. Use list_videos(playlist_id=...) to see a playlist's videos.

Read comment threads (top-level comments with reply counts) for the channel or one video, e.g. to summarise audience sentiment, find questions, or spot content ideas.

Headline numbers for a period, like Studio's Overview tab: views, engaged views, watch time (hours), average view duration/percentage, subscribers gained/lost/net, likes, comments, shares, engagement rate, optionally revenue, each with the previous period and % change. Works for the channel or a single video.

A time series of metrics by day, week, month or year — for trend analysis and growth charts. Adds netSubscribers when gained and lost are both requested. Buckets cut off by the date range are flagged partial=true.

Rank the channel's videos by performance within a period (like Studio's 'Top content'), with title, publish date, YouTube's content type (Shorts/Videos/Live), views, watch time, average view duration/percentage, likes, comments, shares, subscribers gained and engagement rate.

Who watches and how: demographics, geography, devices, subscriber vs non-subscriber views, Shorts vs long-form split, playback locations. Rows include readable labels and share_pct of views, ready for media-kit charts.

How viewers find the content: views and watch time by traffic source (search, suggested, browse, Shorts feed, external, ...) or, with source_type, the top search terms / referring videos / websites for that source.

The audience-retention curve for one video, with timestamps, key retention milestones and the steepest drop-off moments. Defaults to the video's lifetime.

audience_watch_ratio = share of viewers still watching at that moment (can exceed 1 when people rewatch a part). relative_retention compares with similar-length YouTube videos (0-1; above 0.5 is better than average).

Monetization report (YouTube Partner Program channels): estimated revenue, ad revenue, gross revenue, RPM, CPM, playback-based CPM, monetized playbacks and ad impressions, with a trend and the top-earning videos.

Run any YouTube Analytics API v2 report for the channel (ids=channel==MINE) — the escape hatch when no other tool fits. See https://developers.google.com/youtube/analytics/channel_reports for valid combinations. Notes: the 'video' dimension needs sort and max_results <= 200; 'insightTrafficSourceDetail' needs a filter on insightTrafficSourceType, sort and max_results <= 25; demographics (ageGroup/gender) only support viewerPercentage; the 'month' dimension aligns dates to whole months automatically. YouTube's error message is returned if a combination is invalid.

One-time setup for thumbnail impressions & click-through rate (CTR), which the Analytics API does not provide. Creates a YouTube Reporting API job for the channel (safe to call again). YouTube then publishes daily reports: the first ones ~48 hours later, plus 30 days of history. Use get_impressions afterwards.

Thumbnail impressions and impressions click-through rate (CTR) from the YouTube Reporting API, by day, by video, or in total. Requires enable_impressions_reports to have been run at least ~2 days earlier; only days YouTube has published are included.

Everything a creator media kit / sponsor deck needs, as one stable JSON snapshot (schema_version 1, snake_case, *_pct 0-100, *_s seconds): channel profile, period performance vs previous period, Shorts vs long-form performance, impressions funnel, daily and monthly trends, audience age/gender/countries/devices, recent uploads with thumbnails, top videos and traffic sources. Anything YouTube can't provide is null and explained in unavailable instead of failing the call.

Render a polished, media-kit-ready chart (PNG, SVG or PDF) from data you provide — typically numbers from the analytics tools. Uses a colour-blind-safe palette by default, thin marks, clean axes and direct value labels. Returns the saved file path(s) and a preview image.