# Meta Ads MCP Server

This MCP server lets an AI agent manage Meta Ads campaigns, inspect performance, work with targeting, and upload media.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 8
- Author: cesteral
- License: Apache-2.0 · policy=link-only · description only; the file stays with the author
- Source: https://github.com/cesteral/mcp-open-advertising
- Updated: 2026-10-21
- HTML: https://affpapa.org/en/nevibecode/mcp/meta-ads-mcp-server

## What it does

Meta Ads MCP Server connects an MCP client to Meta Marketing API v26.0. Its tools cover campaign creation and changes, insights, targeting discovery, delivery estimates, ad previews, bulk operations, and media uploads.

You can run it locally through `@cesteral/meta-mcp` with `npx`, or connect to a Streamable HTTP deployment at `https://{host}/meta-mcp/mcp`. The project describes this connector as self-hostable and lists 27 tools for the Meta Ads server.

A Meta Marketing API Bearer token is required. Without that credential, the server cannot access the advertising account, so authentication has to be ready before testing agent requests.

## Requirements
- Needs: Node.js (commands run via npx)
- Remote server: `https://{host}/meta-mcp/mcp`

## Install

### Claude Code (native platform)

1. **Platform CLI**
```bash
claude mcp add meta-ads-mcp-server -- npx -y @cesteral/meta-mcp
```

2. **Platform CLI: remote server**
```bash
claude mcp add --transport http meta-mcp https://{host}/meta-mcp/mcp
```

### Codex

1. **Platform CLI**
```bash
codex mcp add meta-ads-mcp-server -- npx -y @cesteral/meta-mcp
```

2. **Platform CLI: remote server**
```bash
codex mcp add meta-ads-mcp-server --url https://{host}/meta-mcp/mcp
```

### Cursor

1. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "meta-ads-mcp-server": {
            "command": "npx",
            "args": [
                "-y",
                "@cesteral/meta-mcp"
            ]
        }
    }
}
```

2. **Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "meta-ads-mcp-server": {
            "url": "https://{host}/meta-mcp/mcp"
        }
    }
}
```

### GitHub Copilot

1. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "meta-ads-mcp-server": {
            "type": "stdio",
            "command": "npx",
            "args": [
                "-y",
                "@cesteral/meta-mcp"
            ]
        }
    }
}
```

2. **Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "meta-ads-mcp-server": {
            "type": "http",
            "url": "https://{host}/meta-mcp/mcp"
        }
    }
}
```

### Gemini CLI

1. **Platform CLI**
```bash
gemini mcp add meta-ads-mcp-server npx -y @cesteral/meta-mcp
```

2. **Platform CLI: remote server**
```bash
gemini mcp add -t http meta-ads-mcp-server https://{host}/meta-mcp/mcp
```

## When to use it
- create and update Meta Ads campaigns
- pull performance data through insights
- discover suitable ad targeting
- estimate campaign delivery
- upload media and inspect ad previews

## Example prompts
- Pull Meta Ads insights for this campaign and explain the main changes.
- Draft a campaign with this targeting, then show the ad preview before applying it.
- Upload this media file and prepare a bulk update for the selected campaigns.

## Similar
- [labelhead-artist-momentum](https://affpapa.org/en/nevibecode/mcp/labelhead-artist-momentum.md) — MCP server · ★ 107701
- [openshorts](https://affpapa.org/en/nevibecode/mcp/openshorts.md) — MCP server · ★ 7132
- [OpenScreen](https://affpapa.org/en/nevibecode/mcp/openscreen.md) — MCP server · ★ 4963
- [Usertour MCP Server](https://affpapa.org/en/nevibecode/mcp/usertour-mcp-server.md) — MCP server · ★ 2329
- [Appllama](https://affpapa.org/en/nevibecode/mcp/appllama.md) — MCP server · ★ 3228
- [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