Facebook Ads MCP connector

What agents can do

• Reporting: insights at account, campaign, ad set and ad level with fields, breakdowns, action_breakdowns, date_preset, time_range, time_increment, filtering and level, plus account and ad set activity history.
• Structure: list, create and update campaigns, ad sets and ads, and preview ads.
• Creatives and media: create creatives, upload images and videos (video from a URL or as a slideshow), and list ad images and videos.
• Targeting research: search interests, behaviors, demographics and locations, get interest suggestions, estimate audience size, list custom and saved audiences, and check minimum budgets.
• Conversions and leads: list pixels and custom conversions, create custom conversions, and list or create lead forms.
• Pages and Instagram: list the Facebook Pages and Instagram accounts available to the ad account.

Before you connect

• A Facebook login with access to the ad account.
• To create lead forms, also connect the Page with the Facebook Pages connector.

Connect Facebook Ads

1. In the InsightfulPipe app, open Connectors, choose Facebook Ads and click Connect.
2. Choose Read Only or Read + Write.
3. Sign in with Facebook and approve access.
4. Select one or more ad accounts. Each ad account becomes its own connection.
5. Add the MCP server to Claude, ChatGPT or another client, then click Authorize access.

Permissions and safety

• Writes need Read + Write, which grants the ads_management permission.
• create_campaign, create_adset and create_ad always create objects PAUSED, even if the request asks for ACTIVE.
• Updates over MCP can only set status to PAUSED. Activate campaigns in Meta Ads Manager; the agent is told "Only status='PAUSED' is allowed" with the same advice.
• Budgets, bids, targeting and names can be changed without extra limits. Budgets are in cents of the account currency.
• delete_campaign, delete_adset and delete_ad are permanent and run immediately. They are destructive, so they stay off until an owner, admin or operator enables them in Configure actions for this account.
• Every ID in a request must belong to the selected ad account.

Limits

• Business Manager, product catalog and dataset actions need a separately scoped Meta connection. They don't work on an ad account connection and are hidden from agents.
• No custom or lookalike audience creation, and no lead retrieval (lead forms can be listed and created).
• update_ad_creative changes only the name and labels, and update_campaign cannot change the objective.
• Insights pages automatically, up to 1,000,000 rows. The connector uses Meta Graph API v25.0.

Example prompts

• "Show spend, purchases and ROAS by campaign for the last 7 days in Facebook Ads."
• "Break down last month's results by age and gender for the Summer Launch campaign."
• "Estimate the audience size for women 25 to 44 in Canada interested in yoga."
• "Create a paused traffic campaign with a $50 daily budget for the new landing page."

Troubleshooting

• "Requires a separately scoped Meta Business, Catalog, or Dataset connection": business, catalog and dataset actions are unavailable on an ad account connection.
• "This action is disabled for this connected account." Ask an owner, admin or operator to enable it.
• Wrong ad account: each call targets one ad account. If the ID doesn't match a connected account, the error lists the available_accounts.