llms.txt
Compare with other sites' llms.txt files →# ZuckerBot
> ZuckerBot connects AI agents to Meta (Facebook/Instagram) ads through the Model Context Protocol: account audits, campaign builds from declarative specs, audiences, creative analysis, lead export and Conversions API tracking — driven in plain English from Claude, Cursor, ChatGPT or any MCP client. The MCP client/CLI (npm: zuckerbot-mcp) is open source; it connects to the hosted ZuckerBot platform.
## Key facts
- 70 MCP tools (65 on every tier; image/video generation is a gated paid add-on)
- Remote MCP endpoint: https://zuckerbot.ai/api/mcp (OAuth) — or run npx zuckerbot-mcp locally with an API key
- npm package: https://www.npmjs.com/package/zuckerbot-mcp
- Everything builds PAUSED; launching is always a separate, deliberate call
- Works with Meta Marketing API v21.0
## Important pages
- [Homepage](https://zuckerbot.ai/): what ZuckerBot is and how it works
- [Tool reference](https://zuckerbot.ai/tools.html): every tool in one page
- [Get started](https://zuckerbot.ai/start.html): connect in about two minutes
- [Pricing](https://zuckerbot.ai/pricing.html): Free, Pro and Scale subscriptions
- [Lifetime deal](https://zuckerbot.ai/deal.html): marketplace lifetime licences
- [Comparisons](https://zuckerbot.ai/compare/): honest comparisons vs Meta Ads Manager, Meta's ads MCP, Madgicx, AdEspresso, Revealbot
- [Honest self-review](https://zuckerbot.ai/zuckerbot-review.html): capabilities, limitations and pricing, from the makers
- [Support](https://zuckerbot.ai/support.html) · [Security](https://zuckerbot.ai/security.html) · [Roadmap](https://zuckerbot.ai/roadmap.html)
## Tools
### Account audits & insights
- [zuckerbot_quickstart](https://zuckerbot.ai/tools/zuckerbot_quickstart.html): Show the current ZuckerBot authentication mode (demo vs authenticated), the Free/Pro/Scale and Lifetime billing tiers, setup instructions if not yet configured, and the recommended tool flow from aud…
- [zuckerbot_billing_status](https://zuckerbot.ai/tools/zuckerbot_billing_status.html): Check your current ZuckerBot billing tier, API call usage this month, remaining quota, and overage costs.
- [zuckerbot_audit_account](https://zuckerbot.ai/tools/zuckerbot_audit_account.html): Run a full audit of the connected Meta ad account: spend flagged for review against each campaign's own objective, creative fatigue, a complete-account opportunity score (0-100 when all inputs return…
- [zuckerbot_analyse_account_history](https://zuckerbot.ai/tools/zuckerbot_analyse_account_history.html): Analyse the historical ad performance for a business.
- [zuckerbot_get_performance](https://zuckerbot.ai/tools/zuckerbot_get_performance.html): Fetch real-time performance metrics for a ZuckerBot campaign.
- [zuckerbot_get_account_insights](https://zuckerbot.ai/tools/zuckerbot_get_account_insights.html): Fetch historical Meta ad account performance for a connected business over a date range.
- [zuckerbot_get_campaign_insights](https://zuckerbot.ai/tools/zuckerbot_get_campaign_insights.html): Query campaign, ad set, or ad-level performance for any campaign in the connected Meta ad account — including campaigns not created by ZuckerBot.
- [zuckerbot_meta_status](https://zuckerbot.ai/tools/zuckerbot_meta_status.html): Check whether the user's Facebook/Meta account is connected to ZuckerBot.
- [zuckerbot_get_capi_config](https://zuckerbot.ai/tools/zuckerbot_get_capi_config.html): Fetch the current Conversions API configuration for a business: whether CAPI delivery is enabled, CRM source, currency, stage-to-event mappings, action source, and webhook URL.
- [zuckerbot_capi_status](https://zuckerbot.ai/tools/zuckerbot_capi_status.html): Get 7-day and 30-day CAPI delivery statistics for the business: total events sent, events by type (Lead/Contact/Purchase), match quality and identifier-coverage breakdowns, meta_events_received (Meta…
- [zuckerbot_capi_test](https://zuckerbot.ai/tools/zuckerbot_capi_test.html): Send a synthetic CAPI test event through the business configuration to verify the full pipeline: stage mapping, hashing, and Meta Graph API delivery.
- [zuckerbot_portfolio_performance](https://zuckerbot.ai/tools/zuckerbot_portfolio_performance.html): Fetch live Meta performance and downstream CAPI attribution for a launched audience portfolio.
### Strategy & campaign build
- [zuckerbot_recommend_campaign_structure](https://zuckerbot.ai/tools/zuckerbot_recommend_campaign_structure.html): Generate a campaign structure recommendation: audience tiers, budget allocation, creative mix.
- [zuckerbot_generate_campaign_brief](https://zuckerbot.ai/tools/zuckerbot_generate_campaign_brief.html): Generate a detailed creative brief from an approved campaign structure.
- [zuckerbot_create_full_campaign](https://zuckerbot.ai/tools/zuckerbot_create_full_campaign.html): Build a complete PAUSED Meta campaign from an approved Campaign Architect session.
- [zuckerbot_preview_campaign](https://zuckerbot.ai/tools/zuckerbot_preview_campaign.html): Generate a zero-cost campaign preview from any business URL.
- [zuckerbot_create_campaign](https://zuckerbot.ai/tools/zuckerbot_create_campaign.html): Create a new campaign draft for a business.
- [zuckerbot_create_campaign_from_spec](https://zuckerbot.ai/tools/zuckerbot_create_campaign_from_spec.html): Build a complete Meta campaign VERBATIM from a declarative JSON spec — no strategy generation, no copy authoring.
- [zuckerbot_duplicate_ad](https://zuckerbot.ai/tools/zuckerbot_duplicate_ad.html): Duplicate ONE supported ad into an existing ad set in the SAME ad account.
- [zuckerbot_get_campaign](https://zuckerbot.ai/tools/zuckerbot_get_campaign.html): Fetch the full details of a ZuckerBot campaign by ID: intelligence workflow state, approved strategy, stored creatives, audience tier executions, and performance status.
- [zuckerbot_approve_campaign_strategy](https://zuckerbot.ai/tools/zuckerbot_approve_campaign_strategy.html): Approve the AI-generated intelligence strategy for a campaign, optionally narrowing to specific audience tiers and creative angles.
- [zuckerbot_activate_campaign](https://zuckerbot.ai/tools/zuckerbot_activate_campaign.html): Not currently available.
- [zuckerbot_launch_campaign](https://zuckerbot.ai/tools/zuckerbot_launch_campaign.html): Launch a draft campaign on Meta (Facebook/Instagram).
- [zuckerbot_pause_campaign](https://zuckerbot.ai/tools/zuckerbot_pause_campaign.html): Pause delivery at any level: a whole campaign (default), one ad set, or one ad — set entity_level and pass the matching id.
- [zuckerbot_generate_briefs](https://zuckerbot.ai/tools/zuckerbot_generate_briefs.html): Generate creative production briefs based on the business's tagged ad-performance patterns.
### Audiences
- [zuckerbot_create_seed_audience](https://zuckerbot.ai/tools/zuckerbot_create_seed_audience.html): Build a Meta custom audience from hashed CAPI user data stored for a business, filtered by CRM lifecycle stage (e.g., 'lead', 'customer').
- [zuckerbot_create_lookalike_audience](https://zuckerbot.ai/tools/zuckerbot_create_lookalike_audience.html): Create a Meta lookalike audience from a stored seed audience.
- [zuckerbot_list_audiences](https://zuckerbot.ai/tools/zuckerbot_list_audiences.html): List all stored Meta audiences for a business: seed audiences, lookalike audiences, sizes, delivery statuses, and CAPI source details.
- [zuckerbot_refresh_audience](https://zuckerbot.ai/tools/zuckerbot_refresh_audience.html): Rebuild a stored audience from fresh data.
- [zuckerbot_get_audience_status](https://zuckerbot.ai/tools/zuckerbot_get_audience_status.html): Fetch the current Meta delivery status, size, and readiness for a stored audience.
- [zuckerbot_delete_audience](https://zuckerbot.ai/tools/zuckerbot_delete_audience.html): Permanently delete a stored audience from both Meta and ZuckerBot's local registry.
- [zuckerbot_create_portfolio](https://zuckerbot.ai/tools/zuckerbot_create_portfolio.html): Create a planning and monitoring-only multi-tier audience portfolio for a business from a shared template (e.g., 'Local Services', 'eCommerce') or a custom tier array.
- [zuckerbot_get_portfolio](https://zuckerbot.ai/tools/zuckerbot_get_portfolio.html): Fetch the configuration and current performance snapshot for an audience portfolio by ID.
- [zuckerbot_update_portfolio](https://zuckerbot.ai/tools/zuckerbot_update_portfolio.html): Update the name, total daily budget, active status, or tier configuration of an existing audience portfolio.
- [zuckerbot_rebalance_portfolio](https://zuckerbot.ai/tools/zuckerbot_rebalance_portfolio.html): Dry-run or execute a budget rebalance across portfolio tiers based on each tier's actual vs.
- [zuckerbot_launch_portfolio](https://zuckerbot.ai/tools/zuckerbot_launch_portfolio.html): Not currently available.
### Creative analysis
- [zuckerbot_upload_creative](https://zuckerbot.ai/tools/zuckerbot_upload_creative.html): Upload finished creative assets (images or videos) to an approved intelligence campaign.
- [zuckerbot_generate_static_ad](https://zuckerbot.ai/tools/zuckerbot_generate_static_ad.html): Generate a brand-aware 1080×1080 static ad image.
- [zuckerbot_generate_video_ad](https://zuckerbot.ai/tools/zuckerbot_generate_video_ad.html): Generate a video ad through ZuckerBot's video generation pipeline (AI scripting → AI video → captioned overlay → hosted upload).
- [zuckerbot_get_video_ad_status](https://zuckerbot.ai/tools/zuckerbot_get_video_ad_status.html): Check the status of an async video ad generation job.
- [zuckerbot_request_creative](https://zuckerbot.ai/tools/zuckerbot_request_creative.html): Dispatch a creative production request for an approved intelligence campaign.
- [zuckerbot_generate_creatives](https://zuckerbot.ai/tools/zuckerbot_generate_creatives.html): Generate standalone ad creative variants (images or video) using AI image and video models.
- [zuckerbot_upload_creative](https://zuckerbot.ai/tools/zuckerbot_upload_creative.html): Upload finished creative assets (images or videos) to an approved intelligence campaign.
- [zuckerbot_get_creative_status](https://zuckerbot.ai/tools/zuckerbot_get_creative_status.html): Check the asynchronous upload queue for an intelligence campaign to see if Meta ad-creation jobs are complete.
- [zuckerbot_creative_analysis](https://zuckerbot.ai/tools/zuckerbot_creative_analysis.html): Analyse creative performance patterns for a business by grouping ads by hook type, visual style, product focus, setting, CTA type, copy tone, or opening element.
- [zuckerbot_creative_cross_analysis](https://zuckerbot.ai/tools/zuckerbot_creative_cross_analysis.html): Cross two creative dimensions to find winning combinations.
- [zuckerbot_creative_qa](https://zuckerbot.ai/tools/zuckerbot_creative_qa.html): Score proposed creative variants against the business's historical top-performing patterns.
- [zuckerbot_tag_creative](https://zuckerbot.ai/tools/zuckerbot_tag_creative.html): Tag Meta ads with creative attributes (hook type, visual style, product focus, CTA type, copy tone, setting) by providing ad metadata and optional asset URLs.
- [zuckerbot_get_creative_attributes](https://zuckerbot.ai/tools/zuckerbot_get_creative_attributes.html): Read the stored creative attribute tags for up to 50 Meta ads in the canonical creative_attributes.v1 shape: the 17 extracted attributes (hook type, visual style, CTA type, copy tone, booleans and mo…
### Conversion tracking (CAPI)
- [zuckerbot_sync_conversion](https://zuckerbot.ai/tools/zuckerbot_sync_conversion.html): Send downstream conversion quality feedback to Meta via CAPI.
- [zuckerbot_pixels](https://zuckerbot.ai/tools/zuckerbot_pixels.html): List Meta Pixels available on the currently selected ad account and show which is currently selected for conversion tracking.
- [zuckerbot_lead_forms](https://zuckerbot.ai/tools/zuckerbot_lead_forms.html): List Meta lead forms (Instant Forms) available on the selected Facebook Page and show which is currently selected.
- [zuckerbot_get_lead_form](https://zuckerbot.ai/tools/zuckerbot_get_lead_form.html): Read one Meta lead form (Instant Form) in full: questions, privacy policy URL and legal content (disclaimer), locale, context card, thank-you page, follow-up action URL, status, created time and lead…
- [zuckerbot_export_leads](https://zuckerbot.ai/tools/zuckerbot_export_leads.html): Export lead submissions from a Meta instant form (lead form) for a date range: each lead's id, created_time and submitted field values.
- [zuckerbot_set_capi_config](https://zuckerbot.ai/tools/zuckerbot_set_capi_config.html): Update the Conversions API configuration for a business.
- [zuckerbot_rotate_webhook_secret](https://zuckerbot.ai/tools/zuckerbot_rotate_webhook_secret.html): Rotate the Conversions API webhook secret for a business.
- [zuckerbot_list_custom_conversions](https://zuckerbot.ai/tools/zuckerbot_list_custom_conversions.html): List the custom conversions on the connected ad account: id, name, rule, source event, pixel and availability (is_unavailable).
- [zuckerbot_get_custom_conversion](https://zuckerbot.ai/tools/zuckerbot_get_custom_conversion.html): Read one custom conversion in full: rule, source event (event_source_id/event_source_type), category (custom_event_type), default conversion value, availability (is_unavailable) and creation time, pl…
- [zuckerbot_create_custom_conversion](https://zuckerbot.ai/tools/zuckerbot_create_custom_conversion.html): Create a custom conversion on the connected ad account (requires sufficient Graph permissions on the Meta token — returns insufficient_permission if Meta refuses).
- [zuckerbot_send_capi_event](https://zuckerbot.ai/tools/zuckerbot_send_capi_event.html): Manually send a Conversions API event for a business contact/lead.
### Research
- [zuckerbot_enrich_business](https://zuckerbot.ai/tools/zuckerbot_enrich_business.html): Crawl a business website and extract structured intelligence used by campaign planning: company description, services, pricing signals, testimonials, location data, and brand tone.
- [zuckerbot_suggest_angles](https://zuckerbot.ai/tools/zuckerbot_suggest_angles.html): Return only the creative angles and audience tiers for a campaign draft — a lightweight alternative to zuckerbot_get_campaign when you need just the strategy summary without the full campaign payload…
- [zuckerbot_research_reviews](https://zuckerbot.ai/tools/zuckerbot_research_reviews.html): Fetch review intelligence for a business by name.
- [zuckerbot_research_competitors](https://zuckerbot.ai/tools/zuckerbot_research_competitors.html): Scrape Meta Ad Library and search the web to analyse competitor ads in a given industry and location.
- [zuckerbot_research_market](https://zuckerbot.ai/tools/zuckerbot_research_market.html): Get market size, addressable audience estimates, and Meta ad benchmarks (CPL, CTR, CPM) for an industry and location.
### Setup & context
- [zuckerbot_redeem_license](https://zuckerbot.ai/tools/zuckerbot_redeem_license.html): Redeem a ZuckerBot lifetime licence code (format ZB-XXXXX-XXXXX-XXXXX) purchased on Dealify or AppSumo.
- [zuckerbot_upload_business_context](https://zuckerbot.ai/tools/zuckerbot_upload_business_context.html): Upload a text document (ad performance data, brand guidelines, customer data, sales data, or competitor analysis) so ZuckerBot can extract structured planning insights from it.
- [zuckerbot_list_business_context](https://zuckerbot.ai/tools/zuckerbot_list_business_context.html): List all uploaded business-context files for a business along with their extracted summaries.
- [zuckerbot_ad_accounts](https://zuckerbot.ai/tools/zuckerbot_ad_accounts.html): List Meta ad accounts available to the connected user and show which is currently selected for launches and reporting.
- [zuckerbot_meta_pages](https://zuckerbot.ai/tools/zuckerbot_meta_pages.html): List Facebook Pages available to the connected Meta account and show which is currently selected for ad delivery.
- [zuckerbot_get_launch_credentials](https://zuckerbot.ai/tools/zuckerbot_get_launch_credentials.html): Resolve and validate all stored Meta launch credentials for the authenticated user: access token, ad account, page, and pixel.