<div align="center">

ZuckerBot

The Meta Ads toolkit for AI agents.

50 tools for campaign management, creative analysis, audience building, and conversion tracking. One npx command. Works with Claude, ChatGPT, OpenClaw, Cursor, and any MCP-compatible agent.

{
  "mcpServers": {
    "zuckerbot": {
      "command": "npx",
      "args": ["-y", "zuckerbot-mcp"],
      "env": { "ZUCKERBOT_API_KEY": "zb_live_your_key_here" }
    }
  }
}

Get API Key (free) · npm · Docs · Website

</div>

---

Why ZuckerBot?

Your agent already writes code, manages files, and searches the web. It should manage your ads too.

ZuckerBot gives any AI agent full Meta Ads capabilities through MCP. No dashboard, no UI to learn, no platform to log into. Your agent installs it, connects your ad account, and gets to work.

What agents can do with ZuckerBot:

• Pull campaign performance and spot what's working
• Analyse ad creatives and recommend what to test next
• Build and launch campaigns with targeting and budget
• Create custom and lookalike audiences
• Set up server-side conversion tracking (CAPI)
• Research competitors, reviews, and market benchmarks
• Generate ad creative briefs and copy

How it works

You ↔ Your Agent (Claude, ChatGPT, OpenClaw, Cursor, etc.)
                  ↕
            ZuckerBot MCP
                  ↕
         Meta Marketing API

ZuckerBot handles the Meta API complexity. Your agent handles the conversation. You make the decisions.

Install

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "zuckerbot": {
      "command": "npx",
      "args": ["-y", "zuckerbot-mcp"],
      "env": { "ZUCKERBOT_API_KEY": "zb_live_your_key_here" }
    }
  }
}

OpenClaw

Add to your MCP config:

{
  "mcpServers": {
    "zuckerbot": {
      "command": "npx",
      "args": ["-y", "zuckerbot-mcp"],
      "env": { "ZUCKERBOT_API_KEY": "zb_live_your_key_here" }
    }
  }
}

Cursor / Windsurf / Any MCP Client

Same config pattern. ZuckerBot works with any client that supports the Model Context Protocol.

CLI (for humans)

npm install -g zuckerbot-mcp

zuckerbot preview https://your-business.com
zuckerbot meta status
zuckerbot create https://your-business.com --budget 5000 --objective leads

Tools (50)

Setup & Account (7)

Tool	What it does
quickstart	Guided setup: check auth, show next steps, recommended tool flow
meta_status	Check Meta connection status for your API key
list_ad_accounts	List available Meta ad accounts and current selection
select_ad_account	Connect a specific ad account
list_meta_pages	List Facebook pages and current selection
select_meta_page	Set active page for ad delivery
get_launch_credentials	Verify all required credentials are set before launching

Campaigns (9)

Tool	What it does
preview_campaign	Generate ad preview from a URL (no Meta account needed)
create_campaign	Create a campaign draft with strategy, targeting, and creatives
get_campaign	Get campaign detail, workflow state, and linked creatives
approve_campaign_strategy	Approve tiers and creative angles for an intelligence campaign
suggest_angles	Get proposed creative angles and audience tiers for a draft
activate_campaign	Activate ready tiers and begin ad delivery
launch_campaign	Launch one or all variants from a draft on Meta
pause_campaign	Pause or resume a live campaign
get_performance	Real-time campaign metrics: spend, leads, CPL, CTR, ROAS

Audiences (6)

Tool	What it does
create_seed_audience	Build a custom audience from hashed CAPI users
create_lookalike_audience	Create a lookalike from any seed audience
list_audiences	List all custom and lookalike audiences
refresh_audience	Refresh an audience or sync latest state from Meta
get_audience_status	Check audience size, status, and readiness
delete_audience	Remove an audience from Meta and ZuckerBot

Creatives (8)

Tool	What it does
generate_creatives	Generate ad copy and images (or Kling video)
request_creative	Create a creative handoff package for production
upload_creative	Upload finished assets and provision paused Meta ads
get_creative_status	Check creative generation progress
creative_analysis	AI analysis of ad creative performance with recommendations
creative_qa	Quality check creatives against Meta ad policies
generate_briefs	Generate creative briefs based on performance data

Conversion Tracking / CAPI (5)

Tool	What it does
capi_config	Get or update server-side conversion tracking config
capi_status	7-day and 30-day CAPI delivery and attribution stats
capi_test	Send a test event through the CAPI pipeline
sync_conversion	Send lead quality feedback to Meta's algorithm
list_pixels	List and select Meta pixels for conversion tracking

Portfolios (5)

Tool	What it does
create_portfolio	Create an audience portfolio from a template
launch_portfolio	Launch all campaigns in a portfolio
portfolio_performance	Tier-by-tier portfolio performance breakdown
rebalance_portfolio	Dry-run or apply budget rebalancing across tiers

Research (3)

Tool	What it does
research_reviews	Review intelligence for any business
research_competitors	Competitor ad analysis by industry and location
research_market	Market intelligence and ad benchmarks

Business Context (4)

Tool	What it does
enrich_business	Crawl a website and cache structured business context
upload_business_context	Upload text content and extract business insights
list_business_context	List uploaded context files and summaries
select_lead_form	Select a lead form for campaign targeting

Typical Agent Flow

1. Research    →  research_reviews + research_competitors (parallel)
2. Preview     →  preview_campaign (show user what ads look like)
3. Create      →  create_campaign (draft with strategy + targeting)
4. Approve     →  approve_campaign_strategy
5. Creative    →  request_creative or upload_creative
6. Activate    →  activate_campaign
7. Monitor     →  get_performance + creative_analysis
8. Optimise    →  sync_conversion + audience tools

Every tool returns a _hint field suggesting the logical next step, so your agent always knows what to do next.

ZuckerBot vs alternatives

	ZuckerBot	Pipeboard	AdAmigo.ai	Supermetrics
What it is	Meta Ads toolkit for agents	Basic Meta MCP	Full ad management agent	Data extraction
Tools	50	~20	N/A (platform)	N/A (connectors)
Creative analysis	✅ AI-powered	❌	✅ Platform-only	❌
CAPI support	✅ Full pipeline	❌	Partial	❌
Audience builder	✅ Seed + LAL	❌	✅ Platform-only	❌
Works with any agent	✅ MCP standard	✅ MCP standard	❌ Locked to platform	❌
Price	Free tier available	Free	$349/mo/account	$39-299/mo

Pricing

Tier	Monthly	API Calls	Tools
Free	$0	1,000/mo	Read-only (performance, analysis, research)
Pro	$49 + 0.1% of ad spend	50,000/mo	All tools including campaign management
Scale	$149 + 0.05% of ad spend	500,000/mo	All tools + multi-account + priority rate limits

Free tier gets you started. Pro pays for itself with one optimised campaign.

Get your API key

Example conversation

You: How are my Meta campaigns doing this week?

Agent calls get_account_insights + creative_analysis

Agent: You spent $2,340 across 4 campaigns this week. Your LAL campaign is crushing it at $28 CPL — that's 40% below your account average. But your broad targeting campaign is at $95 CPL and burning budget. The "customer testimonial" creative has a 3.2% CTR vs 1.1% for your product shots. I'd recommend pausing the broad campaign and shifting that budget to the LAL.

You: Do it.

Agent calls pause_campaign + (budget adjustment)

Development

git clone https://github.com/DatalisHQ/zuckerbot.git
cd zuckerbot/mcp-server
npm install
npm run build
npm start

License

MIT