Skip to main content

What does the Vidmob MCP do?

This article covers what the connector supports today. We update this article as new capabilities become available.

Written by Paulo Silva

To connect and sign in, see Setting up the Vidmob MCP Connector.

The Vidmob MCP connector lets your AI agents and tools work with Vidmob's creative data directly. You can take stock of the creative data you have access to across your organization, check whether creative meets your guidelines, see which creative attributes are detected in it, find out which creative decisions are driving performance, and see how your creative is performing. There's no need to export reports or build a separate integration.

For the wider role of AI agents in creative decision-making, read From Creative Insights to Agentic Action.

How access works

Everything you do through the connector is tied to your organization, so an integration only ever works with the brands, workspaces, and creative that belong to you. You sign in with your own Vidmob login (password or SSO), and when you connect you choose which organization the session works in. The session stays scoped to that one organization.

Within that organization, you see the same workspaces you can see in Vidmob. Organizational Admins see every workspace, and other users see only the workspaces they belong to. A connection that uses an API key covers every workspace in its organization. For more on how organizations and workspaces are structured, see How do Organizations and Workspaces function?.

Available today

Take stock of your account, then zoom in

See how your organization is set up: your workspaces, brands, and markets, the channels you're connected to, and the ad accounts behind them, including whether each account is connected and importing data. From there, see the campaigns, ad groups or ad sets, and ads running through them, plus DV360 insertion orders and line item types. It's how you answer "which channels are we connected to?" or "which ad accounts do we have, and how do they map to our brands and markets?"

You can narrow your ad accounts to a single brand in one step. The connector can also tell you which ad types, placements, campaign objectives, and KPIs are available for each channel, including the custom conversion KPIs set up on your Meta and DV360 accounts.

Search the creative that ran on your channels

Find the exact creative that ran on your connected ad accounts and delivered impressions in the dates you choose. Filter by channel, brand, market, campaign, objective, ad group or ad set (or insertion order and line item type for DV360), ad, ad type, placement, file type, file name, and impression volume.

You can also set a minimum number of impressions or show only creative made by Vidmob. Ask "how are our Reels in Germany performing so far this month?" and the connector finds those assets and pulls their performance in the same conversation. Creative you submitted for scoring isn't included in search. Look it up directly by its ID or the reference you gave it when you submitted it.

Score your creative

Submit creative and get back a clear answer to "is this ready to run, and if not, where does it fall short?" You can submit up to 100 assets at once, as links or uploaded files (video files up to 2.25 GB each). Choose the workspace whose guidelines apply and the channels to score against, then check on progress while your assets process. If you don't choose a workspace, only your organization-wide guidelines are applied.

For each asset, you get an overall score, weighted by guideline points across the guidelines that apply to it (guidelines that can't be evaluated don't count against you), along with a guideline-by-guideline breakdown of what passed, what failed, and what couldn't be evaluated. Guidelines can reflect channel best practices, your own brand standards, or both, and you can list the guidelines a workspace is scored against.

Understand what's in your creative

See the creative attributes Vidmob's AI detects inside an asset: the storytelling approach, the messaging and benefit framing, the production style, and the calls to action, as well as more literal detections like on-screen text, your brand logos, objects, scenes, people, and the type of sound used (music, speech, sound effects, or no sound). For video, each attribute comes with when it appears and, for visual elements, where it sits on screen. This shows you the creative decisions made in an asset, so you can connect them to how it performed and decide what to test next.

Get the full picture for any asset

Retrieve everything Vidmob knows about an asset: file details (type, dimensions, aspect ratio, duration, and a download link), the brands and workspaces it belongs to, and, for creative from your connected ad accounts, its ad context. That includes the campaigns, ad groups, and ads it runs in, when it first and last delivered, the spend attributed to it, and whether each ad is live, paused, or completed where the channel reports it. This covers the past year by default, and you can ask for up to five years. It's how you answer "which campaigns and ads is this asset running in, and when did it last deliver?" in a single step.

