# vidIQ MCP MCP

Vendor: vidIQ MCP  
Category: other  
Auth: OAUTH2  
Composio slug: `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.

## Verdict

vidIQ MCP connects your team's AI to YouTube channel analytics, video research, and audience intelligence. @mention it to pull performance data for channels you manage, search for creators by niche or growth metrics, analyze comment sentiment across videos, or validate content ideas against real audience feedback. Most valuable for content strategists, YouTube creators, and marketing teams who need to research competitors, spot trending formats, or justify production decisions with data. Requires a vidIQ account and API key; some tools consume credits from your plan's monthly bucket.

## Tools

- **Vidiq authorize with youtube** — 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 c
- **Vidiq balance** — 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 dr
- **Vidiq channel analytics** — 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 `re
- **Vidiq channel performance trends** — 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 th
- **Vidiq channel search** — 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 natura
- **Vidiq channel stats** — Get 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 (subscribers, views, videos)
- See how much a 
- **Vidiq channel videos** — Get 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 or vidiq_trending_videos.

Use vidiq_user
- **Vidiq comment insights** — Analyze YouTube audience comments for a niche.

Use mode="discover" to find recurring audience questions/content requests and recurring dislikes or pain points. Use mode="validate" with idea to test one proposed video idea. Validation separ
- **Vidiq compose** — Compose 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 with an HTTPS `source` and `duration`) a
- **Vidiq earnings calculate** — Calculate 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 numbers. Use it for "how much would X 
- **Vidiq edit media** — Edit 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-generated media URL (an *.amazonaws.com

- **Vidiq generate broll** — Find 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
photographer credit. Attribution is requir
- **Vidiq generate clips** — Turn 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 prompt, set clipDuration, restrict the s
- **Vidiq generate comment replies** — Generate 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 first, use `vidiq_video_comments`.

Provid
- **Vidiq generate music** — Generate 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 'instrumental' to exclude vocals. Optionall
- **Vidiq generate script** — Write 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 lengthMinutes (1–60, default 10) and a tone.
This 
- **Vidiq generate thumbnail** — Generate 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.

This runs asynchronously: it returns 
- **Vidiq generate titles** — Generate 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) per call.
- **Vidiq generate video** — Generate a short video from a text prompt. Or edit an MP4 using videoUrls from an upload, generation, or composition. The actual video is used without substitute frames. Select gemini-omni-flash or minimax-h3 explicitly for this mode, witho
- **Vidiq get channels by ids** — Get 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, and video counts
- Retrieve channel tag
- **Vidiq get videos by ids** — Get 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 specific videos
- Look up publishing info, c
- **Vidiq ig accounts from outliers** — Find 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. The service groups outlier reels into a
- **Vidiq ig profile** — Fetch 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 — you must already have a handle.
- Reel
- **Vidiq ig profile reels** — Fetch 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 from the first Instagram Reels-tab page 
- **Vidiq instagram connected accounts** — List 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 says whether private owner insights and
- **Vidiq instagram owner insights** — Fetch 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 pass a handle or an account belonging to a
- **Vidiq instagram publish reel** — Publish 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 publishingAvailable=true. Start with videoUrl
- **Vidiq instagram tiktok outlier search** — Search 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 are not comparable across platforms.

U
- **Vidiq job poll** — Check 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 work is done; read `result`.
- 'failed
- **Vidiq jobs list** — List 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_poll` to check a job's result.

This too
- **Vidiq keyword research** — Research 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_trending_videos instead.

This tool has six m
- **Vidiq list competitors** — List 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_channels_by_ids.

The youtubeChannelId must
- **Vidiq motion graphics** — Render an animated MOTION GRAPHIC to a downloadable MP4 video. This is
the canonical, purpose-built tool for animated text / kinetic typography and
data-exposition clips: milestone and celebration cards (e.g. "250K SUBSCRIBERS"),
announceme
- **Vidiq outliers** — Find 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, or videos blowing up. Use `keyword` to
- **Vidiq refine thumbnail** — Change or improve a YouTube thumbnail by describing what you want in plain words.

Give it the thumbnail to change as sourceThumbnail (a hosted URL) or sourceThumbnailFile (a ChatGPT upload),
and say what to change (instructions) — for exam
- **Vidiq score thumbnail** — Score 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 thumbnail image URL to score instead of
- **Vidiq score title** — Score 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-performing option.

Cost: 5 credit(s) per cal
- **Vidiq similar channels** — Find 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 automatically excluded from legacy manual-mode resu
- **Vidiq similar thumbnails** — Find 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 is not topic, title, or keyword search (
- **Vidiq similar videos** — Find 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: textual (title/topic) and visual (thumbnai
- **Vidiq submit feedback** — Submit 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 vidIQ MCP feature, proactively ask whether 
- **Vidiq subscriber insights** — Analyze 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 histogram of sampled public YouTube activity
- **Vidiq trend categories** — List 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 videos** — Find 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, or fastest-growing videos. Unlike vidiq_o
- **Vidiq update competitors** — Follow 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 / unfollow are arrays of YouTube channel IDs —
- **Vidiq update video** — Update 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 time. Omitted fields remain unchanged. An
- **Vidiq user channels** — Get 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 authorized a different account than
they e
- **Vidiq user videos** — List 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 when the channel ID is unknown. Support
- **Vidiq video change history** — Get 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's archived snapshot URL. The response 
- **Vidiq video comments** — Get 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-wide results can be attributed to indivi

## Setup

1. Create or open a Switchy Project.
2. Open Integrations and connect vidIQ MCP.
3. Authorise through oauth2.
4. Teammates can now @-mention vidIQ MCP tools in chat.

---
Last verified: 2026-10-17T02:00:10.360Z  
Canonical URL: https://switchy.build/directory/mcps/vidiq-mcp