// MCP TOOL REFERENCE

ZUCKERBOT TOOLS

59 tools from the Zuckerbot MCP Server, categorised by risk level.

View the Zuckerbot policy → Token cost: 12,720 tokens →

// ALL 59 ZUCKERBOT TOOLS

READ 32 tools

Read zuckerbot_ad_accounts List Meta ad accounts available to the connected user and show which is currently selected for launches and... Read zuckerbot_analyse_account_history Analyse the historical ad performance for a business. For accounts WITH history: returns aggregated metrics... Read zuckerbot_billing_status Check your current ZuckerBot billing tier, API call usage this month, remaining quota, and overage costs. U... Read zuckerbot_capi_status Get 7-day and 30-day CAPI delivery statistics for the business: total events sent, events by type (Lead/Con... Read zuckerbot_capi_test Send a synthetic CAPI test event through the business configuration to verify the full pipeline: stage mapp... Read zuckerbot_creative_analysis Analyse creative performance patterns for a business by grouping ads by hook type, visual style, product fo... Read zuckerbot_creative_cross_analysis Cross two creative dimensions to find winning combinations. Example: hook_type × visual_style can reveal th... Read zuckerbot_creative_qa Score proposed creative variants against the business's historical top-performing patterns. Accepts raw cre... Read zuckerbot_enrich_business Crawl a business website and extract structured intelligence used by campaign planning: company description... Read zuckerbot_get_account_insights Fetch historical Meta ad account performance for a connected business over a date range. Returns spend, cli... Read zuckerbot_get_audience_status Fetch the current Meta delivery status, size, and readiness for a stored audience. Updates the local audien... Read zuckerbot_get_campaign Fetch the full details of a ZuckerBot campaign by ID: intelligence workflow state, approved strategy, store... Read zuckerbot_get_campaign_insights Query campaign, ad set, or ad-level performance for any campaign in the connected Meta ad account — includi... Read zuckerbot_get_capi_config Fetch the current Conversions API configuration for a business: whether CAPI delivery is enabled, CRM sourc... Read zuckerbot_get_creative_status Check the asynchronous upload queue for an intelligence campaign to see if Meta ad-creation jobs are comple... Read zuckerbot_get_launch_credentials Resolve and validate all stored Meta launch credentials for the authenticated user: access token, ad accoun... Read zuckerbot_get_performance Fetch real-time performance metrics for a ZuckerBot campaign. Legacy campaigns return a flat metrics summar... Read zuckerbot_get_portfolio Fetch the configuration and current performance snapshot for an audience portfolio by ID. Returns tier defi... Read zuckerbot_get_video_ad_status Check the status of an async video ad generation job. Returns current status and, when complete, the final ... Read zuckerbot_lead_forms List Meta lead forms (Instant Forms) available on the selected Facebook Page and show which is currently se... Read zuckerbot_list_audiences List all stored Meta audiences for a business: seed audiences, lookalike audiences, sizes, delivery statuse... Read zuckerbot_list_business_context List all uploaded business-context files for a business along with their extracted summaries. Use this to c... Read zuckerbot_meta_pages List Facebook Pages available to the connected Meta account and show which is currently selected for ad del... Read zuckerbot_meta_status Check whether the user's Facebook/Meta account is connected to ZuckerBot. Returns connection status, connec... Read zuckerbot_pause_campaign Pause or resume a running Meta ad campaign. Pausing stops ad delivery and spend immediately — the campaign ... Read zuckerbot_pixels List Meta Pixels available on the currently selected ad account and show which is currently selected for co... Read zuckerbot_preview_campaign Generate a zero-cost campaign preview from any business URL. Scrapes the site, writes AI-generated headline... Read zuckerbot_refresh_audience Rebuild a stored audience from fresh data. For seed audiences: re-hashes the latest CAPI events for the sou... Read zuckerbot_request_creative Dispatch a creative production request for an approved intelligence campaign. If an Ad Factory webhook is c... Read zuckerbot_research_competitors Scrape Meta Ad Library and search the web to analyse competitor ads in a given industry and location. Retur... Read zuckerbot_research_reviews Fetch review intelligence for a business by name. Searches Google and Yelp to surface star rating, review c... Read zuckerbot_suggest_angles Return only the creative angles and audience tiers for a campaign draft — a lightweight alternative to zuck...

WRITE 19 tools

Write zuckerbot_activate_campaign Activate the ready audience tiers for an intelligence campaign after strategy approval and creative upload.... Write zuckerbot_approve_campaign_strategy Approve the AI-generated intelligence strategy for a campaign, optionally narrowing to specific audience ti... Write zuckerbot_create_campaign Create a new campaign draft for a business. In intelligence mode (preferred when a business_id is available... Write zuckerbot_create_full_campaign Build a complete Meta campaign from an approved Campaign Architect session. IMPORTANT: dry_run defaults to ... Write zuckerbot_create_lookalike_audience Create a Meta lookalike audience from a stored seed audience. Expands a first-party seed (e.g., 'customer' ... Write zuckerbot_create_portfolio Create a multi-tier audience portfolio for a business from a shared template (e.g., 'Local Services', 'eCom... Write zuckerbot_create_seed_audience Build a Meta custom audience from hashed CAPI user data stored for a business, filtered by CRM lifecycle st... Write zuckerbot_generate_briefs Generate Ad Factory-compatible creative production briefs based on the business's tagged ad-performance pat... Write zuckerbot_generate_campaign_brief Generate a detailed creative brief from an approved campaign structure. SAFE — pure function, no Meta API c... Write zuckerbot_generate_creatives Generate standalone ad creative variants (images or video) using AI image models (Seedream/Imagen) or video... Write zuckerbot_generate_static_ad Generate a brand-aware 1080×1080 static ad image using the Ad Compositor. Automatically injects brand conte... Write zuckerbot_generate_video_ad Generate a video ad by dispatching to the Ad Factory pipeline (Claude scripting → Sora/FAL video → Shotstac... Write zuckerbot_research_market Get market size, addressable audience estimates, and Meta ad benchmarks (CPL, CTR, CPM) for an industry and... Write zuckerbot_send_capi_event Manually send a Conversions API event for a business contact/lead. Useful for debugging CAPI pipelines, tes... Write zuckerbot_set_capi_config Update the Conversions API configuration for a business. Set stage-to-event mappings (e.g., 'lead' → Meta L... Write zuckerbot_sync_conversion Send downstream conversion quality feedback to Meta via CAPI. When a ZuckerBot-sourced lead converts (sale,... Write zuckerbot_update_portfolio Update the name, total daily budget, active status, or tier configuration of an existing audience portfolio... Write zuckerbot_upload_business_context Upload a text document (ad performance data, brand guidelines, customer data, sales data, or competitor ana... Write zuckerbot_upload_creative Upload finished creative assets (images or videos) to an approved intelligence campaign. ZuckerBot queues t...

DESTRUCTIVE 1 tools

Destructive zuckerbot_delete_audience Permanently delete a stored audience from both Meta and ZuckerBot's local registry. This cannot be undone. ...

EXECUTE 7 tools

Execute zuckerbot_launch_campaign Launch a draft campaign on Meta (Facebook/Instagram). THIS IS THE MONEY ENDPOINT — it creates real ads on t... Execute zuckerbot_launch_portfolio Launch all tiers in an audience portfolio on Meta. Creates separate Meta campaigns for each tier (prospecti... Execute zuckerbot_portfolio_performance Fetch live Meta performance and downstream CAPI attribution for a launched audience portfolio. Returns enri... Execute zuckerbot_quickstart Show the current ZuckerBot authentication mode (demo vs authenticated), the Free/Pro/Scale billing tiers, s... Execute zuckerbot_rebalance_portfolio Dry-run or execute a budget rebalance across portfolio tiers based on each tier's actual vs. target CPA. Wi... Execute zuckerbot_recommend_campaign_structure Generate a campaign structure recommendation: audience tiers, budget allocation, creative mix. For accounts... Execute zuckerbot_tag_creative Tag Meta ads with creative attributes (hook type, visual style, product focus, CTA type, copy tone, setting...

// FAQ

How many tools does the Zuckerbot MCP server have? +

The Zuckerbot MCP server exposes 59 tools across 4 categories: Read, Write, Destructive, Execute.

How do I enforce policies on Zuckerbot tools? +

Route the Zuckerbot server through the PolicyLayer gateway. Define allow, deny, or approval rules per tool in the dashboard — they are enforced on every call before it reaches the server.

What risk categories do Zuckerbot tools fall into? +

Zuckerbot tools are categorised as Read (32), Write (19), Destructive (1), Execute (7). Each category has a recommended default policy.

Let agents act without letting them run wild.

Route your MCP servers through PolicyLayer and every tool call is checked against your policy before it runs — allow, deny, or require approval. Per-identity grants. Full audit log. Live in minutes.

SECURE YOUR MCP →

Free to start. No card required.

4,600+ MCP servers and 31,000+ tools scanned and risk-classified.