Keep your Meta workflow moving.

1. Start a free audit and sign in with your email. No card or licence code is required.
2. Connect the Meta ad account you want to review.
3. Select Run my free account audit to create your report.

The audit is read-only: it does not create, pause or change ads. You do not need to install a local client, copy an API key, or connect Claude to run it in the browser. A Facebook Page is only required when you create ads.

Sign in at Your account using the same email as before. Choose the right business if asked, then open the saved report under Your account audit. Its generation date identifies the snapshot you are viewing. You do not need your old API key to reopen it.

If ZuckerBot cannot check for a saved report, retry that check before running another audit. If you are still stuck, contact support.

No. Open saved report reopens the existing snapshot without running a new scan. To review current data, choose a new scan from your account and select Run a new 30-day audit in setup. A new scan counts toward your plan's usage limits. Always check the report's generation date and account before acting on its findings.

Yes. Sign back in with the same email at audit setup or Your account. ZuckerBot checks your saved account and report state so you can resume. If your Meta connection needs repair, reconnect the intended ad account before starting a new scan. Changing the selected ad account clears the previous account's report from setup.

• An email address — sign-in uses email links or one-time codes, no password.
• A Meta ad account you have permission to access. A Facebook Page is not required for the first read-only audit; it is required when creating ads.
• Your licence code, if you bought a Dealify licence (format ZB-XXXXX-XXXXX-XXXXX). You can start a free audit without a code.
• Optional: an MCP-capable AI agent such as claude.ai, Claude Desktop, Claude Code, or Cursor for follow-up work.

Start with a free audit, or redeem your Dealify code.

Open Dealify activation and follow the setup steps:

1. Sign in with your email (we send a one-time code).
2. Redeem the ZB-… code for your purchased Plan A, B or C. One purchased code activates that plan.
3. Choose your optional agent connection. The hosted Claude connector uses sign-in; a local MCP client uses an API key. Store any key shown to you safely.
4. Connect Meta via Facebook login or a System User token.

Your purchased limits remain unchanged. No monthly ZuckerBot subscription is needed for your included features. Already activated? Sign in with the email you redeemed your code with.

• Invalid format: codes look like ZB-XXXXX-XXXXX-XXXXX. The alphabet deliberately excludes easily-confused characters (0/O, 1/I/L) — re-check any you typed.
• Code doesn't exist: copy-paste it directly from your Dealify receipt rather than retyping.
• Already redeemed: each code is single-use. If you redeemed it yourself under a different email, sign in with that email instead. If you never redeemed it, contact us with the code and your purchase receipt.

Redeem each code while signed in to the same account through Dealify activation. A purchased Plan A, B or C code already carries that plan's tier. Additional codes combine tier values, capped at Tier 3: Plan A plus Plan A reaches Tier 2; Plan B plus Plan A reaches Tier 3. Older untiered codes each contribute one tier value. Your existing API keys pick up the resulting limits. At Tier 3, more codes cannot increase your limits.

You do not need the old API key to open your saved report or resume your browser audit: sign in to your account with the same email. Keys are shown once at creation and never again. For a local MCP client, create a new key in your account and store it in a password manager. Your account limits apply across your keys.

1. In claude.ai, open Customize → Connectors → Add custom connector (some versions show Settings → Connectors).
2. Enter the URL: https://zuckerbot.ai/api/mcp
3. When prompted, sign in with the same email as your ZuckerBot account or licence purchase.

No install or API key to copy: sign-in links the connector to your ZuckerBot account. See the Claude setup guide for the full walkthrough.

Honest answer: we haven't certified ZuckerBot against ChatGPT yet, so we're not going to hand you steps we can't stand behind.

ChatGPT can reach remote MCP servers, and our endpoint is a standards-compliant remote MCP server — nothing about it is Claude-specific. But which ChatGPT plans expose custom connectors, and whether they allow tools that act rather than just read, has moved around. ZuckerBot is also a large toolkit, and some clients cap how much tool definition they'll accept.

If you want to try it, the connector URL is https://zuckerbot.ai/api/mcp and you sign in with the email you redeemed your licence with. Please tell us how it goes — email support@zuckerbot.ai either way, and we'll write this section properly.

Two paths that definitely work today: the claude.ai connector above, and npx zuckerbot-mcp with a key from start.html in any local MCP client. And note the connector is one credential per account — see "My old connector stopped working" below before running two agents at once.

With your API key from start.html:

claude mcp add zuckerbot --env ZUCKERBOT_API_KEY=zb_live_… -- npx -y zuckerbot-mcp

Or add to your MCP config file manually:

{
  "mcpServers": {
    "zuckerbot": {
      "command": "npx",
      "args": ["-y", "zuckerbot-mcp"],
      "env": { "ZUCKERBOT_API_KEY": "zb_live_…" }
    }
  }
}

Two options:

• Remote: add https://zuckerbot.ai/api/mcp as a remote MCP server. Sign in via the OAuth prompt, or send the header Authorization: Bearer zb_live_… directly.
• Local: use the npx -y zuckerbot-mcp config above with ZUCKERBOT_API_KEY set.

