What Is MCP Deep Ad Analysis?
MCP Deep Ad Analysis is a free, open-source SKILL.md that analyses live Google Ads and Meta Ads campaign data through the Flyweel MCP server. Instead of exporting CSVs or taking screenshots, you ask questions in natural language and the skill queries your connected ad accounts in real time.
The SKILL.md includes 8 MCP tools, 5 pre-built analysis playbooks, and batches up to 5 queries per API call. You get comprehensive campaign insights without leaving your AI agent.
Get Started in 3 Steps
Step 1: Get Your Free API Token
Sign up at signup.flyweel.co/mcp to get your Flyweel API token. No credit card required. The token connects your AI agent to the Flyweel MCP server.
Step 2: Install the SKILL.md
npx @flyweel/skill install flyweel-mcp-deep-ad-analysis
Install for a specific agent:
npx @flyweel/skill install flyweel-mcp-deep-ad-analysis --agent=cursor
npx @flyweel/skill install flyweel-mcp-deep-ad-analysis --agent=windsurf
npx @flyweel/skill install flyweel-mcp-deep-ad-analysis --agent=claude-code,cursor
Install all Flyweel skills:
npx @flyweel/skill install --all
Step 3: Ask Questions
Open your AI agent and try:
Show me my Google Ads performance for the last 30 days.
The SKILL.md handles MCP tool calls, data batching, and analysis automatically.
The SKILL.md orchestrates 8 MCP tools provided by the Flyweel server:
| Tool | Description |
|---|
| get_setup_status | Check MCP server connection and authentication status |
| list_ad_accounts | List all connected Google Ads and Meta Ads accounts |
| connect_ad_platform | Connect a new ad platform to your Flyweel account |
| select_ad_accounts | Choose which ad accounts to analyse |
| trigger_sync | Start a data sync from your ad platforms |
| get_sync_status | Check progress of an ongoing data sync |
| get_connection_status | Verify platform connection health |
| query_metrics | Query ad performance metrics with filters and date ranges |
Pre-Built Analysis Playbooks
Five ready-to-use playbooks cover the most common analysis scenarios:
A top-level snapshot of all connected accounts: total spend, conversions, ROAS, and key trends over the selected period. Start here to identify which accounts need attention.
Budget Efficiency Audit
Analyses spend distribution, identifies wasted budget, and flags campaigns with high spend but low conversion rates. Surfaces opportunities to reallocate budget toward better-performing campaigns.
Channel Comparison
Side-by-side comparison of Google Ads vs Meta Ads performance. Compares CPL, CPA, ROAS, and conversion volume to help you decide where to scale or cut.
Campaign Deep Dive
Granular analysis of a single campaign: ad group performance, keyword/audience breakdown, creative performance, and day-parting patterns.
Full Funnel Analysis
Connects ad spend through CRM data to actual revenue. Tracks the path from impression to click to lead to deal to revenue, revealing true ROAS beyond platform-reported conversions.
Metrics & Dimensions
| Metric | Description |
|---|
| Spend | Total ad spend in your account currency |
| Impressions | Number of times ads were shown |
| Clicks | Number of ad clicks |
| Conversions | Platform-reported conversions |
| CTR | Click-through rate (clicks / impressions) |
| CPC | Cost per click |
| CPM | Cost per 1,000 impressions |
| CPA / CPL | Cost per acquisition or lead |
| ROAS | Return on ad spend |
| Conversion Rate | Conversions / clicks |
CRM Metrics (Full Funnel)
| Metric | Description |
|---|
| Deals Created | New deals attributed to ad campaigns |
| Revenue | Closed revenue from ad-sourced deals |
| Pipeline Value | Open pipeline from ad-sourced leads |
| Win Rate | Percentage of ad-sourced deals that close |
| Sales Velocity | Average time from lead to closed deal |
| True ROAS | Revenue / ad spend (not platform-reported) |
Example Prompts
Try these after connecting your accounts:
- “Show me a performance overview for all accounts this month.” Triggers the Performance Overview playbook.
- “Which campaigns are spending the most with the fewest conversions?” Budget efficiency analysis.
- “Compare my Google Ads and Meta Ads CPL for the last 90 days.” Channel comparison.
- “Deep dive into my best-performing Meta campaign.” Granular creative and audience analysis.
- “What’s my true ROAS when you include CRM revenue data?” Full funnel analysis.
- “Show me week-over-week trends for my top 5 campaigns.” Trend detection and pacing analysis.
Full Funnel: Ad Spend to Revenue
Most ad analysis stops at platform-reported conversions. The MCP Deep Ad Analysis SKILL.md goes further. It connects your ad spend data to CRM revenue, so you can see which campaigns actually drive closed deals and revenue, not just leads.
This full-funnel view reveals the true cost of acquisition and helps you optimise for revenue, not vanity metrics. When you ask for a full funnel analysis, the skill queries both ad platform and CRM data through the Flyweel MCP server, then maps the complete path from impression to revenue.
Want to analyse ad data without connecting accounts? Try the Ad Performance Analyser. It works with CSV exports, screenshots, and any data source, no account required. Learn more about MCP and how it works, or follow the MCP setup guide.
MCP Deep Ad Analysis FAQs
Common questions about live ad analysis with the Flyweel MCP server, setup, and connecting your ad platforms.
What is Flyweel MCP Deep Ad Analysis?
Flyweel MCP Deep Ad Analysis is a free, open-source SKILL.md that analyses live Google Ads and Meta Ads campaign data via the Flyweel MCP server. It provides 8 MCP tools, 5 pre-built analysis playbooks, and batches up to 5 queries per API call for efficient data retrieval. Unlike static data analysis, it connects directly to your ad accounts for real-time campaign insights.
What is a SKILL.md?
A SKILL.md is a portable markdown file that gives AI coding agents like Claude Code, Cursor, and Windsurf specialised capabilities. It contains structured prompts, frameworks, and domain knowledge that the agent loads on demand. You install SKILL.md files using the @flyweel/skill CLI, and they work across all major AI coding agents without modification.
What is MCP (Model Context Protocol)?
MCP (Model Context Protocol) is an open standard that lets AI agents connect to external data sources and tools. It allows Claude Code, Cursor, Windsurf, and other AI agents to query live data (like your Google Ads or Meta Ads campaigns) without manual data exports. The Flyweel MCP server provides ad platform and CRM data through this protocol.
How do I get started?
Three steps: (1) Get your free API token at signup.flyweel.co/mcp, no credit card required. (2) Install the SKILL.md with npx @flyweel/skill install flyweel-mcp-deep-ad-analysis. (3) Open your AI agent and start asking questions about your campaigns. The skill batches up to 5 queries per request for fast responses.
Do I need a Flyweel account?
Yes, a free Flyweel account is required to get an API token for the MCP server connection. Sign up at signup.flyweel.co/mcp, no credit card required. The account connects to your Google Ads and Meta Ads platforms so the SKILL.md can query live campaign data.
How is this different from the Ad Performance Analyser?
The MCP Deep Ad Analysis SKILL.md connects to live campaign data via the Flyweel MCP server. You query real-time metrics without exporting anything. The Ad Performance Analyser works offline with any data you paste in (CSV exports, screenshots, API responses) and requires no account. Use MCP for live, connected analysis; use the Analyser for quick one-off reviews of exported data.