Connects to Facebook Ads via the official Meta Marketing API, enabling analysis and management of Facebook ad accounts, campaigns, ad sets, ads, creatives, images/videos, custom audiences, pixels, lead generation forms, and performance insights (ROAS, CPM, CPC, conversions). Supports creating and updating campaigns, ad sets, ads, and creatives (created paused) as well as deleting them.
Covers Instagram advertising within the same Meta connection, including listing Instagram accounts available to an ad account and analyzing Instagram ad campaign and placement performance.
Integrates with Meta Business Suite advertising data through Meta's Marketing API, providing tools for account structure management, audience/targeting research (interests, behaviors, demographics, geo locations, audience size estimation), change history, and reporting across Facebook and Instagram ad accounts.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Facebook Ads MCP Server show me last month's campaign performance and ROAS"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
Connect Facebook Ads and Instagram Ads to AI assistants with the Model Context Protocol (MCP).
Part of the Insightful Pipe MCP Server Collection — The Facebook Ads MCP server enables Claude, ChatGPT, Cursor, and other AI assistants to analyze your Meta advertising campaigns. Get AI-powered insights, automate reporting, and optimize your Facebook and Instagram ad performance.
https://facebook-ads.insightfulmcp.com/Related MCP server: Meta Marketing API MCP Server
Facebook Ads MCP is a remote Model Context Protocol server that connects your Meta Business Suite advertising data to AI assistants. This integration allows you to:
Analyze Facebook and Instagram ad performance with natural language
Get AI-powered optimization recommendations
Monitor ROAS, CPM, CPC, and conversion metrics
Create and manage campaigns and ad sets
Search for targeting options and estimate audience sizes
Copy the MCP Server URL: https://facebook-ads.insightfulmcp.com/
Scroll to the bottom and click Add custom connector
Paste the URL and click Add
Click Connect and sign in to InsightfulPipe if asked. Claude then lists the connector as connected.
Custom MCP servers are added through ChatGPT's Developer mode. Availability depends on your ChatGPT plan, and workspace admins may need to allow it.
Turn on Developer mode in ChatGPT settings
Create a new app for a remote MCP server and paste the URL: https://facebook-ads.insightfulmcp.com/
Sign in to InsightfulPipe if asked. The connection finishes as soon as you are signed in.
See OpenAI's guide: Developer mode and MCP apps in ChatGPT
claude mcp add --transport http facebook-ads https://facebook-ads.insightfulmcp.com/Add the server to ~/.cursor/mcp.json (all projects) or .cursor/mcp.json (one project):
{
"mcpServers": {
"facebook-ads": {
"url": "https://facebook-ads.insightfulmcp.com/"
}
}
}When Cursor shows Needs authentication, click Connect and sign in to InsightfulPipe if asked.
53 actions: 38 read, 15 write.
Action | Description |
| Estimate audience size for targeting specifications |
| Retrieve change history for an ad account |
| Retrieve change history for an ad set |
| Fetch details for a single ad |
| Fetch details for a single ad creative |
| List ad creatives for an ad account |
| Get the creative for a specific ad |
| List ad images for an ad account |
| Generate a preview rendering for an existing ad |
| List ad videos for an ad account |
| Fetch details for a single ad account |
| List ads for an ad account, campaign, or ad set |
| List ads for a specific ad set |
| List ads for a specific campaign |
| Fetch details for a single ad set |
| List ad sets for an ad account or campaign |
| List ad sets for a specific campaign |
| Fetch details for a single campaign |
| List campaigns for an ad account |
| List custom audiences for an ad account |
| Get details for a specific custom conversion |
| List custom conversions for an ad account |
| Retrieve performance insights for an ad |
| Retrieve performance insights for an ad account |
| Retrieve performance insights for an ad set |
| Retrieve performance insights for a campaign |
| List Instagram accounts available to the selected ad account |
| Get interest suggestions based on existing interests |
| List lead generation forms for a Facebook Page |
| Discover lead generation forms already referenced by creatives in a Facebook ad account |
| List Meta's minimum budget values for the ad account by currency |
| List Facebook Pages usable with this Ads connection in the selected workspace and brand |
| List tracking pixels for an ad account |
| List saved audiences for an ad account |
| Search for behavior targeting options by keyword |
| Search demographic targeting options |
| Search for geographic targeting locations |
| Search for interest targeting options by keyword |
Action | Description |
| Create a new ad (created in PAUSED status) |
| Create a new ad creative |
| Create a new ad set (created in PAUSED status) |
| Create a new campaign (created in PAUSED status) |
| Create a new custom conversion for an ad account |
| Create a lead generation form on a Facebook Page |
| Permanently DELETE an ad |
| Permanently DELETE an ad set (and all its ads) |
| Permanently DELETE a campaign (and all its ad sets + ads) |
| Update an existing ad |
| Update an existing ad creative (name or labels only) |
| Update an existing ad set |
| Update an existing campaign |
| Upload an image to the ad account from a public URL or base64-encoded bytes |
| Upload a video to the ad account from a URL or create a slideshow |
You decide what AI agents can do with each connected account:
Turn individual actions on or off for every connected account, so agents only see the actions you allow.
Connect as Read-only or Read & Write. A read-only connection can only enable read actions.
Destructive actions stay off by default. Actions such as deletes are disabled until an admin enables them.
Team access per account. Restricted team members only use the accounts they are granted, with the read actions enabled on them.
New Meta campaigns are created paused, so nothing spends until you turn it on.
"Show me my Facebook Ads performance for Q4 2024""Which audiences have the best ROAS on my Instagram campaigns?""Search for interests related to 'fitness' for targeting""Estimate the audience size for women 25-34 interested in yoga in California""Create a new conversions campaign called 'Holiday Sale' with a $100 daily budget"Awareness Campaigns - Brand awareness and reach
Traffic Campaigns - Website and app traffic
Engagement Campaigns - Post engagement, page likes, event responses
Lead Generation - Lead form campaigns
Sales Campaigns - Catalog sales and conversions
App Promotion - App installs and engagement
Unified Meta analytics - Facebook + Instagram in one place
Conversational reporting - Ask questions, get answers
Time savings - No more manual report building
Catalog sales tracking - Monitor product-level performance
ROAS optimization - AI-driven budget recommendations
Audience discovery - Find high-converting segments
Multi-account support - Manage client accounts efficiently
Automated reporting - Generate client reports
Scalable workflows - Handle more clients with AI
Official Meta Marketing API - Direct integration with Meta's API
OAuth 2.0 - Secure Meta authentication
Granular permissions - Control read vs write access
The Facebook Ads MCP server is included in every InsightfulPipe plan, together with all other MCP servers and the CLI. Plans start at $29.99/month, and you can try it for 7 days. See insightfulpipe.com/pricing for current plans.
Claude skills for Meta Ads — ready-made skills that run on your connected data
Visit insightfulpipe.com/mcp-servers to discover our full collection of MCP servers for marketing and analytics.
Google Ads MCP - Google advertising
TikTok Ads MCP - TikTok advertising
LinkedIn Ads MCP - B2B advertising
Microsoft Ads MCP - Bing advertising
Pinterest Ads MCP - Pinterest advertising
Snapchat Ads MCP - Snapchat advertising
Instagram MCP - Organic Instagram analytics
YouTube MCP - YouTube analytics
Facebook Pages MCP - Page management
Documentation: insightfulpipe.com/docs
All MCP Servers: insightfulpipe.com/mcp-servers
Email: support@insightfulpipe.com
Insightful Pipe — AI-powered marketing analytics through MCP servers. Explore all integrations →
MIT License - see LICENSE for details.
This server cannot be deployed
Connect authorized ad accounts to AI assistants for audits, reporting, and approval-gated changes.
Read and manage Meta Ads campaigns, ad sets, ads, audiences, pages and Business Manager. You provide
Meta ads from your AI assistant: results, wasted spend, campaigns. Every change is previewed first.
Launch Meta ads with your AI agent. Bulk-create Facebook and Instagram ads, import creatives from public Google Drive links, and launch partnership ads with authorized creators. Reuse proven ad settings, create fresh variations, and review saved builds and previews before launch. Requires an Ads Uploader account with MCP access and a connected Meta account.
