vidIQ MCP + Stream Deck

Check or establish fresh YouTube authorization for the current vidIQ OAuth connection. Call this tool when the user asks to authorize with YouTube, before a sensitive workflow that requires fresh YouTube authentication, or after the user completes the authorization handoff. It authorizes using a YouTube channel already connected to vidIQ. If no channel is connected yet, it reports that and vidiq_connect_youtube_channel connects the first one, which also establishes fresh YouTube authorization. When authorization is required, show the authorization widget and wait for the user to use its controls. Cost: 0 credit(s) per call.

Check the user's current vidIQ credits balance. vidIQ credits live in two buckets: - A renewable bucket sized by the user's plan (Free/Boost/Max/etc) that refills each billing cycle. - Zero or more add-on (bonus) credits. Add-on credits drain alongside renewable credits but do NOT refill. Field semantics are in the output schema. Key invariant: totalCredits = renewableCredits + addOnCredits; maxRenewableCredits is the plan cap only. Example — Boost user with an open promo grant: { type: 'limited', totalCredits: 1800, renewableCredits: 1500, maxRenewableCredits: 2000, renewableResetsAt: '2026-06-01T00:00:00Z', addOnCredits: 300, maxAddOnCredits: 500 } Read as: 1,800 left = 1,500 of 2,000 renewable + 300 of a 500-credit bonus pool. Renews Jun 1. Cost: 0 credit(s) per call.

Retrieve the signed-in user's saved bookmarks to review or reuse in research and planning. Use when the user asks "show my saved videos", "show my saved channels", "show my saved keywords", "show my generated videos", "show my uploads", "what did I bookmark?", or wants to reuse saved inspiration or a saved creation. With no arguments, returns the 10 newest bookmarks across all types. Video bookmarks span several types: bookmarkType="saved-video" (videos saved while browsing, any platform), "saved-outlier-video" (YouTube outliers), "saved-generated-video" (the user's own generated videos) and "saved-uploaded-video" (their uploads); channels and creators use "saved-channel" (platform youtube, instagram or tiktok); keywords use "saved-keyword". When the user asks for "saved videos" without saying which, ask whether they mean all of them, outliers only, generated, or uploads — or list all types and group the answer by type. Tags match any supplied tag name. Supports type and tag filters, not keyword or topic search. Returns stored payloads, not live metrics; use the relevant research tool when fresh metrics are requested. Pass nextOffset as offset for the next page; null means no more results. Cost: 0 credit(s) per call.

Remove 1–50 bookmarks from the signed-in account in one atomic batch. Only remove items the user explicitly asked to remove; otherwise ask first. Duplicate IDs count once. Any unknown, already removed, or foreign ID rejects the entire batch. If the outcome is uncertain, inspect saved bookmarks before retrying. Cost: 0 credit(s) per call.

Save 1–50 bookmarks of one type to the signed-in account in one atomic batch. Only save items the user explicitly asked to save. Repeated saves create duplicates. Do not automatically retry a failed save; inspect saved bookmarks first if the outcome is uncertain. After success, briefly confirm the saved count and what was saved. The response includes a suggested vidiq_bookmarks_list call for later retrieval; do not call it automatically just to confirm a successful save. Cost: 0 credit(s) per call.

Get YouTube Analytics data for a channel you own — views, watch time, subscribers gained, likes, comments, retention, traffic sources, demographics, and revenue (monetized channels). Common reports are available as one-word presets via report: audience_retention (per-video drop-off curve), traffic_sources, audience_demographics, audience_geography, revenue_report, top_videos, shorts_vs_longform_split. Or build custom queries with flexible date ranges, metric selection, and dimensional breakdowns (by day, country, device type, traffic source, etc.). Use this tool to: - Analyze channel performance over a specific time period - See where viewers drop off in a video (report='audience_retention' + filters='video==VIDEO_ID') - Break down views by traffic source, country, device type, age/gender - See which videos actually earn (report='revenue_report', dimensions=['video']) - Compare Shorts vs long-form performance (report='shorts_vs_longform_split') Views vs engaged views: since 2026-08-27 YouTube counts views from the first frame, so views runs about 1.7–1.9× higher than before on long-form. Use engagedViews for any before/after comparison that spans that date and when judging which of the channel's own videos are outliers. Note: Only available for channels authorized to your account. Revenue metrics additionally require the channel to be monetized. Cost: 5 credit(s) per call.

Get a channel's typical video performance curve — how views accumulate over time after publication. Returns statistical aggregates (min, max, avg, median, percentiles) of view counts at various time intervals since publication, based on the channel's recent videos. Use this tool to: - Understand how quickly a channel's videos gain views after publishing - Compare a channel's view velocity against benchmarks - Identify whether a channel has strong initial traction or slow-burn growth Cost: 5 credit(s) per call.

Comprehensive YouTube channel search. Combines semantic + lexical text search with structured filters across identity, audience size, growth, format mix, and content metadata. Use this tool to: - Find channels by niche or topic with natural-language queries (semantic match on niche + description embeddings). - Look up a specific channel by YouTube handle (e.g. '@MrBeast'). - Require specific wording in the channel description with the description filter (consecutive words, typo-tolerant) — for 'channels whose description mentions/says X'. - Filter by channel size (subscriber/view/video count ranges), growth (7d / 30d / 1y subs and views), recency (last video published), format (long / short / mixed), per-format average duration and video/view counts (7d / 30d / 1y), creation date, country, language, main category, and flags (faceless, breakout). - Order results with the optional sort param (relevance / subscriberCount / subsGrowth30d / viewsGrowth30d / lastVideoPublished). Topical asks — including 'top/popular/biggest channels about X' — use relevance (default), which already favors notable channels; field sorts are ONLY for explicit metric scans and re-order by the raw metric, ignoring topical fit. - Combine any subset of inputs — at least one of query / handle / channel title / filters is required. - Find emerging channels: set breakoutChannel: true for any 'breakout / emerging / up-and-coming channels in X' intent — the flag filters to breakout channels AND switches ranking to favor small fast-rising channels (replaces vidiq_breakout_channels). - Non-English / local discovery: languages means the actual language channels publish in; country means where channels are based, not audience location or content language. Never translate the query — 'дай каналы про уроки макияжа' → query: 'уроки макияжа', languages: ['ru']; 'tokyo street food' → query: 'tokyo street food', country: ['JP']; 'news and politics in Ukraine' → country: ['UA'] (news/politics/local-events about a country means that country's channels, not foreign coverage). Results should match the request's language unless the user says otherwise. For geo-local or language-specific discovery request limit 20+ — relevant local channels may rank below globally popular ones. For finding COMPETITORS of a channel — the user's own ("who are my competitors?") or a named one ("channels similar to Creator Insider") — prefer vidiq_similar_channels (auto-exclusion and competitor-tuned scoring); this tool is still the right first step there, to resolve the reference channel's niche, subNiches, subscriberCount, country, and languages. For viral-video discovery, use vidiq_outliers. Cost: 5 credit(s) per call.