Skip to content
Free Tool

MCP Deep Ad Analysis SKILL.md for Google Ads & Meta Ads

Flyweel Team avatarFlyweel Team ·

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.

Available MCP Tools

The SKILL.md orchestrates 8 MCP tools provided by the Flyweel server:

ToolDescription
get_setup_statusCheck MCP server connection and authentication status
list_ad_accountsList all connected Google Ads and Meta Ads accounts
connect_ad_platformConnect a new ad platform to your Flyweel account
select_ad_accountsChoose which ad accounts to analyse
trigger_syncStart a data sync from your ad platforms
get_sync_statusCheck progress of an ongoing data sync
get_connection_statusVerify platform connection health
query_metricsQuery ad performance metrics with filters and date ranges

Pre-Built Analysis Playbooks

Five ready-to-use playbooks cover the most common analysis scenarios:

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

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

Ad Platform Metrics

MetricDescription
SpendTotal ad spend in your account currency
ImpressionsNumber of times ads were shown
ClicksNumber of ad clicks
ConversionsPlatform-reported conversions
CTRClick-through rate (clicks / impressions)
CPCCost per click
CPMCost per 1,000 impressions
CPA / CPLCost per acquisition or lead
ROASReturn on ad spend
Conversion RateConversions / clicks

CRM Metrics (Full Funnel)

MetricDescription
Deals CreatedNew deals attributed to ad campaigns
RevenueClosed revenue from ad-sourced deals
Pipeline ValueOpen pipeline from ad-sourced leads
Win RatePercentage of ad-sourced deals that close
Sales VelocityAverage time from lead to closed deal
True ROASRevenue / 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.

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

Get Started Free

Free API token, no credit card required.

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.

Related Skill

Don't need live data? Try the Ad Performance Analyser.

Related Articles