otheroauth2

Meta Ads

Create, edit and get insights from ads across Meta technologies, including Facebook, Instagram, Messenger, WhatsApp and more.

Verdict

The Meta Ads MCP lets your team create, manage, and monitor Facebook and Instagram ad campaigns without leaving Switchy. @mention it to draft campaigns, build custom audiences, design ad creatives, or pull performance data for client reports. Marketing teams use it to spin up test campaigns during planning calls, while account managers pull live metrics to answer client questions in real time. You'll need a Meta Business account with ad creation permissions — the OAuth flow requests access to your ad accounts, so confirm which account you're connecting before approving. Creative asset uploads (images, videos) still happen in Meta's platform; this integration handles campaign structure and targeting.

Common use cases

  • Draft campaign structures during client kickoffs
  • Pull live ad performance for status reports
  • Build custom audiences from CRM lists
  • Test new ad creatives before budget approval
  • Archive underperforming campaigns in bulk

Integration

Vendor
Meta Ads
Category
other
Auth
OAUTH2
Tools
16
Composio slug
metaads

Tools

  • Create Ad

    Create a new ad within an ad set using the meta marketing api. supports various ad formats including image, video, carousel, and collection ads.

  • Create Ad Creative

    Create a new ad creative using the meta marketing api. ad creatives are reusable visual and interactive elements that define how your ad looks and behaves: - can be used in multiple ads - support various formats (image, video, carousel) - i

  • Create Ad Set

    Create a new ad set within a campaign using the meta marketing api. supports detailed targeting options, budgets, and optimization goals.

  • Create Campaign

    Create a new advertising campaign using the meta marketing api. supports various campaign objectives, budgets, and bidding strategies.

  • Create Custom Audience

    Create a new custom audience using the meta marketing api. supports various types of custom audiences including customer lists, website visitors, and app users.

  • Delete Ad Creative
    destructive

    Delete ad creative

  • Delete Campaign
    destructive

    Delete an advertising campaign using the meta marketing api. this marks the campaign as deleted, which prevents it from delivering ads. note that deleted campaigns are not permanently removed from meta's systems and can still be viewed in r

  • Get Ad Creative

    Get ad creative

  • Get Insights

    Get insights data for a meta ads object (ad account, campaign, ad set, or ad) using the meta marketing api. supports various metrics, breakdowns, and filtering options with flexible date ranges.

  • Pause Campaign

    Pause an advertising campaign using the meta marketing api. this stops the campaign from delivering ads but allows it to be resumed later. all child ad sets and ads will also be paused with an effective status of campaign paused.

  • Preview Ad Creative

    Preview ad creative

  • Read Ad Sets

    Retrieve ad sets from a meta ad account using the marketing api. returns information about the ad sets including their status, targeting, and other properties.

  • Resume Campaign

    Resume a paused advertising campaign using the meta marketing api. this sets the campaign status to active so it can deliver ads again. note that child ad sets and ads that were previously active will also resume delivery, but those that we

  • Update Ad Creative

    Update ad creative

  • Update Campaign

    Update an existing advertising campaign using the meta marketing api. allows modification of campaign properties like name, status, budget, and bidding strategy. only the fields that need to be updated should be included in the request.

  • Upload Ad Image

    Upload an image for use in meta ad creatives using the marketing api. the image can later be referenced by its hash when creating ad creatives.

Setup

Setup guide

  1. 11. Open your Switchy workspace and navigate to Settings > Integrations. 2. Search for 'Meta Ads' and click Connect. 3. You'll be redirected to Meta's OAuth screen — log in with the Facebook account that manages your ad accounts. 4. Meta will ask you to grant permissions for ads_management and ads_read scopes; approve both to enable full campaign control. 5. Select which ad account(s) Switchy can access, then click Continue. 6. You'll return to Switchy with a green 'Connected' badge next to Meta Ads. 7. Create or open a Space, type '@Meta Ads what campaigns are currently running?' and send. 8. If the MCP responds with campaign data, your connection is live. 9. To create a campaign, @mention Meta Ads with your objective, budget, and targeting criteria — it will walk you through the required fields.

