
ZuckerBot — Meta Ads MCP Server
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 toolsPublic 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*secretYour 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.
{
"mcpServers": {
"zuckerbot": {
"command": "npx",
"args": ["-y", "zuckerbot-mcp"],
"env": { "ZUCKERBOT_API_KEY": "zb_live_your_key_here" }
}
}
}
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