datalishq avatar

ZuckerBot — Meta Ads MCP Server

datalishq/zuckerbot

Wraps the Meta Marketing API in 50 MCP tools so your agent can manage Facebook and Instagram ads end to end. You get campaign creation and performance pulls, creative analysis and generation, custom and lookalike audience building, server-side conversion tracking through CAPI, and competitor research. The flow is designed for conversational use: preview a campaign from a URL, create a draft with targeting strategy, approve tiers, request or upload creatives, activate, then monitor with metrics like CPL and ROAS. Each tool returns a hint field to guide next steps. Requires a ZuckerBot API key and works with any MCP-compatible client. Useful when you want programmatic Meta Ads control without touching the Ads Manager UI.

GitHub stars
13
tools
50
auth
Secret needed
transport
STDIO, HTTP
env var
1
last updated
Jul 27, 2026

Tools

50 tools

Public tool metadata for what this MCP can expose to an agent.

audit_accountFull read-only account audit: spend flagged for review against each campaign's objective, creative fatigue, opportunity score (0-100), projected CPL improvement, prioritised action items.

Full read-only account audit: spend flagged for review against each campaign's objective, creative fatigue, opportunity score (0-100), projected CPL improvement, prioritised action items.

No parameter schema in public metadata yet.

redeem_licenseRedeem a lifetime licence code (Dealify/AppSumo) and upgrade all API keys on the account

Redeem a lifetime licence code (Dealify/AppSumo) and upgrade all API keys on the account

No parameter schema in public metadata yet.

quickstartGuided setup: check auth, show next steps, recommended tool flow

Guided setup: check auth, show next steps, recommended tool flow

No parameter schema in public metadata yet.

meta_statusCheck Meta connection status for your API key

Check Meta connection status for your API key

No parameter schema in public metadata yet.

list_ad_accountsList available Meta ad accounts and current selection

List available Meta ad accounts and current selection

No parameter schema in public metadata yet.

select_ad_accountConnect a specific ad account

Connect a specific ad account

No parameter schema in public metadata yet.

list_meta_pagesList Facebook pages and current selection

List Facebook pages and current selection

No parameter schema in public metadata yet.

select_meta_pageSet active page for ad delivery

Set active page for ad delivery

No parameter schema in public metadata yet.

get_launch_credentialsVerify all required credentials are set before launching

Verify all required credentials are set before launching

No parameter schema in public metadata yet.

preview_campaignGenerate ad preview from a URL (no Meta account needed)

Generate ad preview from a URL (no Meta account needed)

No parameter schema in public metadata yet.

create_campaignCreate a campaign draft with strategy, targeting, and creatives

Create a campaign draft with strategy, targeting, and creatives

No parameter schema in public metadata yet.

get_campaignGet campaign detail, workflow state, and linked creatives

Get campaign detail, workflow state, and linked creatives

No parameter schema in public metadata yet.

approve_campaign_strategyApprove tiers and creative angles for an intelligence campaign

Approve tiers and creative angles for an intelligence campaign

No parameter schema in public metadata yet.

suggest_anglesGet proposed creative angles and audience tiers for a draft

Get proposed creative angles and audience tiers for a draft

No parameter schema in public metadata yet.

activate_campaignTemporarily unavailable; intelligence campaigns remain planning-only

Temporarily unavailable; intelligence campaigns remain planning-only

No parameter schema in public metadata yet.

launch_campaignLaunch one or all variants from a draft on Meta

Launch one or all variants from a draft on Meta

No parameter schema in public metadata yet.

pause_campaignPause a campaign, ad set or ad, including spec-built Meta campaigns

Pause a campaign, ad set or ad, including spec-built Meta campaigns

No parameter schema in public metadata yet.

resume_campaignPreview and explicitly activate one existing Meta campaign, ad set or ad

Preview and explicitly activate one existing Meta campaign, ad set or ad

No parameter schema in public metadata yet.

get_performanceReal-time campaign metrics: spend, leads, CPL, CTR, ROAS

Real-time campaign metrics: spend, leads, CPL, CTR, ROAS

No parameter schema in public metadata yet.

create_seed_audienceBuild a custom audience from hashed CAPI users

Build a custom audience from hashed CAPI users

No parameter schema in public metadata yet.

create_lookalike_audienceCreate a lookalike from any seed audience

Create a lookalike from any seed audience

No parameter schema in public metadata yet.

list_audiencesList all custom and lookalike audiences

List all custom and lookalike audiences

No parameter schema in public metadata yet.

refresh_audienceRefresh an audience or sync latest state from Meta

Refresh an audience or sync latest state from Meta

No parameter schema in public metadata yet.

get_audience_statusCheck audience size, status, and readiness

Check audience size, status, and readiness

No parameter schema in public metadata yet.

delete_audienceRemove an audience from Meta and ZuckerBot

Remove an audience from Meta and ZuckerBot

No parameter schema in public metadata yet.

upload_creativeUpload finished assets and provision paused Meta ads

Upload finished assets and provision paused Meta ads

No parameter schema in public metadata yet.

get_creative_statusCheck creative generation progress

Check creative generation progress

