A Model Context Protocol (MCP) server that lets AI assistants (Claude, ChatGPT, Gemini, Cursor, Perplexity, or any MCP client) run Meta Ads end to end on Facebook and Instagram. 82 typed tools with full write access, built by a Meta Tech Partner, approval-gated writes, and 13 more ad and measurement platforms in the same session. 460+ tools across 14 platforms in total.
Also known as a Facebook Ads MCP. Meta owns Facebook and Instagram, and its ads API covers both surfaces from one connection. If you searched for a Facebook Ads MCP, this is the same product.
Hosted at paidsync.ai. Free plan: 15 tasks a month, no card required.
PaidSync's Meta Ads MCP surface, exposed to any AI assistant that speaks the Model Context Protocol. The full product page lives at paidsync.ai/meta-ads-mcp. This repository is the developer entry point.
Three properties that set this Meta Ads MCP apart from Meta's own reference connector and every current community option:
- 82 Meta tools with full write access. Campaign duplication (
duplicate_fb_campaign), Advantage+ audience expansion, DCO creatives viacreate_fb_dco_ad, image and video uploads withvalidate_fb_ad_assetspre-publish checks, custom, lookalike, and engagement audiences, automated rules, pixels, custom conversions, billing transactions, and performance reporting with breakdowns by placement, device, country, age, gender, and time. - Deeper write surface than Meta's official connector. Meta's first-party Ads AI Connector covers reporting, campaign management, catalog management, and signal diagnostics. PaidSync's Meta surface is 82 tools including duplication, DCO creatives, dayparting, and automated rules. Both can run side by side in the same MCP client.
- 13 more platforms in the same session. Google Ads (133 tools), LinkedIn (25), TikTok (13), GA4 (26), GTM (39), Search Console (6), Merchant Center (16), plus Microsoft, Snapchat, Reddit, Pinterest, X Ads, and ChatGPT Ads. Cross-platform attribution and reporting land in one conversation, not four tabs.
{
"mcpServers": {
"paidsync": {
"url": "https://mcp.paidsync.ai/mcp?key=YOUR_API_KEY"
}
}
}Get your API key at paidsync.ai/signup.
Add a custom MCP integration with the same URL. Setup guides:
- Connect Meta Ads to Claude
- Connect Meta Ads to ChatGPT
- Connect Meta Ads to Gemini
- Connect Meta Ads to Perplexity
- Connect Meta Ads to Copilot
paidsync_context({ include_tools: ['meta_ads'] })
paidsync_exec({ tool: 'get_fb_campaign_performance', args: { date_range: 'last_7_days' } })
Copy-pasteable configs and prompts live in examples/:
- claude_desktop_config.json, Claude Desktop
- claude_code.md, Claude Code CLI, the exact
claude mcp addcommand and how to verify it - cursor_mcp.json, Cursor
- windsurf_mcp_config.json, Windsurf
- prompts.md, real Meta Ads prompts you can paste straight into chat
Installing this for someone else as an AI agent? Follow llms-install.md.
| Category | Named tools |
|---|---|
| Account and identity | connect_facebook_ads, list_fb_ad_accounts, set_fb_ad_account, list_fb_pages, list_fb_instagram_accounts |
| Campaign lifecycle | list_fb_campaigns, create_fb_campaign, update_fb_campaign, duplicate_fb_campaign, pause_fb_campaign, enable_fb_campaign, delete_fb_campaign |
| Ad sets, budgets, schedules | list_fb_adsets, create_fb_adset, update_fb_adset, update_fb_adset_budget, set_fb_adset_schedule, pause_fb_adset, enable_fb_adset |
| Ads | list_fb_ads, create_fb_ad, update_fb_ad, pause_fb_ad, enable_fb_ad |
| Creative production | upload_fb_ad_image, upload_fb_ad_video, create_fb_creative, create_fb_dco_ad, validate_fb_ad_assets |
| Audiences and targeting | create_fb_custom_audience, create_fb_lookalike_audience, create_fb_engagement_audience, search_fb_interests, get_fb_audience_insights |
| Automated rules | create_fb_automated_rule |
| Reporting and pacing | get_fb_performance, get_fb_campaign_performance, get_fb_adset_performance, get_fb_ad_performance, get_fb_performance_by_placement, get_fb_performance_by_device, get_fb_performance_by_country, get_fb_performance_by_age_gender, get_fb_performance_by_time, get_fb_budget_pacing |
| Signals and billing | list_fb_pixels, get_fb_pixel_events, list_fb_custom_conversions, get_fb_billing_transactions |
Full live catalog at paidsync_context({ include_tools: ['meta_ads'] }).
| Plan | Price | Tasks | Notes |
|---|---|---|---|
| Free | $0/mo | 15 | No card required, all 14 platforms |
| Pro | From $99/mo | Up to 4,000 | Solo operators and small teams |
| Team | From $249/mo | 6,000 (5 seats) | Agencies and in-house teams |
| Done For You | Custom | Managed | PaidSync runs the accounts |
- Approval-gated. Every write is a proposal shown in chat before it applies.
- Dry-run previews on most mutations.
- Destructive-write second confirmation required.
- Revocable sessions from the PaidSync connect panel.
| PaidSync | Meta official Ads AI Connector | |
|---|---|---|
| Built by | PaidSync, Meta Tech Partner | Meta, first party |
| Meta coverage | 82 tools, full write access | Reporting, campaign management, catalog management, signal diagnostics |
| Platform scope | 14 (Google, Meta, LinkedIn, TikTok, X Ads, GA4, GTM, GSC, and more) | Meta only |
| Campaign duplication | Yes, duplicate_fb_campaign (paused) |
Campaign create and edit |
| DCO creatives | Yes | Ad creation via natural language |
| Automated rules | Yes | Not named in the capability areas Meta describes |
| Catalog management | Not in Meta tool set | Yes, named capability |
| Measurement stack (GA4, GTM, GSC) | Yes, same session | No |
| Price | Free $0 (15 tasks), Pro from $99/mo | See Meta's own connector documentation |
The Meta column lists capability areas rather than a tool count, because Meta ships continuously and any count printed here would go stale without warning. Check Meta's own connector documentation for current coverage, and open an issue if this table drifts.
Full comparison at paidsync.ai/vs/meta-mcp and paidsync.ai/vs/pipeboard.
MIT. See LICENSE.
- Product page: paidsync.ai/meta-ads-mcp
- MCP server overview: paidsync.ai/mcp-server
- Category guide: Best MCP for Meta Ads in 2026
- Meta bulk operations reference: paidsync.ai/docs/meta-bulk-operations
- Support: support@paidsync.ai
- Contributing: CONTRIBUTING.md
Built by Ahmed Ashraf, $500M+ in managed ad spend.