# ZuckerBot — Meta Ads MCP Server

Wires your agent into the Meta Marketing API: account audits, campaign management, audiences and server-side conversion tracking. Useful when you'd rather run ads from chat than from a dashboard.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 13
- Author: DatalisHQ
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/DatalisHQ/zuckerbot
- Updated: 2026-09-16
- HTML: https://affpapa.org/en/nevibecode/mcp/zuckerbot-meta-ads-mcp-server

## What it does

ZuckerBot is an MCP server from DatalisHQ that exposes the Meta Marketing API to your agent. It ships more than 50 tools: an account audit with an opportunity score and a prioritised to-do list, campaign management, creative analysis, audience building and CAPI setup. The agent picks the right tool once you describe the job in plain words.

Two ways to run it. Locally with `npx -y zuckerbot-mcp`, which needs `ZUCKERBOT_API_KEY` in the client config. Or remotely against `https://zuckerbot.ai/api/mcp`, a Streamable HTTP endpoint that keeps nothing on your machine. No key means no server. Launching campaigns also requires a connected ad account and a selected Facebook page.

One tool is worth flagging: `activate_campaign` is marked temporarily unavailable, so campaigns built through the intelligence flow stay in planning. Actual launches go through `launch_campaign`. MIT licence, repo at `DatalisHQ/zuckerbot`.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://zuckerbot.ai/api/mcp`
- Environment variables: `ZUCKERBOT_API_KEY` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

1. **Platform CLI: remote server**
```bash
claude mcp add --transport http zuckerbot https://zuckerbot.ai/api/mcp
```

2. **Platform CLI**
```bash
claude mcp add --env ZUCKERBOT_API_KEY=<ZUCKERBOT_API_KEY> --transport stdio zuckerbot-meta-ads-mcp-server -- npx -y zuckerbot-mcp
```
Replace <…> with your own values

### Codex

1. **Platform CLI: remote server**
```bash
codex mcp add zuckerbot-meta-ads-mcp-server --url https://zuckerbot.ai/api/mcp
```

2. **Platform CLI**
```bash
codex mcp add zuckerbot-meta-ads-mcp-server --env ZUCKERBOT_API_KEY=<ZUCKERBOT_API_KEY> -- npx -y zuckerbot-mcp
```
Replace <…> with your own values

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "zuckerbot-meta-ads-mcp-server": {
            "url": "https://zuckerbot.ai/api/mcp"
        }
    }
}
```
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "zuckerbot-meta-ads-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "zuckerbot-mcp"
            ],
            "env": {
                "ZUCKERBOT_API_KEY": "<ZUCKERBOT_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "zuckerbot-meta-ads-mcp-server": {
            "type": "http",
            "url": "https://zuckerbot.ai/api/mcp"
        }
    }
}
```
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "zuckerbot-meta-ads-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "zuckerbot-mcp"
            ],
            "env": {
                "ZUCKERBOT_API_KEY": "<ZUCKERBOT_API_KEY>"
            }
        }
    }
}
```
Replace <…> with your own values

### Gemini CLI

1. **Platform CLI: remote server**
```bash
gemini mcp add -t http zuckerbot-meta-ads-mcp-server https://zuckerbot.ai/api/mcp
```

2. **Platform CLI**
```bash
gemini mcp add -e ZUCKERBOT_API_KEY=<ZUCKERBOT_API_KEY> zuckerbot-meta-ads-mcp-server npx -y zuckerbot-mcp
```
Replace <…> with your own values

## When to use it
- audit an ad account and find where spend is being wasted
- build a campaign with targeting and budget from the chat window
- create a lookalike audience from an existing seed
- set up server-side conversion tracking with CAPI
- pull campaign metrics: spend, leads, CPL, CTR, ROAS

## Example prompts
- Audit my ad account and tell me what to fix first
- Draft a leads campaign with a 5000 budget and suggest creative angles
- Build a lookalike audience from my current seed audience

## Similar
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107423
- [openshorts](https://affpapa.org/en/nevibecode/mcp/openshorts.md) — MCP server · ★ 7049
- [OpenScreen](https://affpapa.org/en/nevibecode/mcp/openscreen.md) — MCP server · ★ 4863
- [Usertour MCP Server](https://affpapa.org/en/nevibecode/mcp/usertour-mcp-server.md) — MCP server · ★ 2326
- [Appllama](https://affpapa.org/en/nevibecode/mcp/appllama.md) — MCP server · ★ 3046
- [obsei](https://affpapa.org/en/nevibecode/mcp/obsei.md) — MCP server · ★ 1441

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md