Free Tool # MCP Deep Ad Analysis SKILL.md for Google Ads & Meta Ads *Flyweel Team · Mar 11, 2026 ## What Is MCP Deep Ad Analysis?[](#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 Free API Token](https://signup.flyweel.co/mcp) ## Get Started in 3 Steps[](#get-started-in-3-steps) ### Step 1: Get Your Free API Token[](#step-1-get-your-free-api-token) Sign up to get your Flyweel API token. No credit card required. The token connects your AI agent to the Flyweel MCP server. [Sign Up Free](https://signup.flyweel.co/mcp) ### Step 2: Install the SKILL.md[](#step-2-install-the-skillmd) ``` 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[](#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. ## Available MCP Tools[](#available-mcp-tools) 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[](#pre-built-analysis-playbooks) Five ready-to-use playbooks cover the most common analysis scenarios: ### Performance Overview[](#performance-overview) 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[](#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[](#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[](#campaign-deep-dive) Granular analysis of a single campaign: ad group performance, keyword/audience breakdown, creative performance, and day-parting patterns. ### Full Funnel Analysis[](#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[](#metrics--dimensions) ### Ad Platform Metrics[](#ad-platform-metrics) | 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)[](#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[](#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[](#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. [Get Free API Token](https://signup.flyweel.co/mcp) --- Want to analyse ad data without connecting accounts? Try the [Ad Performance Analyser](/tools/ad-performance-analyser). It works with CSV exports, screenshots, and any data source, no account required. Learn more about [MCP and how it works](/mcp), or follow the [MCP setup guide](/docs/mcp/setup).* ## 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. ### MCP Deep Ad Analysis SKILL.md for Google Ads & Meta Ads Free SKILL.md that analyses live Google Ads and Meta Ads campaign data via MCP. Works with Claude Code, Gemini CLI, Codex, Cursor and Windsurf. Connects ad spend to CRM revenue. ![MCP Deep Ad Analysis SKILL.md for Google Ads & Meta Ads](/_vercel/image?url=_astro%2Fflyweel-mcp-deep-ad-analysis-cover.CDPWZc4w.webp&w=640&q=100&dpl=dpl_BcV6xhMKU9y9WM8N74w6tMd3fXoj) #### Get Started Free Free API token, no credit card required. [Get Free API Token](https://signup.flyweel.co/mcp)[View on GitHub](https://github.com/openairlabs/flyweel-mcp-deep-ad-analysis) #### Requirements Requires free Flyweel account for MCP server access. #### Supported Agents Claude Code · Cursor · Windsurf · Codex CLI · Gemini CLI · OpenCode #### Docs Setup guides, MCP config, and CLI reference. [SKILL.md CLI Docs](https://docs.flyweel.co/mcp/skill-cli)[MCP Setup Guide](https://docs.flyweel.co/mcp/setup) #### Related Skill Don't need live data? Try the Ad Performance Analyser. [Ad Performance Analyser](/tools/ad-performance-analyser) ### Related Articles [### What Is WebMCP? The Web Standard That Lets AI Use Your Ad Tools WebMCP is a W3C web standard bringing AI context to any website. Here's what it means for businesses that advertise and finance teams. WebMCP MCP](/blog/what-is-webmcp)[### Stop Trading Time for Revenue: Build a Lead Gen Brand That Gets Acquired Agency owners switching to pay-per-lead cut buyer CPA by 23% and break the $21K/month ceiling. Four-stage framework, margins, stack and buyer agreements. lead generation agency to brand](/blog/agency-to-lead-gen-brand)[### OpenAI Launches ChatGPT Ads: What to Expect After the Pilot OpenAI has launched ChatGPT Ads. Discover what to expect after the pilot, key insights, and strategies for marketers. OpenAI Launches ChatGPT ChatGPT Ads](/blog/openai-launches-chatgpt-ads)