What teammates see: by default, memories from Meta Ads are scoped to the Space (PROJECT visibility) - you can mark any memory PRIVATE or share it ORG-wide.

Works well with

Top models

Compatibility data appears once enough Spaces have used this MCP together with a given model.

How Switchy teams use it

Not enough Spaces yet to publish anonymised usage stats (we require ≥ 50 Spaces per week).

Starter prompts

List Active Campaigns

@Meta Ads show me all active campaigns in the account, including daily budget and objective for each
Open in a Space →

Create Awareness Campaign

@Meta Ads create a brand awareness campaign targeting women 25-45 in California interested in sustainable fashion, $50 daily budget
Open in a Space →

Build Custom Audience

@Meta Ads create a custom audience named 'Q1 Newsletter Subscribers' from the email list I'll provide next
Open in a Space →

Design Ad Creative

@Meta Ads create a single image ad creative with headline 'Spring Sale Ends Sunday' and description 'Save 30% on all outdoor gear' for the summer campaign
Open in a Space →

Pause Low Performers

@Meta Ads find all ad sets with CTR below 1% in the last 7 days and pause them
Open in a Space →

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Prompt

@Meta Ads show me all active campaigns with their daily spend and ROAS for the last 7 days, grouped by objective

Output

Here's a summary of your active Meta Ads campaigns over the past week: **Conversion Campaigns (3 active)** - Summer Sale 2024: $450/day spend, 3.2x ROAS - Product Launch Q2: $280/day spend, 2.8x ROAS - Retargeting - Cart Abandoners: $120/day spend, 4.1x ROAS **Traffic Campaigns (2 active)** - Blog Content Promotion: $85/day spend, 1.9x ROAS - Landing Page Test: $60/day spend, 2.1x ROAS Total daily spend: $995 | Average ROAS: 3.0x This is an illustrative example based on typical campaign structures.

Notes

This read-heavy example demonstrates the MCP's ability to aggregate performance data across campaigns. Requires ads_read permission scope. Actual metrics depend on your Meta Ads account's attribution window settings and conversion tracking setup. ROAS calculations may vary based on your configured conversion events.

Prompt

@Meta Ads create a new conversion campaign targeting US women 25-45 interested in sustainable fashion, $100 daily budget, start tomorrow

Output

Campaign created successfully: **Campaign ID:** 120394857362 **Name:** Sustainable Fashion - US Women 25-45 **Objective:** Conversions **Status:** Scheduled (starts tomorrow at 12:00 AM PST) **Budget:** $100/day **Targeting:** US, Women, Ages 25-45, Interests: Sustainable Fashion, Eco-Friendly Products **Optimization:** Maximize conversions Next steps: You'll need to create an ad set and ad creative to complete this campaign. The campaign is currently in draft status until ads are added. This is an illustrative example of the creation flow.

Notes

This write example shows campaign creation with targeting parameters. Requires ads_management permission scope. The MCP creates the campaign structure but doesn't automatically generate ad creatives—you must create those separately using the Create Ad Creative and Create Ad tools. Be aware that campaign creation immediately affects your Meta Ads account state.

Prompt

@Meta Ads analyze my top 5 performing ad creatives from last month and suggest which elements to reuse in a new campaign for our spring collection

Output

Based on your top 5 ad creatives from March (sorted by CTR and conversion rate), here are the winning patterns: **Visual Elements:** - Lifestyle imagery outperformed product-only shots by 2.3x - Vertical video (9:16) had 40% higher engagement than square format - Warm color palettes (coral, terracotta) drove 28% more clicks **Copy Patterns:** - Headlines under 30 characters performed best - CTAs emphasizing limited availability increased urgency - Benefit-focused copy beat feature lists **Recommendation:** For your spring collection, prioritize vertical video showcasing products in lifestyle contexts, use warm spring tones, keep headlines concise, and emphasize seasonal availability. This analysis is illustrative based on common performance patterns.

Notes

This synthesis example pairs the MCP's data retrieval with AI reasoning to extract actionable insights. The AI analyzes creative performance metrics and identifies patterns humans might miss. Requires historical data spanning at least 30 days and sufficient ad creative volume for meaningful comparison. The recommendations are interpretive—always A/B test before scaling.

