ZuckerBot Skill

ZuckerBot gives AI agents the ability to create, launch, monitor, and manage Facebook and Instagram ad campaigns via the Meta Ads API. All tools are available via the ZuckerBot MCP server.

Authentication

Before any tool can be called, the user must:

1. Connect their Facebook account at zuckerbot.ai (OAuth flow)
2. Generate an API key from the developer page
3. Provide the API key — ZuckerBot stores credentials, so this is a one-time step per session

If the user hasn't authenticated yet, prompt them to visit zuckerbot.ai before proceeding.

Tools Reference

zuckerbot_preview_campaign

Generate a campaign preview and strategy from a business URL — before spending anything.

When to use: User wants to explore what a campaign might look like, or you need to research the business before creating a campaign.

Key inputs:

• url — the business or landing page URL
• api_key — ZuckerBot API key

Output: Campaign strategy, suggested targeting, budget recommendations, ad creative concepts.

zuckerbot_create_campaign

Create a full campaign with strategy, targeting, budget, and ad creative recommendations.

When to use: User wants to build a campaign ready for launch. Use after preview if the user wants to iterate, or directly if they have clear goals.

Key inputs:

• business_url or business description
• objective — one of: traffic, leads, conversions, awareness (default: traffic)
• budget_daily — daily budget in USD
• api_key

Output: A structured campaign object ready to pass to launch_campaign.

zuckerbot_generate_ad_creative

Generate AI-powered ad creative images for Facebook/Instagram.

When to use: User wants visual assets for their campaign, or when launching a campaign that needs imagery.

Key inputs:

• Campaign context / description
• api_key

Output: Generated image(s) suitable for Meta ad placements.

zuckerbot_launch_campaign

Launch a single campaign variant on Meta (Facebook/Instagram).

When to use: User has a campaign ready and wants to go live with one variant.

Key inputs:

• Campaign object (from create_campaign or user-provided)
• api_key

Output: Campaign ID, live status, confirmation summary.

zuckerbot_launch_all_variants (A/B Testing)

Launch multiple ad variants simultaneously for A/B testing.

When to use: User wants to test multiple creatives, headlines, or audiences against each other. Preferred over single launch when optimisation is the goal.

Key inputs:

• Array of campaign variant objects
• api_key

Output: Array of campaign IDs and launch confirmations per variant.

zuckerbot_get_performance

Fetch real-time performance metrics for a campaign.

When to use: User asks how a campaign is performing, wants to see results, or you need data to make optimisation recommendations.