npm:zuckerbot-mcp

Show the current ZuckerBot authentication mode (demo vs authenticated), the Free/Pro/Scale billing tiers, setup instructions if not yet configured, an

Check your current ZuckerBot billing tier, API call usage this month, remaining quota, and overage costs. Use this when a user asks about their plan o

Analyse the historical ad performance for a business. For accounts WITH history: returns aggregated metrics by audience type, top performing creatives

Generate a campaign structure recommendation: audience tiers, budget allocation, creative mix. For accounts WITH history: uses Claude to generate data

Generate a detailed creative brief from an approved campaign structure. SAFE — pure function, no Meta API calls, no money spent. Automatically pulls b

Generate a brand-aware 1080×1080 static ad image using the Ad Compositor. Automatically injects brand context (logo, colors, brand name, value props,

Generate a video ad by dispatching to the Ad Factory pipeline (Claude scripting → Sora/FAL video → Shotstack overlay → FFmpeg captions → Cloudinary up

Check the status of an async video ad generation job. Returns current status and, when complete, the final video URL. Also surfaces Meta ad review sta

Build a complete Meta campaign from an approved Campaign Architect session. IMPORTANT: dry_run defaults to TRUE. When dry_run=true, returns the exact

Generate a zero-cost campaign preview from any business URL. Scrapes the site, writes AI-generated headlines and body copy, and generates ad images —

Create a new campaign draft for a business. In intelligence mode (preferred when a business_id is available) this returns context-aware audience tiers

Crawl a business website and extract structured intelligence used by campaign planning: company description, services, pricing signals, testimonials,

Upload a text document (ad performance data, brand guidelines, customer data, sales data, or competitor analysis) so ZuckerBot can extract structured

List all uploaded business-context files for a business along with their extracted summaries. Use this to confirm what planning documents are loaded b

Fetch the full details of a ZuckerBot campaign by ID: intelligence workflow state, approved strategy, stored creatives, audience tier executions, and

Approve the AI-generated intelligence strategy for a campaign, optionally narrowing to specific audience tiers and creative angles. This locks in the

Dispatch a creative production request for an approved intelligence campaign. If an Ad Factory webhook is configured on the business, ZuckerBot genera

Upload finished creative assets (images or videos) to an approved intelligence campaign. ZuckerBot queues the Meta upload and ad-creation jobs asynchr