# KonQuest Meta Ads MCP

Manages Meta ad campaigns inside Claude Code under operator supervision. Handles campaign drafting, tracking audits, and targeting searches without unapproved budget changes.

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

## What it does

This server provides 57 open-source tools communicating with the Meta Marketing API. An agent can draft ad sets, upload creative assets, inspect catalog setups, and query audience criteria directly in chat. Tools are organized into read-only data queries, operator-confirmed writes, and advisory recommendations.

Safety mechanisms prevent accidental ad spend. The server initializes every new ad in a paused state. Every budget alteration, deletion, or campaign activation demands direct operator approval before execution.

A valid `META_ACCESS_TOKEN` is mandatory. Meta system user tokens are recommended. Without active credentials, the server cannot inspect accounts or apply campaign changes.

## Requirements
- Needs: Python and uv (commands run via uvx)
- Environment variables: `META_ACCESS_TOKEN` — keys and tokens: ask the human for the values, never commit them or put them in shared files.

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add konquest-meta-ads-mcp -e META_ACCESS_TOKEN=<META_ACCESS_TOKEN> -- uvx konquest-meta-ads-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from konquest-meta-ads-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add konquest-meta-ads-mcp --env META_ACCESS_TOKEN=<META_ACCESS_TOKEN> -- uvx konquest-meta-ads-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from konquest-meta-ads-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "konquest-meta-ads-mcp": {
            "command": "uvx",
            "args": [
                "konquest-meta-ads-mcp"
            ],
            "env": {
                "META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from konquest-meta-ads-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "konquest-meta-ads-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "konquest-meta-ads-mcp"
            ],
            "env": {
                "META_ACCESS_TOKEN": "<META_ACCESS_TOKEN>"
            }
        }
    }
}
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from konquest-meta-ads-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add -e META_ACCESS_TOKEN=<META_ACCESS_TOKEN> konquest-meta-ads-mcp uvx konquest-meta-ads-mcp
```
Replace <…> with your own values. uvx runs the command named after the package; if the README names another one, use uvx --from konquest-meta-ads-mcp <command>

## When to use it
- build paused ad campaigns and sets with structural validation
- inspect Meta Pixel health and event delivery setups
- look up targeting parameters for interests and geographic areas
- pull comparative performance stats across advertising accounts

## Example prompts
- Check the health and event status of my Meta Pixel
- Draft an ad set with paused video ads for the current campaign
- Search for targeting options related to running shoes in Germany

## 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