← Back to Skills Marketplace
benkalsky

Meta Ads MCP

by Ben Kalsky · GitHub ↗ · v1.0.0 · MIT-0
cross-platform ✓ Security Clean
32
Downloads
0
Stars
0
Active Installs
1
Versions
Install in OpenClaw
/install meta-ads-mcp
Description
Operational guide for creating, managing, optimizing, and documenting Meta (Facebook/Instagram) ad campaigns via the Facebook Ads MCP. Use whenever the user...
README (SKILL.md)

Meta Ads MCP — Operational Guide

Scope: How to create, manage, update, pause, and document Meta (Facebook/Instagram) ad campaigns using the Facebook Ads MCP. Covers account setup, campaign architecture, targeting, creative, tracking, retargeting, documentation, and safety guardrails.

How to use this skill

This file is the entrypoint. Detailed playbooks live in references/. Load only the file relevant to the current task:

Task Reference
Pick the right ad account, build campaign hierarchy, name entities references/campaign-architecture.md
Set budgets, choose cold/warm/hot audiences, apply exclusions references/budget-and-audience.md
Choose ad format, write copy frameworks, generate creative assets references/creative-and-copy.md
Install Pixel/CAPI, define events, build retargeting structure references/tracking-and-retargeting.md
Create campaigns via MCP, monitor KPIs, document decisions references/campaign-operations.md
Run pre-campaign intake before launch references/intake-questions.md
Follow hard safety rules and account-health guardrails references/safety-guardrails.md

Core workflow — always follow this order

  1. Verify the accountads_get_ad_accounts, ads_get_pages_for_business, ads_get_dataset_details. Never proceed with an unverified pixel or unlinked page.
  2. Run intake — gather goal, audience, creative, budget, timeline, and landing page. Do not invent answers.
  3. Plan structure — pick objective, decide CBO vs ABO, draft 3–5 ad sets and 3–5 ads per set with consistent names.
  4. Create everything PAUSED — campaign → ad set → ad, all with status: PAUSED.
  5. Preview + verify — check pixel attachment, destination URL, ad preview, and naming in Ads Manager UI before activation.
  6. Activate only after approval — flip status to ACTIVE only after the full review is signed off.
  7. Document — log the campaign brief, audiences, creatives, performance, and decisions in the campaign documentation folder.

Non-negotiable safety rules

These are summarized here; full list in references/safety-guardrails.md.

  • PAUSE, never delete. Deletes destroy historical learning and cannot be reversed.
  • Always create in PAUSED status. No exceptions.
  • Never edit budget by more than 20% at once — larger jumps reset the Learning Phase.
  • Never run a campaign without a verified pixel.
  • Never touch a campaign in Learning Phase — first 7 days / ~50 events.
  • Special ad categories must be declared — housing, credit, employment, political/social issues.
  • Detailed interest targeting was deprecated January 2026. Use Advantage+ Audience or broad targeting + strong creative.

Key MCP tools — quick reference

Account & assets:
  ads_get_ad_accounts              list accessible ad accounts
  ads_get_pages_for_business       list pages under a Business Manager
  ads_catalog_get_catalogs         check product catalogs for dynamic ads
  ads_get_dataset_details          verify Pixel/dataset installation
  ads_get_dataset_quality          check Event Match Quality (target 7+/10)

Creation:
  ads_create_campaign              create campaign (always status: PAUSED)
  ads_create_ad_set                create ad set under a campaign
  ads_create_ad                    create ad under an ad set
  ads_activate_entity              flip status; use PAUSED to disable, never delete

Reporting:
  ads_get_ad_entities              pull campaign/ad set/ad performance
  ads_insights_performance_trend   analyze trends over time
  ads_insights_anomaly_signal      detect unusual patterns
  ads_get_opportunity_score        review Meta recommendations

Related skills

  • facebook-ads — full ad copy generation: copy variations, headlines, CTA options, and visual concepts.
  • image generation skills — generate ad creatives in 1:1, 4:5, and 9:16 formats.
Usage Guidance
Install this only if you want the agent to help operate real Meta ads. Use least-privileged MCP access, verify the exact ad account before any action, keep campaigns paused until human review, require explicit approval for activation and budget changes, set spending limits, and confirm privacy consent before using customer lists or Pixel/CAPI tracking.
Capability Analysis
Type: OpenClaw Skill Name: meta-ads-mcp Version: 1.0.0 The meta-ads-mcp skill bundle is a comprehensive operational guide for managing Meta advertising campaigns via a Model Context Protocol (MCP) server. The instructions in SKILL.md and the reference files (e.g., safety-guardrails.md, campaign-operations.md) focus on legitimate marketing workflows, including account verification, campaign architecture, and performance tracking. The bundle includes strong safety guardrails, such as mandatory 'PAUSED' status for new entities and budget change limits, and lacks any indicators of malicious intent, data exfiltration, or unauthorized execution.
Capability Tags
cryptocan-make-purchases
Capability Assessment
Purpose & Capability
The stated purpose and files consistently support Meta/Facebook/Instagram ad operations; users should notice that SKILL.md covers creating, managing, updating, pausing, and activating paid campaigns.
Instruction Scope
The workflow includes useful guardrails such as creating campaigns PAUSED and activating only after approval, but users should still require explicit confirmation for budget, activation, and account-changing actions.
Install Mechanism
There is no install spec, no binaries, no environment variables, and no code files; the static scanner had nothing suspicious to analyze.
Credentials
Use of Meta Business Manager, Facebook Ads MCP tools, Pixel/CAPI, retargeting, customer-list matching, and Google Drive documentation is proportionate to ad operations but involves business accounts and customer data.
Persistence & Privilege
No background worker or autonomous persistence is shown, but the guide instructs maintaining campaign documentation and retargeting structures that may persist outside the chat.
How to Use
  1. Make sure OpenClaw is installed (local or Docker)
  2. Run the install command in chat: /install meta-ads-mcp
  3. After installation, invoke the skill by name or use /meta-ads-mcp
  4. Provide required inputs per the skill's parameter spec and get structured output
Version History
v1.0.0
Initial public release: OpenClaw skill for safe Meta/Facebook/Instagram ads planning, launch preparation, tracking, optimization, and documentation through a Facebook Ads MCP workflow.
Metadata
Slug meta-ads-mcp
Version 1.0.0
License MIT-0
All-time Installs 0
Active Installs 0
Total Versions 1
Frequently Asked Questions

What is Meta Ads MCP?

Operational guide for creating, managing, optimizing, and documenting Meta (Facebook/Instagram) ad campaigns via the Facebook Ads MCP. Use whenever the user... It is an AI Agent Skill for Claude Code / OpenClaw, with 32 downloads so far.

How do I install Meta Ads MCP?

Run "/install meta-ads-mcp" in the OpenClaw or Claude Code chat to install it in one step — no extra setup required.

Is Meta Ads MCP free?

Yes, Meta Ads MCP is completely free, licensed under MIT-0. You can download, install and use it at no cost.

Which platforms does Meta Ads MCP support?

Meta Ads MCP is cross-platform and runs anywhere OpenClaw / Claude Code is available (cross-platform).

Who created Meta Ads MCP?

It is built and maintained by Ben Kalsky (@benkalsky); the current version is v1.0.0.

💬 Comments