Remote (https://zuckerbot.ai/api/mcp) needs no install and signs in with your email — best for claude.ai and quick setup. Local (npx zuckerbot-mcp) runs on your machine and authenticates with your API key — best for Claude Code, scripts, and anywhere you manage env vars. Both expose the same tools and count against the same limits.

Check spam/junk first. Codes are valid for a short window — if it expired, request a fresh one. If emails consistently don't arrive, contact us and include the email address you're using.

That's by design. Each time you complete the connector sign-in, ZuckerBot issues a fresh connector credential and revokes the previous one. Note this is one connector credential per account, across every client — not one per device. So signing in the connector from a second app disconnects the first: connect ChatGPT and your claude.ai connector stops working, and vice versa.

To run two agents at once, keep one of them on the connector and give the other a key you mint yourself at start.html — self-minted keys are never revoked by a reconnect. If one of them is a web-only client like ChatGPT, keep that one on the connector and move the local client (Claude Desktop, Claude Code, Cursor) onto npx zuckerbot-mcp with your own key.

• Facebook login (recommended): click through the Facebook OAuth flow at start.html step 4. Fastest, but Meta login tokens expire after about 60 days, so you'll occasionally reconnect.
• System User token (advanced): create a System User in Business Manager → System Users, assign it access to your ad account, and generate a token with the required permissions. Assign a Page too if you plan to create ads. Keep the token secure; access can still be revoked.

A Meta authentication error (such as error code 190) can mean the token expired or is no longer valid. Sign in at audit setup and reconnect the intended Meta ad account. Confirm the account you select before starting a new scan. You can still open an existing saved report from Your account.

You've pasted a Page access token. ZuckerBot needs a User or System User token — generate it from the System User itself in Business Manager (not from a Page), with the ad permissions assigned.

Facebook connect links are valid for 10 minutes. If you left the tab open too long, just start the connection again from step 4.

Plan A (Lifetime Tier 1) includes 1 ad account, Plan B (Tier 2) 3, and Plan C (Tier 3) 10. An ad account is registered to your licence the first time your agent works with it (e.g. the first audit). Additional codes can raise a lower tier, up to Tier 3; they do not expand the highest tier.

One code from your purchased Plan A, B or C activates the corresponding tier. All tiers get the full tool set. Limits are per ZuckerBot account, not per API key; API-call allowances reset monthly. No monthly subscription is needed for your included lifetime features.

Code stacking combines tier values: a Plan A code contributes 1, Plan B 2 and Plan C 3, capped at Tier 3. For example, two Plan A codes reach Tier 2, while one Plan B code already grants Tier 2. Your account shows the resulting plan and limits.

Each tool invocation your agent makes is one call. A simple question might be a single call; a full account audit or campaign build involves several. For reference, 2,500 calls/month is comfortable for regularly managing one ad account.

For lifetime-deal tiers, requests are declined with a clear error (HTTP 429) until the month rolls over — there is no overage billing on those tiers. The cap is a hard stop, not a surprise bill. The per-minute rate limit behaves the same way: a 429 with a retry_after your agent waits on. Additional codes can raise a lower lifetime tier, up to Tier 3. At Tier 3, another code does not increase your limits.

Open Your account to check your plan and usage. You can also ask your agent: "What's my ZuckerBot billing status?" — the zuckerbot_billing_status tool returns your tier, calls used this month, and remaining quota.

No. Generating creatives has real per-render costs, so it's excluded from the lifetime deal to keep the deal sustainable — it may arrive later as an optional paid add-on. Creative analysis is included: your agent can analyse, compare, QA, and tag the ad creatives you already have, and tell you what's working.

No. Campaigns and ads are provisioned in a PAUSED state — nothing runs and nothing spends until you explicitly approve and request activation. Campaign builds also go through a preview/approve step, so you (and your agent) see the full plan — budget included — before delivery begins.

Audits, insights, and research tools are read-only. Management tools can create, launch, and pause supported campaigns on the ad accounts you've connected — the same permissions you granted via Facebook login or your System User token. ZuckerBot only ever acts on your instruction through your agent.

Encrypted at rest with AES-256-GCM. Your token is decrypted server-side only at the moment it's needed to call the Meta API, and is never exposed to the browser or to other tenants. Full detail on the security page.

Honest answer: ZuckerBot runs on Meta's Marketing API, so like every tool in this category it depends on Meta keeping that API available. If we ever wound the service down, we'd give reasonable notice by email, and you can export or delete your data at any time by emailing support@zuckerbot.ai. Your Meta account and its data always remain yours, held in your own Meta Business Manager — ZuckerBot only ever acts on it with your access.

You've hit your per-minute limit (30/60/120 depending on tier). The error includes a retry_after — most agents wait and retry automatically. If your agent runs big parallel workloads, a higher tier raises the ceiling.

You've used your month's calls. The counter resets at the start of the next month. If you are below Lifetime Tier 3, an additional code can raise your tier; the highest lifetime tier's limits cannot be increased by stacking more codes.

A skip response tells you the exact reason rather than pretending success:

• missing_meta_credentials — connect your Meta account first (start.html step 4).
• capi_disabled / missing pixel — set your pixel in the CAPI config (ask your agent to run zuckerbot_set_capi_config).

Ask your agent for zuckerbot_capi_status — it shows readiness, recent events, and any recent failures with reasons.

Three possibilities, in order of likelihood:

• Meta token expired (error 190) → reconnect Meta at start.html.
• Connector key rotated — you reconnected the connector elsewhere, which revoked the old session → reconnect this client.
• Wrong or truncated API key in a local config → re-check the ZUCKERBOT_API_KEY value.

Email us with: what you asked your agent to do, the error message (tool errors include a code field), the approximate time, and which account or business you were using. Do not include API keys, tokens or sign-in codes. That helps us investigate.

Lifetime-deal purchases are covered by Dealify's money-back guarantee — refunds are requested and processed through Dealify, per the terms on the listing where you bought. Once refunded, the associated licence codes are deactivated.

Licences are bound to the account that redeemed them. If you need to move to a different email, contact us from the original address and we'll sort it out.

Email us from your account email and we'll remove your account, keys, Meta connection, and stored data. See the Privacy Policy for details on what we store.