Meta Ads MCP by InsightfulPipe
Hosted Meta Ads MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
Install
Add this to your client's MCP configuration (Claude Desktop: claude_desktop_config.json; Cursor: .cursor/mcp.json; VS Code and others use the same "mcpServers" shape).
claude mcp add --transport http meta-ads-mcp-by-insightfulpipe 'https://facebook-ads.insightfulmcp.com/'{
"mcpServers": {
"meta-ads-mcp-by-insightfulpipe": {
"type": "http",
"url": "https://facebook-ads.insightfulmcp.com/"
}
}
}Documentation
From the project's README on GitHub, refreshed weekly. Links open on GitHub.
Contents
- Facebook Ads MCP Server (Meta Ads) by Insightful Pipe
- MCP Server URL
- What is Facebook Ads MCP?
- Installation
- Available Actions
- Control What Your AI Can Do
- Usage Examples
- Supported Campaign Types
- Why Choose Facebook Ads MCP?
- Security & Compliance
- Pricing
- Ready-Made Skills and Prompts
- Explore More MCP Servers by Insightful Pipe
- Resources
- Support
- License
Facebook Ads MCP Server (Meta Ads) by Insightful Pipe
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.
MCP Server URL
https://facebook-ads.insightfulmcp.com/What is Facebook Ads MCP?
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
Installation
Claude
- Copy the MCP Server URL:
https://facebook-ads.insightfulmcp.com/ - Open Claude Connectors Settings
- 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.
ChatGPT
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 Code
claude mcp add --transport http facebook-ads https://facebook-ads.insightfulmcp.com/Cursor
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.
Available Actions
53 actions: 38 read, 15 write.
Read Actions (38)
Show all 38 read actions
| Action | Description |
|---|---|
estimate_audience_size | Estimate audience size for targeting specifications |
get_activities_adaccount | Retrieve change history for an ad account |
get_activities_adset | Retrieve change history for an ad set |
get_ad | Fetch details for a single ad |
get_ad_creative | Fetch details for a single ad creative |
get_ad_creatives | List ad creatives for an ad account |
get_ad_creatives_by_ad | Get the creative for a specific ad |
get_ad_images | List ad images for an ad account |
get_ad_preview | Generate a preview rendering for an existing ad |
get_ad_videos | List ad videos for an ad account |
get_adaccount | Fetch details for a single ad account |
get_ads | List ads for an ad account, campaign, or ad set |
get_ads_by_adset | List ads for a specific ad set |
get_ads_by_campaign | List ads for a specific campaign |
get_adset | Fetch details for a single ad set |
get_adsets | List ad sets for an ad account or campaign |
get_adsets_by_campaign | List ad sets for a specific campaign |
get_campaign | Fetch details for a single campaign |
get_campaigns | List campaigns for an ad account |
get_custom_audiences | List custom audiences for an ad account |
get_custom_conversion | Get details for a specific custom conversion |
get_custom_conversions | List custom conversions for an ad account |
get_insights_ad | Retrieve performance insights for an ad |
get_insights_adaccount | Retrieve performance insights for an ad account |
get_insights_adset | Retrieve performance insights for an ad set |
get_insights_campaign | Retrieve performance insights for a campaign |
get_instagram_accounts | List Instagram accounts available to the selected ad account |
get_interest_suggestions | Get interest suggestions based on existing interests |
get_leadgen_forms | List lead generation forms for a Facebook Page |
get_leadgen_forms_by_account | Discover lead generation forms already referenced by creatives in a Facebook ad account |
get_minimum_budgets | List Meta's minimum budget values for the ad account by currency |
get_pages | List Facebook Pages usable with this Ads connection in the selected workspace and brand |
get_pixels | List tracking pixels for an ad account |
get_saved_audiences | List saved audiences for an ad account |
search_behaviors | Search for behavior targeting options by keyword |
search_demographics | Search demographic targeting options |
search_geo_locations | Search for geographic targeting locations |
search_interests | Search for interest targeting options by keyword |
Write Actions (15)
| Action | Description |
|---|---|
create_ad | Create a new ad (created in PAUSED status) |
create_ad_creative | Create a new ad creative |
create_adset | Create a new ad set (created in PAUSED status) |
create_campaign | Create a new campaign (created in PAUSED status) |
create_custom_conversion | Create a new custom conversion for an ad account |
create_leadgen_form | Create a lead generation form on a Facebook Page |
delete_ad | Permanently DELETE an ad |
delete_adset | Permanently DELETE an ad set (and all its ads) |
delete_campaign | Permanently DELETE a campaign (and all its ad sets + ads) |
update_ad | Update an existing ad |
update_ad_creative | Update an existing ad creative (name or labels only) |
update_adset | Update an existing ad set |
update_campaign | Update an existing campaign |
upload_ad_image | Upload an image to the ad account from a public URL or base64-encoded bytes |
upload_ad_video | Upload a video to the ad account from a URL or create a slideshow |
Control What Your AI Can Do
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.
Usage Examples
Campaign Performance Analysis
"Show me my Facebook Ads performance for Q4 2024"Audience Insights
"Which audiences have the best ROAS on my Instagram campaigns?"Search for Targeting Options
"Search for interests related to 'fitness' for targeting"Estimate Audience Size
"Estimate the audience size for women 25-34 interested in yoga in California"Create Campaign
"Create a new conversions campaign called 'Holiday Sale' with a $100 daily budget"Supported Campaign Types
- 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
Why Choose Facebook Ads MCP?
For Social Media Marketers
- Unified Meta analytics - Facebook + Instagram in one place
- Conversational reporting - Ask questions, get answers
- Time savings - No more manual report building
For E-commerce Brands
- Catalog sales tracking - Monitor product-level performance
- ROAS optimization - AI-driven budget recommendations
- Audience discovery - Find high-converting segments
For Agencies
- Multi-account support - Manage client accounts efficiently
- Automated reporting - Generate client reports
- Scalable workflows - Handle more clients with AI
Security & Compliance
- Official Meta Marketing API - Direct integration with Meta's API
- OAuth 2.0 - Secure Meta authentication
- Granular permissions - Control read vs write access
Pricing
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.
Ready-Made Skills and Prompts
- Claude skills for Meta Ads — ready-made skills that run on your connected data
Explore More MCP Servers by Insightful Pipe
Visit insightfulpipe.com/mcp-servers to discover our full collection of MCP servers for marketing and analytics.
Advertising MCP Servers
- 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
Social Media MCP Servers
- Instagram MCP - Organic Instagram analytics
- YouTube MCP - YouTube analytics
- Facebook Pages MCP - Page management
Resources
Support
- 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 →
License
MIT License - see LICENSE for details.
Frequently asked questions
What is Meta Ads MCP by InsightfulPipe?
Hosted Meta Ads MCP server for Claude, ChatGPT and Cursor, with each action switched per account.
How do I install Meta Ads MCP by InsightfulPipe?
It runs as a remote server. In Claude Code: claude mcp add --transport http meta-ads-mcp-by-insightfulpipe 'https://facebook-ads.insightfulmcp.com/'. For other clients, paste the JSON configuration from this page into their MCP settings.
Does Meta Ads MCP by InsightfulPipe need an API key?
Its registry entry lists no required key or secret. Some features may still need an account with the service it connects to.
Is Meta Ads MCP by InsightfulPipe open source?
Yes. Its code is on GitHub under the MIT license.
Who maintains Meta Ads MCP by InsightfulPipe?
It is published by Insightful-Pipe. AI.tn lists it but does not maintain or endorse it.
From the official MCP Registry. Listing is not an endorsement: review a server's code and permissions before giving it access to your data.