vidIQ MCP for AI agents
Agents read vidIQ MCP at once. Changes and sends are held for a person's approval by default.
About vidIQ MCP
vidIQ MCP lets authorized agents research YouTube and Instagram creators, videos, trends, comments, thumbnails, titles, and connected-channel analytics, with explicitly annotated media and account-management actions.
What an agent can do in vidIQ MCP
Every vidIQ MCP action is classed by the platform as a read, a change or a send. Reads run at once. Changes and sends are held for a person by default.
Runs at once (reads)
Looks things up in vidIQ MCP without asking first. 38 actions.
- Vidiq balanceCheck 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 ad
- Vidiq bookmarks listRetrieve 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 g
- Vidiq channel analyticsGet 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 ar
- Vidiq channel performance trendsGet 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 i
- Vidiq channel statsGet YouTube channel statistics including subscriber count, total views, video count, and growth over a configurable time period. Use this tool to: - Look up any YouTube channel's current stats (subscr
- Vidiq channel videosGet videos from a YouTube channel by format (long-form, Shorts, or live streams). Use this when you already know which channel to look at. To discover videos across many channels, use vidiq_outliers o
- Vidiq earnings calculateCalculate estimated monthly YouTube earnings (low/mid/high USD) for a given number of monthly views. This is a calculator, not a lookup: it does not fetch anything from YouTube, so you must supply the
- Vidiq generate brollFind free stock B-roll video clips. Provide a search query (optionally orientation and min/max duration filters). Returns up to 4 clips with a direct mp4 link, a preview image, dimensions, and the pho
- Vidiq get channels by idsGet detailed information about YouTube channels by their IDs. Use this tool to: - Look up channel metadata (title, description, country) for one or more channels - Get subscriber counts, view counts,
- Vidiq get videos by idsGet detailed metadata for one or more YouTube videos. Use this tool to: - Fetch video details such as title, description, tags, and category - Get current statistics (views, likes, comments) for speci
- Vidiq ig accounts from outliersFind Instagram creator/account candidates from existing outlier reel discovery. Use this when the user asks for Instagram accounts, creators, competitors, influencers, partners, or examples to study.
- Vidiq ig profileFetch public Instagram profile by handle: bio, follower/following counts, post count, verification, external URL, with the profile picture returned inline. DO NOT USE FOR: - Profile search/discovery —
Show all 38
- Vidiq ig profile reelsFetch a creator's reels by handle: shortcode, caption, play/like/comment counts, duration, timestamp, pinned-profile status, with each reel's cover returned inline as an image. Returns up to 12 reels
- Vidiq instagram connected accountsList the signed-in user's Instagram accounts already connected to vidIQ. Use this first when the user says "my Instagram", "my account", or otherwise asks about their own Instagram data. Each account
- Vidiq instagram owner insightsFetch private Instagram owner insights for an OAuth-backed account already connected to the signed-in vidIQ user. Always obtain `platformAccountId` from `vidiq_instagram_connected_accounts`; do not pa
- Vidiq instagram tiktok outlier searchSearch Instagram Reels and TikTok videos together for posts that substantially outperform each creator's median. Results are returned in separate Instagram and TikTok sections because relevance scores
- Vidiq job pollCheck the status of an asynchronous vidIQ job and retrieve its result. Pass the `mcpJobId` returned by a `*_start` tool. Poll periodically until `status` is no longer 'inprogress': - 'completed' → the
- Vidiq jobs listList your asynchronous vidIQ jobs, newest first. Filter by `toolName` and/or `status`. To find jobs that are still running, filter `status: 'inprogress'`. Use the returned `mcpJobId` with `vidiq_job_p
- Vidiq keyword researchResearch YouTube keywords to find search volume, competition, and related keyword opportunities. This tool returns keyword metrics, NOT videos. To find actual videos, use vidiq_outliers or vidiq_trend
- Vidiq list competitorsList the YouTube channels the user is tracking as competitors of one of their own channels. Returns only channel IDs. To get titles, thumbnails, subscriber counts, etc., pass the IDs to vidiq_get_chan
- Vidiq outliersFind viral, breakout, and overperforming YouTube videos — videos getting significantly more views than their channel's average. Use this when someone asks for: viral videos, breakout hits, hidden gems
- Vidiq score thumbnailScore a YouTube video thumbnail for click-through-rate potential. Returns a score (0-100) with detailed feedback on strengths and improvements. Provide a video ID and title; optionally supply a custom
- Vidiq score titleScore a YouTube video title for click-through-rate potential. Returns a score (0-100) indicating how compelling and clickable the title is. Use this to compare title variations and pick the best-perfo
- Vidiq similar channelsFind COMPETITORS of a channel — either the user's own channel or a specific named channel. Uses neural semantic search tuned for competitor matching; the user's own authorized channels are automatical
- Vidiq similar thumbnailsFind long-form YouTube videos whose thumbnails LOOK similar — visual/semantic similarity over the thumbnail images themselves. This tool searches long-form videos only; Shorts are not supported. This
- Vidiq similar videosFind high-performing YouTube videos similar to a seed video - the video-level counterpart of vidiq_similar_channels. Give it one video ID or URL and it returns videos ranked by combined similarity: te
- Vidiq subscriber insightsAnalyze subscriber overlap and best times to post for a YouTube channel you own. Returns the channels most commonly subscribed to by your audience, dated overlap history, and a timezone-adjusted histo
- Vidiq trend categoriesList all available trend category slugs with display names and descriptions. Use this as a reference before filtering outlier videos by trend category. Cost: 0 credit(s) per call.
- Vidiq trending videosFind YouTube videos that are trending right now — gaining views rapidly based on views-per-hour velocity. Use this when someone asks: what's trending, what's hot right now, popular videos this week, o
- Vidiq user channelsGet the list of YouTube channels authorized by the current user. The response includes `authenticatedAs` (the email of the connected vidIQ account). An empty `channels` list usually means the user aut
- Vidiq user videosList videos from one of the current user's directly authorized YouTube channels through the authenticated vidIQ MCP connection, including public, unlisted, and private videos. Use vidiq_user_channels
- Vidiq video change historyGet the observed title and thumbnail change history for one YouTube video. Each change records when a title or thumbnail edit was observed. Thumbnail entries include the original YouTube URL and vidIQ
- Vidiq video commentsGet YouTube comment threads for a video or channel, including replies. Provide exactly one of videoId or channelId. Each returned thread carries the videoId and videoTitle it belongs to, so channel-wi
- Vidiq video earnings estimateEstimate a single YouTube video's ad-revenue earnings as a low/mid/high range in USD. Give it a video id or URL. It resolves whether the video is long-form or a Short, looks up the channel's category
- Vidiq video statsGet historical statistics for a YouTube video over time, including views, likes, comments, and views per hour (VPH). Use this tool to: - Track how a video's performance changes over time - Compare vie
- Vidiq video transcriptGet the full transcript (captions) of a YouTube video. Use this tool to: - Analyze what a video talks about without watching it - Extract key topics, quotes, or timestamps from a video - Compare conte
- Vidiq voiceover list voicesList the available voiceover voices. Returns each voice's id, name, category, description, and an optional audio preview URL. The user's own cloned/designed voices have isCustom=true and are listed fi
- Vidiq youtube searchSearch all of YouTube for videos, channels, or playlists matching a query, with optional filters (topic, region, publish date, duration, channel). Use this when someone asks to "find videos about X",
Held for approval by default (changes and sends)
Held for a person's approval by default. The approval is recorded and the action is sent once, never twice, with 10 seconds to undo. 25 actions.
- Vidiq authorize with youtubeCheck 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 YouT
- Vidiq bookmarks removeRemove 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
- Vidiq bookmarks saveSave 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 s
- Vidiq comment insightsAnalyze YouTube audience comments for a niche. Prefer discover/validate by default. Use raw only when underlying comments are needed. A new raw search costs the same as discover/validate; its cursor p
- Vidiq composeCompose a short video from scenes (video clips and/or images), an optional voiceover, background music, and overlays (text, image, or video), then render it to an MP4. Provide ordered `scenes` (each w
- Vidiq connect youtube channelConnect a YouTube channel to the user's vidIQ account. Call this tool when another vidIQ tool reports that no YouTube channel is connected, or when the user asks to connect a YouTube channel. Show the
- Vidiq edit mediaEdit a media file: trim a clip, extract its audio, grab a thumbnail frame, normalize its loudness, or probe it for metadata (duration, dimensions, streams). Set `op` and give a `sourceUrl` — a vidiq-g
- Vidiq generate clipsTurn a long video into short, vertical clips. Provide either a YouTube link (videoUrl) or an already-hosted file (uploadedVideoUrl + videoDuration + videoFilename). Optionally steer selection with a p
- Vidiq generate comment repliesGenerate multiple draft replies to one viewer comment on a YouTube video, with one reply per requested tone. Use this when the user wants response ideas for a specific comment. To retrieve comments fi
- Vidiq generate musicGenerate ONE original, royalty-free background-music track (WAV) from a text prompt. Describe the music in the prompt (max 2000 characters): genre + mood + instrumentation + tempo works best; add 'ins
- Vidiq generate scriptWrite a full long-form video script from a topic, title, concept, and research. Provide the topic, the chosen title, the concept/angle, and research/context to ground it in; optionally set lengthMinut
- Vidiq generate thumbnailGenerate a YouTube thumbnail. Provide at least one of videoId, title, description, or userQuery. With only a videoId, the video's current title, description, and thumbnail are pulled in automatically.
Show all 25
- Vidiq generate titlesGenerate scored YouTube title suggestions. Provide at least one of `videoId`, `title`, or `description`. With only `videoId`, the current title/description are fetched from YouTube. Cost: 5 credit(s)
- Vidiq generate video chaptersStart precise YouTube chapter generation from a video's timestamped captions. Use this when the user wants chapter timestamps, a video outline with exact boundaries, or a chapter block for a YouTube d
- Vidiq instagram publish reelPublish an approved hosted MP4 using this same tool across short calls. First obtain approval for the exact video, account, caption and regular or Trial settings. Select a connected account with publi
- Vidiq submit feedbackSubmit feedback about the vidIQ MCP — feature requests, bug reports, improvement suggestions, survey responses, or general comments. When the user encounters a bug with vidIQ MCP or requests a new vid
- Vidiq update competitorsFollow or unfollow competitor channels for one of the user's own YouTube channels. - youtubeChannelId must be a channel the user has authorized (call vidiq_user_channels to discover). - follow / unfol
- Vidiq update videoUpdate metadata or publishing settings for a YouTube video owned by the user. Supported updates match the vidIQ web app: title, description, complete tag list, privacy status, and scheduled publish ti
- Vidiq update video thumbnailReplace the thumbnail for a YouTube video owned by the user. Call this write tool only after the user explicitly chooses the exact channel, video, and final thumbnail to publish. Do not call it to pre
- Vidiq video uploadImport an MP4 attachment or public downloadable URL and return a hosted videoUrl plus uploadId. Provide exactly one of file, url, or uploadId. The server transfers and completes the upload; no separat
- Vidiq video watchWatch a long-form YouTube video end-to-end and return a structured markdown walkthrough. Use this tool to: - Understand what happens visually in a video (not just what is said) — useful when transcrip
- Vidiq voiceover cloneClone a voice from an audio sample and save it to the user's voice library. Provide a base64-encoded audio sample (a 60-600s MP3/WAV/M4A clip of a single speaker who has consented to being cloned) and
- Vidiq voiceover clone startStart cloning the speaker's voice from a YouTube video. Provide a public YouTube URL and a name for the voice. This runs asynchronously: it returns an `mcpJobId` immediately — poll `vidiq_job_poll` wi
- Vidiq voiceover generateGenerate a voiceover MP3 from a script. Provide the script text (max 5000 characters) and a voiceId from vidiq_voiceover_list_voices. This runs asynchronously: it returns an `mcpJobId` immediately. Po
- Vidiq watch shortform contentWatch one piece of short-form content from Instagram, TikTok, or YouTube and return a markdown scene-by-scene walkthrough. Pass the full public URL. For YouTube Shorts, a /shorts/, watch, or youtu.be
Changes wait in Needs you
Changes and sends in vidIQ MCP are held for a person's approval by default. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
vidIQ MCP questions
Can an agent change data in vidIQ MCP on its own?
Not by default. Changes and sends in vidIQ MCP are held for a person's approval. The approval is recorded, and the action is sent once, never twice, with 10 seconds to undo.
What can an agent read in vidIQ MCP?
This connector lists 38 read actions. Reads run at once, without waiting for approval.
How does vidIQ MCP connect?
It connects with dcr oauth or API key. Connectors are built and maintained by third-party developers; availability is confirmed during scoping.