No parameter schema in public metadata yet.

creative_analysisAI analysis of ad creative performance with recommendations

AI analysis of ad creative performance with recommendations

No parameter schema in public metadata yet.

creative_qaQuality check creatives against Meta ad policies

Quality check creatives against Meta ad policies

No parameter schema in public metadata yet.

generate_briefsGenerate creative briefs based on performance data

Generate creative briefs based on performance data

No parameter schema in public metadata yet.

generate_creativesGenerate ad copy and images (or AI video)

Generate ad copy and images (or AI video)

No parameter schema in public metadata yet.

request_creativeCreate a creative handoff package for production

Create a creative handoff package for production

No parameter schema in public metadata yet.

capi_configGet or update server-side conversion tracking config

Get or update server-side conversion tracking config

No parameter schema in public metadata yet.

capi_status7-day and 30-day CAPI delivery and attribution stats

7-day and 30-day CAPI delivery and attribution stats

No parameter schema in public metadata yet.

capi_testSend a test event through the CAPI pipeline

Send a test event through the CAPI pipeline

No parameter schema in public metadata yet.

sync_conversionSend lead quality feedback to Meta's algorithm

Send lead quality feedback to Meta's algorithm

No parameter schema in public metadata yet.

list_pixelsList and select Meta pixels for conversion tracking

List and select Meta pixels for conversion tracking

No parameter schema in public metadata yet.

get_campaign_insightsCampaign / ad set / ad-level Meta performance for any campaign in the account (including non-ZuckerBot ones), with deduped lead metrics

Campaign / ad set / ad-level Meta performance for any campaign in the account (including non-ZuckerBot ones), with deduped lead metrics

No parameter schema in public metadata yet.

get_account_insightsAccount-wide spend, impressions, CTR, CPM, CPC, and frequency aggregated daily or monthly

Account-wide spend, impressions, CTR, CPM, CPC, and frequency aggregated daily or monthly

No parameter schema in public metadata yet.

create_portfolioCreate an audience portfolio from a template

Create an audience portfolio from a template

No parameter schema in public metadata yet.

launch_portfolioTemporarily unavailable; portfolios remain planning/monitoring-only

Temporarily unavailable; portfolios remain planning/monitoring-only

No parameter schema in public metadata yet.

portfolio_performanceTier-by-tier portfolio performance breakdown

Tier-by-tier portfolio performance breakdown

No parameter schema in public metadata yet.

rebalance_portfolioDry-run or apply budget rebalancing across tiers

Dry-run or apply budget rebalancing across tiers

No parameter schema in public metadata yet.

research_reviewsReview intelligence for any business

Review intelligence for any business

No parameter schema in public metadata yet.

research_competitorsCompetitor ad analysis by industry and location

Competitor ad analysis by industry and location

No parameter schema in public metadata yet.

research_marketMarket intelligence and ad benchmarks

Market intelligence and ad benchmarks

No parameter schema in public metadata yet.

enrich_businessCrawl a website and cache structured business context

Crawl a website and cache structured business context

No parameter schema in public metadata yet.

upload_business_contextUpload text content and extract business insights

Upload text content and extract business insights

No parameter schema in public metadata yet.

list_business_contextList uploaded context files and summaries

List uploaded context files and summaries

No parameter schema in public metadata yet.

select_lead_formSelect a lead form for campaign targeting

Select a lead form for campaign targeting

No parameter schema in public metadata yet.

Sponsors

Configuration

ZUCKERBOT_API_KEY*secret

Your ZuckerBot API key from zuckerbot.ai

Readme

ZuckerBot

The Meta Ads toolkit for AI agents.

Audit your ad account in one message. 50+ tools for account auditing, 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" }
    }
  }
}

View the full README on GitHub

Details

Repository
github.com/datalishq/zuckerbot
Website
zuckerbot.ai
Categories
Sales & Marketing, Finance & Commerce
Package
zuckerbot-mcp
Transport
STDIO, HTTP
Auth
Required
Registry
MCP registry, active

Related Sales & Marketing MCP servers

View all
1ashev87 avatarPropstack Mcpashev87/propstack-mcpConnect AI assistants to your Propstack real estate CRM (contacts, properties, deals).9stars
2theastraway avatarMINDtheastraway/mind-mcp-serverMIND knowledge-graph memory for agents. 44 tools: CRM, Life, MoneyMIND, Budget, Sheets, Email, Sign.7stars
3douglac avatarConta Azul MCPdouglac/contaazul-mcpConta Azul ERP MCP — sales, customers, finance and NF-e via OAuth 2.0. Read + write, 35 tools.6stars
4stewyboy1990 avatarCompanyscope Mcpstewyboy1990/companyscope-mcp11 company intelligence tools — financials, tech stack, competitors, patents, jobs, news. Free.4stars
5verygoodplugins avatarEasy Digital Downloadsverygoodplugins/mcp-eddMCP server for Easy Digital Downloads REST API - sales, customers, products, analytics4stars
6shashwatgtm avatarIcp Intelligence Mcpshashwatgtm/icp-intelligence-mcpICP Intelligence: 9 ideal customer profile tools by Helix GTM Consulting3stars