Measure how your creative is performing

Look at performance the way that fits your question:

  • Creative by creative: each asset's KPI value (like click-through rate or CPM), the impressions it delivered, and how it compares to the average across everything you asked about, one channel and one KPI at a time. Use it to build a top-performer list or flag underperformers for refresh.

  • By campaign, ad group, ad, or asset: several KPIs at once, with the creative score alongside, using the same numbers as the Campaign Manager report in Vidmob. Rank your top or bottom campaigns, ad groups, or ads on any KPI the channel reports. When you look across several channels at once, you compare on the KPIs those channels share, such as click-through rate and CPM.

  • Slice by slice: on one channel at a time, compare slices of your creative against the average, such as campaign, objective, placement, ad type, format, video length, device, age, gender, brand, market, or Vidmob-created versus other creative, wherever the channel reports that slice. You can also define your own creative groups, like "shows our logo in the first 3 seconds" versus "doesn't", and see how each performs against the average.

You can narrow the creative-by-creative and campaign views the same way you search: by brand, market, campaign, ad, objective, placement, or (for DV360) insertion order and line item type. The slice-by-slice view is narrowed by brand, market, and ad account. To compare placements such as Reels and Stories, or DV360 line item types such as TrueView and YouTube & partners, choose them as the slices you compare.

Find your creative drivers

Ask "what creative decisions are helping or hurting our performance most?" and get back the creative attributes most associated with your KPIs, both what's lifting performance and what's dragging it down. This is the same analysis as the Element Impact report in Vidmob. You can focus on a topic such as messaging, people, branding, audio, or visual style, compare values within one category (say, animation versus live action), and go straight from any driver to the assets behind it.

Connect your guidelines to performance

See whether meeting a guideline goes hand in hand with better results. For each guideline, the connector compares the creative that met it with the creative that didn't, on the KPIs you choose, one channel at a time. For rate KPIs like click-through rate or view rate, it also tells you whether the difference is statistically significant when each group has at least 30 creatives. Cost and spend KPIs are compared without a significance test.

Track guideline adoption and creative quality

Get the same scoring reports you use in Vidmob:

  • Adoption: the share of your scored creative that meets your guidelines over time, split between pre-flight and in-flight creative.

  • In-flight: how the creative delivering right now adheres to each guideline, with the option to see the specific creative behind a guideline.

  • Asset investment: how your spend and impressions are distributed across low, medium, and high scoring creative. This report uses the score bands set up for your organization in Vidmob.

  • Impressions: guideline adherence weighted by the impressions your creative delivered.

See how much of your delivery was branded

Estimate how many of your impressions reached the moment your brand appeared on screen, by campaign or by creative, along with the matching share of spend. Your brand counts as appearing when its logo or on-screen text matches one of the Brand Identifiers set up in Vidmob. Spoken mentions aren't counted. This needs Brand Identifiers set up and brands assigned to your ad accounts, and it looks at one channel at a time. The figures are modeled from when your brand first appears on screen in each creative and how far viewers watched that creative, so treat them as an estimate. Images count as fully branded whenever the brand is shown, so ask for video only when you want a video-only view.

Analyze creator content with Influencer Intelligence

If your organization has the Influencer Intelligence add-on, you can bring video posts from creators on Instagram, TikTok, YouTube, or Pinterest into Vidmob by uploading a CSV file or sharing a link to one, match the file's columns to the report fields, and create a report. Creating a report starts Vidmob's analysis of the media behind every post, so confirm your file and column mapping first. Once the report is ready, see which creators and posts are performing best and which creative elements are driving their results.

Join Vidmob data with your own first-party data

Results include the same campaign, ad group, ad, and creative IDs your ad platforms use, so your team can match Vidmob data to your own reporting and systems. You can also look up any asset by its ad platform ID.

Tools reference

