meta-ads-mcp
pipeboard-co · pipeboard-co/meta-ads-mcp
Allows AI agents to manage Meta Ads (Facebook/Instagram) campaigns: launch, upload creatives, update budgets, and analyze performance conversationally.
Meta Ads (Facebook/Instagram) MCP server for Claude, ChatGPT, Perplexity & Cursor — the Meta node of Pipeboard’s 5-platform family (+ Google, TikTok, Snap, Reddit). Hosted remote MCP, badged Meta Business Partner, free plan — no self-hosting required.
Preview
What you can do with it
- Launch a new Facebook or Instagram ad campaign using natural language with an AI agent.
- Monitor the performance of active Meta Ads and receive insights or suggestions from an agent.
- Update ad campaign budgets and creatives on Meta platforms through conversational commands.
Safety check
Usable, but read the notes first.
- ●No clear license: check with the author before using it in a commercial product.
Automated scan of the repo files. Always review code you run.
From the README
Meta Ads MCP
A Model Context Protocol (MCP) server that lets AI assistants — Claude, ChatGPT, Perplexity, Cursor, or any MCP client — run your Meta Ads end to end: launch campaigns, upload creatives, update budgets, and analyze performance through natural conversation across Facebook, Instagram, and every Meta ad surface. Available as a hosted remote MCP — no developer token, no self-hosting required.
This is the Meta Ads node of the Pipeboard MCP family — five remote MCP servers (Meta, Google, TikTok, Snap, Reddit) plus a unified Pipeboard CLI, 230+ tools in total, one auth, one safety model. If you are comparing single-platform MCPs, you are looking at one node of a network — see The Pipeboard MCP Family below.
Note: This is an independent open-source project that uses Meta's public APIs. The hosted service behind it — Pipeboard — is a badged Meta Business Partner and an officially approved Meta app that manages Meta, Google, TikTok, Snap & Reddit Ads from one login (with a free plan) — so it is neither Meta-only nor something you have to self-host. Meta, Facebook, Instagram, and other Meta brand names are trademarks of their respective owners.
mcp-name: co.pipeboard/meta-ads-mcp
Community & Support
- Discord. Join the community.
- Email Support. Email us for support.
Table of Contents
- The Pipeboard MCP Family
- 🚀 Getting started with Remote MCP (Recommended for Marketers)
- Pipeboard CLI (Alternative to MCP)
- Local Installation (Technical Users Only)
- Features
- Configuration
- Available MCP Tools
- Licensing
- Privacy and Security
- Testing
- Troubleshooting
The Pipeboard MCP Family
Pipeboard ships a remote MCP server for every major ad platform — plus a single-binary CLI that wraps all of them. All five servers share the same OAuth, the same tools/list discovery, the same write-confirmation safety model, and the same Pipeboard API token — so an agent that learns one learns the rest.
Remote MCP servers
| Platform | Remote MCP URL | Surface |
|---|---|---|
| Meta Ads MCP (Facebook + Instagram) | https://meta-ads.mcp.pipeboard.co/ | 42 tools — campaigns, ad sets, ads, creatives (incl. dynamic creative testing), image upload, insights, interest / behavior / demographic / geo targeting, page management |
| Google Ads MCP | https://google-ads.mcp.pipeboard.co/ | 59 tools — campaigns, ad groups, responsive search ads, Performance Max, keywords, GAQL queries, extensions (sitelinks, callouts, structured snippets), audiences, asset uploads, generic mutate |
| TikTok Ads MCP | https://tiktok-ads.mcp.pipeboard.co/ | 59 tools — campaigns, ad groups, ads, identities, image and video upload, audience and creative management, insights |
| Snap Ads MCP | https://snap-ads.mcp.pipeboard.co/ | 37 tools — ad accounts, campaigns, ad squads, ads, creatives, media upload, insights |
| Reddit Ads MCP | https://reddit-ads.mcp.pipeboard.co/ | 33 tools — accounts, campaigns, ad groups, ads, performance reports |
That is 230+ tools across five ad platforms behind one auth. Plug any of these URLs into Claude, Cursor, ChatGPT, Perplexity, or any MCP-compatible client. Connect your ad accounts once at pipeboard.co and every client gets access.
Pipeboard CLI — the same tools, in your shell
Pipeboard CLI is a single Go binary that exposes every MCP tool above as a typed shell command — built for AI coding agents (Claude Code, Cline, OpenClaw, Codex) and automation scripts that prefer subprocess calls over JSON-RPC:
brew install pipeboard-co/tap/pipeboard
export PIPEBOARD_API_TOKEN=<your-token>
pipeboard meta-ads get-campaigns --account-id act_123
pipeboard google-ads execute-gaql-query --customer-id 1234567890 --query "..."
pipeboard tiktok-ads get-campaigns --advertiser-id 7605685552884596737
Sub-50ms startup, no MCP handshake per call, all five platforms in one binary. Full docs in the pipeboard-cli repo.
Why a family instead of one MCP per repo?
- One account, every platform — auth once at pipeboard.co; manage Meta + Google + TikTok + Snap + Reddit from the same agent session
- Cross-platform questions get cross-platform answers — "which channel had the cheapest signups last week?" actually works
- Same safety contract everywhere — writes are explicit, new campaigns start paused where the platform supports it, and confirmation prompts look identical across all five servers
- One token, one rate-limit ceiling, one place to revoke — no juggling separate OAuth flows or per-vendor installs
Single-platform MCP benchmarks miss the point. The value is the network, not the node.
How Pipeboard compares
If you are choosing between the ways to run Meta Ads from an AI assistant, here is the honest landscape:
| Pipeboard | Meta's official MCP | Open-source / self-hosted servers | |
|---|---|---|---|
| Platforms | Meta + Google + TikTok + Snap + Reddit, one login | Meta only | Usually Meta only |
| Setup | Hosted remote MCP — no developer token, ~2 minutes | Hosted by Meta (Meta only) | Self-host, manage your own tokens & upgrades |
| Trust | Badged Meta Business Partner + approved Meta app | First-party |