Skip to main content
Glama
DatalisHQ

ZuckerBot

by DatalisHQ

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.

npm version License: MIT MCP Registry GitHub stars

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

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


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

Related MCP server: muze-mcp

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

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/DatalisHQ/zuckerbot'

If you have feedback or need assistance with the MCP directory API, please join our Discord server