pipeboard-co/meta-ads-mcp
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.
1,146 ★261 forksPythonUpdated 7d ago
What you need to know
A remote MCP server (streamable HTTP) that lets AI assistants run Meta Ads end to end - launching campaigns, uploading creatives, updating budgets, and analyzing performance across Facebook, Instagram, and all Meta ad surfaces via natural language; part of the 5-platform Pipeboard MCP family (230+ tools).
Install
Remote (recommended): connect to https://meta-ads.mcp.pipeboard.co/ in any MCP client (no developer token, no self-hosting)
Cursor: add { "url": "https://meta-ads.mcp.pipeboard.co/" } to ~/.cursor/mcp.json
Claude: add integration URL at claude.ai/settings/integrations (requires Claude Pro/Max)
Direct token auth: append ?token=YOUR_PIPEBOARD_TOKEN to the URL (token from pipeboard.co/api-tokens)Usage
- •Connect your Facebook Ads account once at pipeboard.co; every client then gets access
- •Ask the LLM to analyze campaign performance, create campaigns (objectives must be outcome-based: OUTCOME_AWARENESS/TRAFFIC/ENGAGEMENT/LEADS/SALES/APP_PROMOTION), create ad sets and ads, upload images, and update budgets
- •Every write requires explicit confirmation; new campaigns start paused
- •Local installation (advanced) requires creating your own Meta Developer App; streamable HTTP setup guide available
Key features
- ✓42 remote MCP tools: campaigns, ad sets, ads, creatives (incl. dynamic creative testing), image upload, insights, interest/behavior/demographic/geo targeting, page management
- ✓Cross-platform family: Meta + Google + TikTok + Snap + Reddit behind one auth, one safety model (230+ tools total)
- ✓Dynamic creative testing - one API for simple ads and full A/B variant testing; AI-powered campaign analysis and strategic recommendations
- ✓Budget optimization recommendations, automated performance monitoring, enhanced generic search with page search
- ✓Pipeboard CLI (single Go binary) wraps the same tools as typed shell commands for AI coding agents
- ✓Badged Meta Business Partner with an officially approved Meta app; free plan then paid tiers
Best for
Marketers and agencies who want to manage Meta (Facebook/Instagram) ads conversationally from any AI client without self-hosting.
Caveats
- ⚠Hosted service: free plan, then paid tiers (Pipeboard.co); local install requires your own Meta Developer App
- ⚠Licensed under Business Source License 1.1 - free to use/modify/redistribute but cannot offer as a competing hosted service; converts to Apache 2.0 on January 1, 2029
- ⚠Legacy Meta campaign objectives (BRAND_AWARENESS, LINK_CLICKS, CONVERSIONS, etc.) are no longer valid and cause 400 errors - use outcome-based objectives
- ⚠Meta brand names are trademarks of their respective owners (independent project using Meta's public APIs)
Platforms: Windows · macOS · LinuxClients: Claude (Pro/Max) · Cursor · ChatGPT · Perplexity · Cherry Studio · OpenClaw · any MCP-compatible client
Documentation ↗Reviewed 2026-08-07
Topics
advertisingai-agentschatgptclaudefacebook-adsinstagram-adsmcpmeta-adsmodel-context-protocolpipeboard
- Stars
- 1,146★
- Forks
- 261
- Language
- Python
- License
- NOASSERTION
- Created
- 2025-04-11
- Last push
- 2026-07-30