What it does
60+ Meta Ads tools for AI agents: audits, campaign management, audiences and CAPI tracking.
- Connects Computer oder Cloud
- Account or key Cloud: Sign in to the service when you connect (OAuth) · Local: Needs ZUCKERBOT_API_KEY
- Category Marketing & Social Media
Zusammen nutzen mit
Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem
Warum es hier steht
Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert
| Beliebtheit | 0/80 | GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20 |
|---|---|---|
| Aktualität | 7/12 | Volle Punkte für Release oder Codeänderung in 30 Tagen |
| Antwortet noch | 8/8 | Der Cloud-Endpoint antwortete bei der letzten Prüfung |
| Nutzungswert | 15/100 |
Qualität: 4/5 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)
Installation
Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.
Mit einem Satz von deiner KI installieren lassen
Installiere bitte ZuckerBot — Meta Ads MCP Server. Folge https://mcp.popnx.com/i/crumbedsausage-zuckerbot.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen
4/5 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (zuckerbot.ai) · ✓ Befehle geprüft am 13. Nov. 2026
Zuerst: Welche KI nutzt du?
Wähle deine App, dann erscheinen die Schritte unten.
Klappt mit Claude · etwa 2 Min.
Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu
Öffne die Connectors-Seite von Claude
CustomizeConnectors
Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus
Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue
Name · NameZuckerBot — Meta Ads MCP ServerRemote MCP server URL · Adressehttps://zuckerbot.ai/api/mcpKlicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add
Im Chat einschalten
+ConnectorsZuckerBot — Meta Ads MCP Server
Ausprobieren
Nutze ZuckerBot — Meta Ads MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude sagt, dass es ZuckerBot — Meta Ads MCP Server nutzt, oder ein Werkzeug von ZuckerBot — Meta Ads MCP Server in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit ChatGPT je nach Tarif
Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web
In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen
Plugins+Add custom MCP server
Name und Adresse eintragen
Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken
Name · NameZuckerBot — Meta Ads MCP ServerConnection · Adressehttps://zuckerbot.ai/api/mcpZuckerBot — Meta Ads MCP Server im Chat auswählen
Neuen Chat öffnen und vor dem Tippen ZuckerBot — Meta Ads MCP Server aus deinen Plugins wählen
Ausprobieren
Nutze ZuckerBot — Meta Ads MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn ChatGPT sagt, dass es ZuckerBot — Meta Ads MCP Server nutzt, oder ein Werkzeug von ZuckerBot — Meta Ads MCP Server in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Claude Code · etwa 2 Min.
Kein Schlüssel, nichts zu installieren
Terminal öffnen
Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen
Diesen Befehl einfügen und Enter drücken
claude mcp add --transport http --scope user zuckerbot https://zuckerbot.ai/api/mcp/mcp in Claude Code eingeben
ZuckerBot — Meta Ads MCP Server sollte in der Liste als verbunden erscheinen
Ausprobieren
Nutze ZuckerBot — Meta Ads MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Claude Code sagt, dass es ZuckerBot — Meta Ads MCP Server nutzt, oder ein Werkzeug von ZuckerBot — Meta Ads MCP Server in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit Cursor · etwa 2 Min.
Kein Schlüssel, nichts zu installieren
KI-Chat in Cursor im Agent-Modus öffnen
Ausprobieren
Nutze ZuckerBot — Meta Ads MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn Cursor sagt, dass es ZuckerBot — Meta Ads MCP Server nutzt, oder ein Werkzeug von ZuckerBot — Meta Ads MCP Server in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Klappt mit VS Code · etwa 2 Min.
Kein Schlüssel, nichts zu installieren
Mit diesem Button VS Code öffnen
VS Code fragt nach einer Bestätigung; klicke Install
KI-Chat in VS Code im Agent-Modus öffnen
Ausprobieren
Nutze ZuckerBot — Meta Ads MCP Server und sag mir, was du für mich tun kannst; zeig mir dann eine Sache✓ Wenn VS Code sagt, dass es ZuckerBot — Meta Ads MCP Server nutzt, oder ein Werkzeug von ZuckerBot — Meta Ads MCP Server in der Antwort zeigt, bist du verbunden
Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen
Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach
Adresse für Apps, die über das Web verbinden
https://zuckerbot.ai/api/mcpJSON-Einstellungen stehen unten unter „Für Entwickler“
Für Entwickler: Terminal-Befehle und JSON-Einstellungen
Über das Web
Claude Code
claude mcp add --transport http --scope user zuckerbot https://zuckerbot.ai/api/mcpCursor (~/.cursor/mcp.json)
{
"mcpServers": {
"zuckerbot": {
"url": "https://zuckerbot.ai/api/mcp"
}
}
}VS Code (mcp.json)
{
"servers": {
"zuckerbot": {
"type": "http",
"url": "https://zuckerbot.ai/api/mcp"
}
}
}Auf deinem Computer installiert
Claude Code
claude mcp add --scope user zuckerbot --env ZUCKERBOT_API_KEY=your-value -- npx -y zuckerbot-mcpClaude Desktop (claude_desktop_config.json)
{
"mcpServers": {
"zuckerbot": {
"command": "npx",
"args": [
"-y",
"zuckerbot-mcp"
],
"env": {
"ZUCKERBOT_API_KEY": "your-value"
}
}
}
}Cursor (~/.cursor/mcp.json)
{
"mcpServers": {
"zuckerbot": {
"command": "npx",
"args": [
"-y",
"zuckerbot-mcp"
],
"env": {
"ZUCKERBOT_API_KEY": "your-value"
}
}
}
}VS Code (mcp.json)
{
"servers": {
"zuckerbot": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"zuckerbot-mcp"
],
"env": {
"ZUCKERBOT_API_KEY": "your-value"
}
}
}
}Werte, die du selbst einträgst
ZUCKERBOT_API_KEYgeheim erforderlich envDein ZuckerBot-API-Schlüssel von zuckerbot.ai.Englisches Original anzeigen
Your ZuckerBot API key from zuckerbot.ai
Beschreibungen automatisch übersetzt; Variablennamen bleiben wie im Original. Im Zweifel das Original ansehen.
Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.
Auf einen Blick
- GitHub-Sternei
- 13 (Sterne gehören zu einem anderen Repo)
Dieser Eintrag verweist auf das Repo einer anderen Person, daher zählen die Sterne nicht in Ranglisten - Downloads pro Wochei
- 113/Wo.
- Verbindung
- Computer oder Cloud
- Neueste Versioni
- 0.4.4
- Kategoriei
- Marketing & Social Media
- In der Registry veröffentlichti
- 27. Juli 2026
- Code zuletzt geänderti
- 16. Sept. 2026
- Zuletzt geprüft
- 15. Nov. 2026
- Entwickler
- DatalisHQ
- Pakete
npm: zuckerbot-mcp- Website
- zuckerbot.ai
- Registry-Status
- Aktiv
Welche Apps ihn nutzen können
Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.
Verbinden sich über das Internet in
ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast
Laufen auf deinem Computer in
ClaudeGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatRaycast
Was er kann
Der Server verlangt eine Anmeldung, bevor er seine Tools auflistet.
Basischecksi
Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 19. Nov. 2026
- ! Vorsicht
Entwickler passt zum Repo
Der Herausgeber (Crumbedsausage) ist nicht der Repo-Inhaber (DatalisHQ); vielleicht hat jemand anderes ihn eingetragen
- ✓ Bestanden
Wird noch gepflegt
Code zuletzt geändert: vor 2 Monaten
- ✓ Bestanden
Hat eine Lizenz
Nutzt MIT
- ✓ Bestanden
Endpunkt antwortet
Antwort in 419 ms (HTTP 401)
- ✓ Bestanden
Anmeldung mit OAuth
Gibt OAuth-Anmeldung an, damit deine KI-App dich zum Einloggen weiterleiten kann
- … Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Noch nicht geprüft; wir lesen die Tool-Liste, wenn wir den Endpunkt prüfen
Veröffentlichte Schwachstellen (OSV.dev)
Keine Einträge auf OSV.dev für zuckerbot-mcp@0.4.4
Prüft nur diese Paketversion, nicht alle Abhängigkeiten · geprüft 15. Nov. 2026
Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README
Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.
[](https://mcp.popnx.com/en/servers/crumbedsausage-zuckerbot)Diskussion
Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.
Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.
Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.
Nutzerbewertungen
Noch keine Bewertungen
Im Vergleich mit anderen in Marketing & Social Mediai
- Mehr Sterne als 0 % der anderen 4175 Server in dieser Kategorie
- Neuer in der Registry veröffentlicht als 16 % der anderen 4175 Server in dieser Kategorie
- Basischecks gleich gut wie oder besser als bei 61 % der anderen 4175 Server in dieser Kategorie
Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.
Häufige Fragen
Ist ZuckerBot — Meta Ads MCP Server sicher?
Er hat 4 von 5 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.
Welche Schlüssel oder Codes braucht er?
Das musst du eintragen: ZUCKERBOT_API_KEY
Läuft er auf meinem Computer oder in der Cloud?
Beides geht: Installiere ihn auf deinem Computer oder verbinde dich mit der Cloud-Version.
Wird er noch gepflegt?
Das GitHub-Repo wurde zuletzt vor 2 Monaten geändert, und die neueste Version (0.4.4) kam vor 4 Monaten in die Registry.
Welche Apps können ihn nutzen?
Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).
Was kann ich stattdessen nutzen?
In derselben Kategorie: Relaticle, ChatbotX, X (Twitter) MCP Server by Xquik, Betterlytics, BibiGPT YouTube Video Summarizer
Ähnliche Alternativen
Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.
So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti
Relaticle
Open-source CRM your AI agents can write to: companies, people, opportunities, tasks and notes.
ChatbotX
Omnichannel customer messaging, CRM contacts, flows, sequences, broadcasts, and AI automation.
X (Twitter) MCP Server by Xquik
Xquik is the world's fastest and cheapest X (Twitter) data API with the most complete X data.
Betterlytics
Query your Betterlytics web analytics from AI agents: traffic, funnels, journeys, errors, uptime.
BibiGPT YouTube Video Summarizer
AI video summarizer: summarize and transcribe YouTube, Bilibili, TikTok and podcast videos.
| Dieser ZuckerBot — Meta Ads MCP Server | Relaticle | ChatbotX | X (Twitter) MCP Server by Xquik | Betterlytics | BibiGPT YouTube Video Summarizer | |
|---|---|---|---|---|---|---|
| Läuft wo | In der Cloud oder auf deinem Rechner | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation | Läuft in der Cloud, keine Installation |
| Braucht Schlüssel | Ja | Nein | Nein | Nein | Ja | Nein |
| Mit + in Claude hinzufügen | Nein | Nein | Nein | Nein | Nein | Nein |
| Basisprüfungen | 4/5 | 4/4 | 4/4 | 4/4 | 4/4 | 4/4 |
| Lizenz | MIT | AGPL-3.0 | NOASSERTION | MIT | AGPL-3.0 | MIT |
| Preis | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register | Keine Kosten im Register |
README vom Entwickler
README öffnen
Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.
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" } } } }
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:
- Audit your ad account in one message — spend flagged for review, creative fatigue, opportunity score, prioritised action items (free tier included)
- 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.
Remote MCP (no install)
Don't want to run anything locally? https://zuckerbot.ai/api/mcp is a hosted Streamable HTTP endpoint serving the same tools.
- claude.ai — add it as a custom connector (Settings → Connectors → Add custom connector) and authenticate via OAuth, or pass an
Authorization: Bearer zb_live_...header. - Claude Code:
claude mcp add --transport http zuckerbot https://zuckerbot.ai/api/mcp --header "Authorization: Bearer zb_live_..."
- Any Streamable HTTP client — point it at
https://zuckerbot.ai/api/mcpwith your API key as a bearer token.
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+)
Audit & Licensing (2)
| Tool | What it does |
|---|---|
audit_account | 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. Available on every tier — the recommended first call |
redeem_license | Redeem a lifetime licence code (Dealify/AppSumo) and upgrade all API keys on the account |
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 | Temporarily unavailable; intelligence campaigns remain planning-only |
launch_campaign | Launch one or all variants from a draft on Meta |
pause_campaign | Pause a campaign, ad set or ad, including spec-built Meta campaigns |
resume_campaign | Preview and explicitly activate one existing Meta campaign, ad set or ad |
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 |
|---|---|
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 |
generate_creatives* | Generate ad copy and images (or AI video) |
request_creative* | Create a creative handoff package for production |
\* Creative image/video generation tools (generate_static_ad, generate_video_ad, get_video_ad_status, generate_creatives, request_creative) are disabled by default — enable them with ZUCKERBOT_ENABLE_CREATIVE_TOOLS=1 in your MCP config env (paid add-on coming). All creative analysis tools stay available.
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 |
Reporting (2)
| Tool | What it does |
|---|---|
get_campaign_insights | Campaign / ad set / ad-level Meta performance for any campaign in the account (including non-ZuckerBot ones), with deduped lead metrics |
get_account_insights | Account-wide spend, impressions, CTR, CPM, CPC, and frequency aggregated daily or monthly |
get_campaign_insights surfaces three distinct lead figures rather than one collapsed number, each verified against Ads Manager:
| Field | Meaning |
|---|---|
meta_result / cost_per_meta_result | Meta's authoritative deduped "Results" for any objective (Ads Manager "Results" column), with meta_result_type naming the underlying result (conversion_lead for lead campaigns, offsite_conversion.fb_pixel_complete_registration / purchase for sales). Supersedes the now-deprecated results / cost_per_result |
meta_leads / cost_per_meta_lead | Deduped on-Meta leads (onsite_conversion.lead_grouped) — matches Ads Manager "Meta Leads" |
conversion_leads / cost_per_conversion_lead | CRM-qualified conversion leads (from Meta's results indicator conversion_leads:conversion_lead) — matches "Conversion leads". Lead-specific (0 for non-lead objectives) |
actions / cost_per_action_type | Full labelled arrays of { action_type, value } (counts) and { action_type, value } (cost in dollars) for every Meta action type |
results / cost_per_result | Deprecated. Objective-resolved result that mis-ranks mixed campaigns. Kept for back-compat — prefer meta_result / cost_per_meta_result |
leads / cpl | Deprecated. Inflated surface count (action_type: lead) that double-counts the instant-form lead and its CAPI echo. Kept for back-compat — prefer meta_leads / conversion_leads |
Costs are derived as spend / count; Meta's cost_per_action_type is non-additive and is never summed. The same fields roll up in summary as total_meta_result / blended_cost_per_meta_result (with meta_result_type), total_meta_leads / blended_cost_per_meta_lead, and total_conversion_leads / blended_cost_per_conversion_lead (with total_leads / blended_cpl deprecated alongside their per-row counterparts).
Portfolios (5)
| Tool | What it does |
|---|---|
create_portfolio | Create an audience portfolio from a template |
launch_portfolio | Temporarily unavailable; portfolios remain planning/monitoring-only |
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
0. Audit → audit_account (how is this account doing today?)
- Research → research_reviews + research_competitors (parallel)
- Preview → preview_campaign (show user what ads look like)
- Create → create_campaign with mode=legacy (launch-ready draft)
- Review → confirm targeting, creative, Meta connection, and budget
- Launch → launch_campaign after explicit approval
- Monitor → get_performance + creative_analysis
- Pause → pause_campaign whenever delivery must stop
- 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. Shorthand: legacy create -> review -> launch -> monitor. Intelligence activation and portfolio launch are temporarily unavailable; existing Meta objects use the reviewed resume workflow below for spec-built and external campaigns. MCP names include zuckerbot_enrich_business, zuckerbot_upload_business_context, zuckerbot_get_campaign, zuckerbot_activate_campaign, and `zuckerbot_create_seed_audienc