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
View on GitHub ↗
Stars
1,146★
Forks
261
Language
Python
License
NOASSERTION
Created
2025-04-11
Last push
2026-07-30