claude-ads MCP — Use Cases, Install & Live Demo

Why use it

Key features

250+ checks across 7 ad platforms including PMax, Advantage+, Demand Gen, CTV
Ads Health Score (0-100) with letter grade and weighted severity
Industry-specific playbooks (SaaS, e-commerce, local, B2B, healthcare)
4 creative-generation agents for new ad copy and assets
Privacy-infrastructure audit (Consent Mode V2, server-side tagging, CAPI, Events API)

Live Demo

What it looks like in practice

claude-ads-skill.replay ▶ ready

0/0

Install

Pick your client

~/Library/Application Support/Claude/claude_desktop_config.json · Windows: %APPDATA%\Claude\claude_desktop_config.json

{
  "mcpServers": {
    "claude-ads-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-ads",
        "~/.claude/skills/claude-ads"
      ],
      "_inferred": true
    }
  }
}

Open Claude Desktop → Settings → Developer → Edit Config. Restart after saving.

~/.cursor/mcp.json · .cursor/mcp.json

{
  "mcpServers": {
    "claude-ads-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-ads",
        "~/.claude/skills/claude-ads"
      ],
      "_inferred": true
    }
  }
}

Cursor uses the same mcpServers schema as Claude Desktop. Project config wins over global.

VS Code → Cline → MCP Servers → Edit

{
  "mcpServers": {
    "claude-ads-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-ads",
        "~/.claude/skills/claude-ads"
      ],
      "_inferred": true
    }
  }
}

Click the MCP Servers icon in the Cline sidebar, then "Edit Configuration".

~/.codeium/windsurf/mcp_config.json

{
  "mcpServers": {
    "claude-ads-skill": {
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-ads",
        "~/.claude/skills/claude-ads"
      ],
      "_inferred": true
    }
  }
}

Same shape as Claude Desktop. Restart Windsurf to pick up changes.

~/.continue/config.json

{
  "mcpServers": [
    {
      "name": "claude-ads-skill",
      "command": "git",
      "args": [
        "clone",
        "https://github.com/AgriciDaniel/claude-ads",
        "~/.claude/skills/claude-ads"
      ]
    }
  ]
}

Continue uses an array of server objects rather than a map.

~/.config/zed/settings.json

{
  "context_servers": {
    "claude-ads-skill": {
      "command": {
        "path": "git",
        "args": [
          "clone",
          "https://github.com/AgriciDaniel/claude-ads",
          "~/.claude/skills/claude-ads"
        ]
      }
    }
  }
}

Add to context_servers. Zed hot-reloads on save.

claude mcp add claude-ads-skill -- git clone https://github.com/AgriciDaniel/claude-ads ~/.claude/skills/claude-ads

One-liner. Verify with claude mcp list. Remove with claude mcp remove.

Use Cases

Real-world ways to use claude-ads

Audit a Google Ads account before taking it over

👤 Agencies onboarding a new paid-search client ⏱ ~45 min intermediate

When to use: You're bidding for the account and need to show concrete gaps in week one.

Prerequisites

Exported account data or screenshots — Google Ads Editor export or the standard 'all campaigns' CSV

Flow

Feed the skill the export

Run the claude-ads skill on this Google Ads export. Focus on Search + PMax. Give me the health score and top 10 issues.✓ Copied

→ Score with breakdown by category (structure, bidding, creative, tracking)
Drill into PMax specifically

Now deep-dive PMax — asset quality, audience signals, brand-exclusion list. What's the quick-win?✓ Copied

→ Platform-specific findings with remediation priority
Generate the PDF

Export to a client PDF with the score dashboard on page 1 and the remediation roadmap at the end.✓ Copied

→ Polished PDF ready to send

Outcome: A deliverable audit that wins the pitch.

Pitfalls

Audit based on incomplete data gives wrong conclusions — Include 90 days of performance plus settings export, not just a screenshot

Verify Meta Advantage+ privacy infrastructure before iOS 18

👤 In-house paid-social managers ⏱ ~30 min advanced

When to use: Attribution is drifting and you suspect CAPI or Events API isn't firing cleanly.

Flow

Run the privacy-infra check

Use claude-ads to audit our Meta setup for CAPI completeness, event match quality, and Consent Mode V2.✓ Copied

→ Per-event pass/fail with remediation
Get the fix plan

Prioritize fixes by attribution-loss impact.✓ Copied

→ Ordered list tied to revenue impact

Outcome: A concrete privacy-infrastructure punch-list.

Pitfalls

Matching Match Quality fixes without GTM changes — The skill flags when GTM/server-side tag config is also required

Generate 10 new ad creative variants for a failing ad set

👤 Performance marketers in creative refresh ⏱ ~30 min intermediate

When to use: CPMs are climbing and your creatives are fatigued.

Flow

Provide the winning ad + brief

Here's our best-performing Meta ad. Use claude-ads creative agents to generate 10 variants that test different hooks.✓ Copied

→ 10 copy + visual-brief pairs, each with a stated hypothesis
Score the variants

Which 3 should we ship first based on policy safety and hypothesis strength?✓ Copied

→ Short list with reasoning

Outcome: A creative batch with clear hypotheses to test.

Pitfalls

Generated copy violates platform policy — The skill's compliance check catches most issues — but have a human final-check on regulated verticals

Combine with: nano-banana-pro-prompts-recommend-skill

Combinations

Pair with other MCPs for X10 leverage

claude-ads-skill + nano-banana-pro-prompts-recommend-skill

After creative-agents propose variants, generate image prompts for each

For each of the 10 creative variants, use Nano Banana to propose an image prompt.✓ Copied

claude-ads-skill + claude-seo-skill

Align paid landing pages with SEO best practices from /seo audit

Run /seo audit on the landing pages paid traffic is hitting, then cross-reference with claude-ads landing-page quality findings.✓ Copied

Tools

What this MCP exposes

Tool	Inputs	When to call
Platform audit	exported campaign data	Full or partial account review
Ads Health Score	audit results	At the end of each audit
Privacy infrastructure check	tag config or screenshots	Attribution or policy review
Creative generation agents	winning ad + brief	Creative refresh
Financial modeling	conversion rate, AOV, margin	Budget planning

Cost & Limits

What this costs to run

API quota: None for the skill
Tokens per call: Full audit: 15-40k tokens; single-platform: 5-10k
Monetary: Free — skill is local; you still pay for the ad spend it's auditing
Tip: Run platform-by-platform for ongoing clients; full-account audits are best for onboarding and quarterly reviews.

Security

Permissions, secrets, blast radius

Credential storage: No credentials — skill reads exports you paste in. Campaign data stays on your machine.

Data egress: None from the skill itself

Campaign exports can contain PII (customer match lists). Strip before sharing.

Troubleshooting

Common errors and fixes

Score seems too low/high for the account

Check the export completeness — missing conversion data skews the score.

Creative agents miss brand voice

Include a brand voice doc or 3 winning ads as style anchors in the prompt.

PDF export fails

The skill needs a markdown-to-PDF runtime; check the skill's setup section for the required dependency.

Alternatives

claude-ads vs others

Alternative	When to use it instead	Tradeoff
Manual audits via platform UIs	You only manage one account and have time	Thorough but slow; doesn't scale
claude-seo-skill	You need organic / technical SEO instead of paid	Different side of the acquisition funnel

More

Resources

📖 Read the official README on GitHub

🐙 Browse open issues

🔍 Browse all 400+ MCP servers and Skills