The capabilities above are delivered through the tools below. Your AI assistant chooses and chains them for you, so you don't need to call them by name. This list helps you understand what the assistant did, and helps your team plan an integration. Read tools only retrieve data. Write tools create something in Vidmob, so confirm before your assistant runs them.

Organization and discovery

Tool

What it does

Type

list_workspaces

Lists the workspaces you can access in your organization.

Read

list_channels

Lists the channels with connected ad accounts, optionally for one workspace.

Read

list_brands

Lists the brands set up in your organization.

Read

list_markets

Lists the markets (countries) available in a workspace.

Read

list_kpis

Lists the KPIs available for a channel, including custom conversion KPIs on Meta and DV360.

Read

list_campaign_objectives

Lists the campaign objectives available for a channel.

Read

list_ad_types

Lists the ad types available for a channel.

Read

list_ad_placements

Lists the ad placements available for a channel.

Read

list_line_item_types

Lists the DV360 line item types.

Read

Ad accounts and ad structure

Tool

What it does

Type

list_ad_accounts

Lists your connected ad accounts, filterable by workspace, channel, or brand.

Read

get_ad_account

Returns the details of one ad account, including its connection and import status.

Read

list_campaigns

Lists the campaigns that delivered in a date range.

Read

list_ad_groups

Lists the ad groups (ad sets on Meta) that delivered in a date range.

Read

list_ads

Lists the ads that delivered in a date range, with the creative behind each one.

Read

list_insertion_orders

Lists the DV360 insertion orders that delivered in a date range.

Read

Creative, elements, and scores

Tool

What it does

Type

search_media

Finds the creative that ran on your channels, using filters like brand, market, campaign, placement, and impressions.

Read

get_media_details

Returns one asset's file details, brands, workspaces, and ad history, including spend and delivery dates.

Read

get_media_elements

Returns the creative attributes Vidmob's AI detects in an asset, with timing and on-screen position.

Read

get_media_scores

Returns an asset's guideline-by-guideline results and overall score.

Read

list_guidelines

Lists the guidelines a workspace is scored against.

Read

Submitting creative for scoring

Tool

What it does

Type

create_media_upload

Prepares secure upload links for files you want to submit.

Write

submit_media

Submits up to 100 assets for analysis and scoring.

Write

get_media_submission

Checks the progress of a submission.

Read

Performance and reporting

Tool

What it does

Type

query_media_performance

Returns each asset's KPI value, impressions, and comparison to the average, for one channel and one KPI.

Read

query_performance

Returns several KPIs and the creative score by campaign, ad group, ad, or asset.

Read

query_performance_breakdown

Compares slices of your creative, or your own creative groups, against the average.

Read

query_creative_drivers

Ranks the creative attributes most associated with your KPIs (Element Impact).

Read

list_creative_driver_assets

Lists the assets behind a creative driver.

Read

query_guideline_performance

Compares creative that met each guideline with creative that didn't, on the KPIs you choose.

Read

query_branded_impressions

Estimates branded impressions and spend by campaign or by creative.

Read

query_scoring_reports

Returns the Adoption, In-flight, Asset investment, and Impressions scoring reports.

Read

Influencer Intelligence

Tool

What it does

Type

create_influencer_dataset_upload

Brings in a CSV of creator posts, from a file or a link.

Write

create_influencer_report

Creates an influencer report from your dataset and column mapping, and starts the analysis.

Write

list_influencer_reports

Finds your influencer reports and the KPIs and filters available for each.

Read

query_influencer_report

Returns creator, post, and creative element results from a report.

Read

Good to know

  • Spend and cost metrics like CPM are available when your organization has spend reporting enabled in Vidmob. Reports can show spend in the currency you prefer, converted at the average exchange rate across your date range. Spend shown in a single asset's ad details is in US dollars.

  • Performance and creative driver findings show how creative attributes and results move together. They point you to what to test next rather than proving cause and effect.

  • To connect the Vidmob MCP to your AI assistant or agent, see Setting up the Vidmob MCP Connector.

Did this answer your question?