Meta Ads MCP Server

Analyze messaging themes across video ads and correlate with performance. Groups ads by spoken theme (e.g. pain-agitate-solve, social-proof), emotional tone, or creative approach. Shows which messaging strategies drive the best CTR, CPC, and ROAS. Requires video analyses to be cached first via batch…

Download an image from URL or Google Drive folder, upload to GCS, and analyze with Gemini AI. For Drive folders, lists all images with dimensions/aspect ratios and analyzes the most recent one. Returns structured image analysis including visual elements, text overlays, emotional tone, color palette,…

Analyze video ad creative content using Gemini AI. Returns structured insights including scenes, text overlays, emotional tone, creative approach, target audience indicators, spoken audio transcript with timestamps, and spoken messaging theme analysis (e.g. social-proof, pain-agitate-solve, benefit-…

Download a video from URL or Google Drive folder, upload to GCS, and analyze with Gemini AI. For Drive folders, lists ALL files with dimensions/aspect ratios (4:5, 9:16, etc.) and analyzes the most recent video. Returns structured video analysis including scenes, text overlays, emotional tone, and c…

Analyze multiple video ad creatives in a single call. Processes ads in parallel (max 2 concurrent) using Gemini AI. Returns per-ad analysis results with scenes, text overlays, emotional tone, transcript, and spoken themes. Accepts 1-50 entries as ad ID strings or {adId, creativeId} objects. Pass cre…

Compare and rank multiple campaigns, ad sets, or ads on performance metrics to identify top and bottom performers. Returns rankings, percentiles, statistical benchmarks, and highlights best/worst performers for each metric.

Compare campaign/adset/ad performance between two time periods to identify trends, improvements, and declines. Calculates percent changes for all metrics and highlights significant improvements or declines.

Query account activity history showing budget changes, status changes (pause/unpause), bid changes, targeting updates, creative changes, and billing events. Use this to audit what actions were taken on the account.

Get basic information about a Meta ad account including name, ID, currency, and status

Retrieve ad creative text content including primary text, headline, and description for content analysis and ad categorization. Returns text from all active ads or specific ads by ID.

Compare targeting specs across campaigns/ad sets to identify audience overlap. Analyzes geo, age, gender, interests, behaviors, and custom audience overlap pairwise. Flags high-overlap pairs that may compete in the same auction and waste budget.

Fetch campaign-level configuration settings including ASC (Advantage+ Shopping) settings, existing_customer_budget_percentage, bid strategies, budgets, and ad set targeting. Diagnoses common issues like missing customer budget caps and broad targeting.

Detect ad creative fatigue by analyzing daily frequency and CTR trends. Returns a fatigue score (0-100), frequency/CTR trends, and recommendation (healthy/monitor/rotate/critical). Use with a specific entityId to analyze a campaign, ad set, or ad over time.

Aggregate ad performance by creative ID across all ads using the same creative. Shows which creative variants perform best regardless of targeting or campaign structure. Returns ranked list with aggregated metrics, ROAS, custom conversions, and list of ad IDs per creative.

Query performance metrics segmented by demographic/placement breakdowns (age, gender, country, device, publisher platform, platform position). Three modes: "standard" for impressions/clicks/spend on all ads, "video" for completion funnel on video ads, "conversions" for conversion tracking by placeme…

Get Facebook Pages accessible by the authenticated user. Returns page IDs, names, categories, and linked Instagram actor IDs. Required for creating ad creatives.

Query performance metrics at any level (campaign, adset, or ad). Includes CTR, CPC, CPM, ROAS, reach, custom conversions (subscription_created, etc.), ad relevance diagnostics (quality/engagement/conversion rankings), and optional AI video analysis. Supports preset and custom date ranges. Replaces g…

Get saved audiences for a Meta ad account. Returns audience names, IDs, and approximate sizes. Use to map ICP targeting to audience IDs for ad set creation.

Query video ad metrics including completion funnel (25/50/75/95/100%), ThruPlay, engagement depth (2s/15s/30s views), retention scores, average watch percentage, and drop-off weak points. Replaces get-video-performance and get-video-engagement.

List ad sets within a specific Meta campaign. Returns ad set names, IDs, statuses, and budgets. Critical for mapping Notion ad set names to Meta ad set IDs.

List all custom conversion events available in the ad account. Returns friendly names that can be used in the customActions parameter of get-performance, get-creative-performance, and get-demographics tools.

Get full details for a specific ad from the Meta Ad Library by ID or URL. Returns creative assets (video/image URLs), ad copy, CTA, landing page, impressions, spend, targeting demographics, and optionally a video transcript.

Search the Meta Ad Library by keyword or company name. For company searches, automatically resolves the company name to a Facebook page ID and fetches their ads. Supports filtering by country, status, media type, date range, and more. Use fetch_all: true to auto-paginate all results.

Search for companies/pages in the Meta Ad Library by name. Returns page IDs that can be used with sc-search-ads to fetch a company's ads.