Use-case deep-dives

E-commerce seasonal campaign launch

When Meta Ads MCP beats manual campaign setup for product drops

A 6-person DTC brand launches 4 seasonal collections per year, each needing 12-20 ad variants across carousel, video, and static formats. The Meta Ads MCP wins here because the team can template campaign structures in Switchy—defining ad sets by audience segment, creative variants by product line—and push them live in one session instead of clicking through Ads Manager 80 times. The OAuth2 flow means the media buyer authenticates once and the whole team references the same account. The threshold: if you're running fewer than 8 ads per quarter, the MCP setup overhead isn't worth it. But at seasonal scale, this cuts launch day from 6 hours to 45 minutes. Use this when your creative-to-campaign ratio is high and you're coordinating across designers, copywriters, and media buyers in the same workspace.

Agency client reporting automation

How small agencies use this MCP to pull campaign data without exports

A 3-person performance marketing agency manages 9 client accounts, each running 15-30 active campaigns. The Meta Ads MCP solves the weekly reporting grind: instead of logging into 9 Ads Manager dashboards and exporting CSVs, the team queries campaign performance, ad creative stats, and audience reach directly in Switchy. The 16 tools include reads for campaigns, ad sets, and creatives, so they can pull last week's spend-by-objective or CTR-by-creative in natural language. The trade-off: if you need attribution modeling or cross-platform dashboards, you still need a BI tool. But for quick client check-ins or anomaly detection—'which campaign spiked CPM yesterday?'—this beats the export-pivot-table loop. Agencies running 5+ accounts should authenticate and start querying; solo freelancers can skip it.

Product team ad testing coordination

When this MCP streamlines creative testing for growth teams

A 5-person growth team at a B2C SaaS company runs 20 A/B tests per month, each comparing 3-5 ad creatives against different audience segments. The Meta Ads MCP fits when the PM, designer, and growth lead need to coordinate test setup without waiting on the media buyer. The team defines test parameters in Switchy—create ad sets with identical budgets, swap in creative variants, set optimization goals—and the MCP pushes the structure live. The 'Create Custom Audience' and 'Create Ad Creative' tools mean they can iterate on targeting and visuals in the same session. The boundary: if your test cadence is under 5 per month, manual setup is faster. Above that, the MCP saves 2-3 hours per test cycle. Use this when your growth team treats ad testing like product experiments, not one-off campaigns.

Frequently asked

What does the Meta Ads MCP let me do in Switchy?

It connects your Meta ad account so you can create and manage campaigns, ad sets, ads, and creatives directly from Switchy's AI workspace. You can also build custom audiences and delete campaigns without switching to Ads Manager. The MCP exposes 16 tools covering the full campaign lifecycle, from objective selection to creative upload.

What OAuth permissions does Meta Ads ask for when I connect?

Meta requires ads_management and ads_read scopes at minimum. If you're creating custom audiences from customer lists, you'll also grant audience_management. You need admin or advertiser access to the ad account you're connecting — analyst roles won't work. The OAuth flow redirects to Meta's consent screen where you approve these scopes.

Can the MCP pause ads or adjust budgets mid-campaign?

No. The current tool set covers creation and deletion but not live editing. If you need to pause an ad set or change the daily budget, open Ads Manager or use Meta's Graph API directly. We're adding update tools in a future release, but for now treat this MCP as a campaign-launch workflow, not a real-time optimisation dashboard.

Why use this instead of just logging into Ads Manager?

Speed and context. If your team already discusses creative briefs and audience strategy in Switchy, the MCP lets you spin up campaigns without leaving the thread. You also get a shared audit trail of who created what, which Ads Manager doesn't surface clearly. For deep reporting or pixel troubleshooting, Ads Manager is still better.

Who on the team should connect the Meta Ads account?

Whoever owns the ad account in Business Manager and has advertiser or admin permissions. If your agency manages the account, ask them to grant your Switchy user those roles first. Once connected, any Switchy teammate can invoke the tools, but the API calls run under the connected user's token and spend limits.

Data last verified 607 hours ago.Sources aggregated hourly to weekly. See docs/architecture/model-directory.md.