Meta Ads (Facebook + Instagram) → Claude · via Porter Metrics MCP

Connect Meta Ads to Claude

Connecting Claude to Meta Ads with Porter lets you analyze campaigns, build dashboards, and trigger alerts in natural language — like this one:

Works in Claude Desktop, Claude Web, and Claude Code · Meta Ads covers Facebook, Instagram, Messenger, and Audience Network · OAuth only, no stored credentials
Claude Desktop · Porter MCP
You
List my top 5 Meta Ads campaigns by ROAS over the last 30 days. Include spend, purchases, and cost per purchase.
Claude
Here are your top 5 Meta Ads campaigns by ROAS over the last 30 days:
CampaignSpendPurchasesCPPROAS
BF_Prospecting_Video$12,480612$20.396.8x
Retargeting_30d_DPA$8,900398$22.365.4x
LAL_1%_Purchasers$7,210281$25.664.1x
Broad_Advantage+$15,100510$29.613.8x
Interest_Fashion_18-34$5,600169$33.142.9x

Three of the top five are prospecting. Want me to dig into which creative drove the ROAS on BF_Prospecting_Video?

Trusted by marketers at

3,000+ marketing teams 50+ countries Meta Business Partner candidate Agencies · In-house · Ecom
250+
Meta Ads metrics and dimensions ready to query
50+
Ad accounts consolidated under one Porter workspace
< 5 min
From first OAuth connect to first Claude answer
20+
Marketing data sources on the same MCP integration

What is the Porter Metrics MCP, and why does it matter for Meta Ads?

MCP (Model Context Protocol) is Anthropic’s open standard for connecting AI assistants to external data sources. The Porter Metrics MCP is the server that exposes your Meta Ads data — along with 20+ other marketing data sources — to Claude in a format Claude can query directly.

Before MCP, getting Meta Ads data into Claude meant exporting a CSV, pasting it in, and asking Claude to read it. That works for one-off questions. It fails at scale, and it fails for agencies. The Porter MCP replaces that manual loop with a live integration: Claude sees your Meta Ads account the way a data analyst would — campaigns, ad sets, ads, creatives, audiences, and all the metrics underneath — and queries what it needs when you ask.

Because Porter already handles Meta Ads authentication, field naming, account consolidation, and multi-destination routing for thousands of marketing teams, the MCP is not a bolt-on — it is the same pipeline that feeds your Data Studio (formerly Looker Studio) dashboards, exposed in a way Claude can read.

Meta Ads reporting still eats your week

Every question your CMO asks takes four tabs to answer. Open Ads Manager, export a CSV, drop it in Data Studio, write the summary in Slack. The question took six seconds; the answer takes forty-five minutes.

That gap is where good performance decisions go to die. Creative fatigue gets caught days late because nobody checks every Facebook and Instagram ad every day. Agencies scale reporting by hiring analysts, not by shipping insight faster. And cross-channel questions — “which Meta campaigns actually drove Shopify revenue last month?” — go unanswered because joining the datasets manually isn’t worth the hour it takes.

If your team still exports Meta Ads CSVs to answer basic questions, this page is for you.

Three steps to query Meta Ads with Claude

1

Connect Meta Ads to Porter

Authenticate once with Meta Business Manager using OAuth. Porter pulls every ad account, campaign, ad set, and ad automatically — including agencies managing 50+ client accounts under one subscription. Covers Facebook Ads, Instagram Ads, Messenger, and Audience Network placements in a single integration. Porter never stores your Meta password and never calls the Meta Marketing API directly from Claude.

2

Register the Porter MCP in Claude

In Claude Code, run claude mcp add porter. In Claude Desktop, paste the MCP config block from Porter. Claude Web picks it up the moment you log into Porter. Same MCP endpoint across all three surfaces.

3

Ask Claude in natural language

Type the question in English. Claude picks the right fields, runs the query against Porter’s API, and writes the answer. No SQL, no UI clicking, no exports. A question that took forty-five minutes in Data Studio takes forty-five seconds in Claude.

Porter vs Adzviser, Pipeboard, Coupler, Windsor

The MCP + Meta Ads space is crowded. Here’s how the Porter Metrics MCP integration compares on the dimensions that matter for marketing teams:

CriterionAdzviserPipeboardCoupler.ioWindsor.aiPorter
Pricing published on product pageTrial $0.99HiddenHiddenHidden$19/mo published
Marketer-language field namesPartialNoPartialYesYes (250+ renamed)
First-class Claude Code supportNoMentionedNoNoYes
Multi-account agency workflowYesYesSetup req.Yes50+ accounts, one subscription
Multi-destination (not just Claude)Claude + GPTClaude + GPT + CursorClaude + GPTClaude + GPTClaude + Data Studio + BigQuery + Sheets + Slack + Zapier
Cross-source joins in one promptYesMeta + Google + TikTokYesYes20+ connectors, one MCP
Prompt library includedNoNoNo15 prompts50+, tagged
Read-only by defaultYesYes (write opt-in)YesYesYes

Porter is the only MCP connector built equally for the Claude surface and the classic marketing destinations. The integration is not a bolt-on — the same Porter workspace that feeds your Data Studio reports is the one Claude reads, so the KPIs your team already trusts are the ones Claude sees.

Every Meta Ads field, in marketer language

The Porter Metrics integration exposes more than 250 Meta Ads fields, named the way marketers think about them — not the way the Meta Marketing API returns them. Where the API returns actions_omni_purchase, Porter shows purchases. Where the API returns action_values, Porter shows purchase value and ROAS. Claude queries these directly.

Spend & Budget

Spend, budget, daily budget, lifetime budget, budget remaining, bid amount, bid strategy.

Performance

Impressions, reach, frequency, clicks, unique clicks, CTR, unique CTR, CPC, CPM, CPP.

Conversions

Purchases, purchase value, ROAS, cost per purchase, leads, cost per lead, add to cart, initiate checkout, content view, registration.

Campaign dimensions

Campaign name, objective, buying type, bid strategy, status, start date, stop date, special ad categories.

Ad set dimensions

Ad set name, optimization goal, billing event, placement, targeting summary, audience, daily/lifetime budget, pacing type.

Ad dimensions

Ad name, status, creative name, creative type (video, image, carousel, collection), preview URL, ad copy, landing page URL.

Audiences

Custom audience name, audience source, audience type (custom, lookalike, saved), audience size, lookalike seed.

Creative breakdowns

Creative ID, creative name, thumbnail URL, video view metrics, hook rate, hold rate, play duration.

Segmentation

Age, gender, country, region, DMA, platform (Facebook, Instagram, Messenger, Audience Network), placement position, device, time of day.

Field missing? File a ticket. Porter ships connector fields on request — most land within 48 hours.

Prompts real marketers run every week

Paste any of these into Claude after installing the Porter MCP. Every prompt runs on live Facebook and Instagram Ads data — no preprocessing, no schema configuration.

Performance review

List my top 10 Meta Ads campaigns by ROAS over the last 30 days. Include spend, purchases, and cost per purchase.
Find active Facebook Ads ad sets that spent more than $500 this week with zero purchases.
Compare this month’s ROAS to last month, grouped by campaign objective.
Which campaign objective is pacing ahead of its monthly target, and by how much?

Creative fatigue on Facebook and Instagram

List Instagram Ads whose CTR dropped more than 30% week-over-week while still spending over $200/day.
Show me every ad running more than 60 days on Facebook. Sort by current ROAS, descending.
Group the last 30 days by creative format (video, image, carousel, collection). Output cost per purchase and ROAS for each.
Flag any Meta Ads creative where hook rate is below 40% and spend is above $500.

Budget reallocation

I have $10,000 left this month. Based on 14-day ROAS trend, rank my 12 active Meta Ads campaigns by expected incremental return.
Surface campaigns where cost per purchase is 40%+ above my $25 target. Include current daily spend.
Which ad sets would you pause if I told you to cut $2,000 from this week’s Facebook Ads spend?

Automated reporting

Write my Monday Meta Ads digest for client ACME: top movers, pacing vs monthly budget, flagged ad sets.
Compare last 7 days vs previous 7 days at account level. Flag any metric that changed more than 15%.
Draft a Slack post summarizing yesterday’s top 3 wins and top 3 losers across my Meta accounts.

Cross-channel (requires additional connectors in your Porter workspace)

Compare Meta reported purchases against GA4 attributed purchases this week. Where’s the gap?
Which Meta Ads campaigns drove the most Shopify revenue last week, using UTMs, not platform-reported purchases?
Join Meta audiences with HubSpot contact lists — how much overlap?

See 50+ more prompts for Meta Ads + Claude →

Built for technical marketers, not data teams

Performance marketers

Stop context-switching between Ads Manager, Data Studio, and Slack. Ask Claude the KPI question, paste the answer into your CMO thread, done. The Porter integration understands the Meta fields you actually use — ROAS, CPA, frequency, hook rate — not raw API names.

Outcome: Daily Meta reviews compress from forty-five minutes to under five.

Marketing agencies

Query all client Meta Ads accounts in a single prompt. Generate weekly client digests Claude writes itself. Replace the “top movers” slide your analyst rebuilds every Friday. Agency-grade account consolidation is the default, not an upsell.

Outcome: Reporting scales with clients added, not analysts hired.

Ecommerce growth teams

Connect Meta Ads, Shopify, and GA4 to Claude at once via the same Porter integration. Ask “which Meta Ads campaigns drove actual Shopify revenue, not just platform-reported purchases” and get a joined answer.

Outcome: Attribution questions answered in seconds, not reconciliation meetings.

In-house analytics

Expose Meta Ads to Claude for the marketing team while keeping all writes inside Ads Manager. The MCP integration is read-only by default. Claude handles the 80% of questions that don’t need a human in the loop.

Outcome: Analyst time reallocates from reporting to model building.

Claude Code: a first-class surface

Most MCP connectors support Claude Desktop and Claude Web as an afterthought to Claude Pro. The Porter Meta Ads integration treats Claude Code as equal.

Run claude mcp add porter in any Claude Code session. Porter registers and you can query Meta Ads alongside the codebase you’re currently working on. That matters if you’re a technical marketer building Data Studio dashboards, writing SQL against a warehouse, or prototyping a data pipeline. The Meta Ads context lives right next to the code — not in a separate tab.

Agency developers can standardize a claude.md in their workspace with preferred prompts: “When I ask for a client weekly summary, query the last 7 days vs previous 7 across all accounts and output in this markdown format.” Claude Code executes it against the Porter API every time.

One integration, every marketing source you use

The Porter Metrics MCP exposes every supported data source through the same integration endpoint. Ask Claude to cross Meta Ads with any other source in a single prompt.

Sources (20+ data integrations)

Meta Ads Google Ads TikTok Ads LinkedIn Ads GA4 Search Console YouTube Analytics Shopify Google Sheets BigQuery Instagram Insights Facebook Pages HubSpot Mailchimp + more

Destinations

Claude Data Studio BigQuery Google Sheets Slack Zapier HTTP Request

Cross-source prompt examples: “Meta Ads spend vs GA4 sessions by landing page, last 30 days.” “Rank Meta campaigns by Shopify revenue attributed through UTMs.” “Join Meta audiences with HubSpot contact lists to find overlap.”

Start from a prompt library, not a blank page

Every Porter MCP install includes a curated library of Meta Ads prompts. Import them into Claude Projects or Claude Code as reusable commands.

Weekly Meta Ads digest

Auto-generates a Monday morning summary for any Facebook or Instagram ad account.

Open template →

Creative fatigue audit

Surfaces Meta Ads whose performance is decaying against a fatigue threshold you set.

Open template →

Budget reallocation

Reallocates remaining monthly budget by 14-day expected ROAS across campaigns.

Open template →

Cross-channel attribution

Compares Meta Ads reported purchases against GA4 and Shopify revenue.

Open template →

Loved by marketers and agencies

Testimonials from Porter customers using the Meta Ads + Claude integration in production. (Action item for product team: collect 3+ Claude-specific quotes before launch; placeholders shown below.)

Porter is the Supermetrics replacement we were looking for. Same essential functionality at a much better price, plus the Claude MCP lets us run our Monday reviews in minutes instead of hours.
Performance Marketing DirectorAgency, 40+ client accounts
We moved off spreadsheet exports entirely. Our analyst used to rebuild the “top movers” slide every Friday — now Claude writes it from the same Porter integration that feeds our Data Studio dashboards.
Head of GrowthDTC brand, $2M/mo Meta spend
The per-client workspace setup is what sold me. Connect fifty Meta Ads accounts, expose them to Claude, and every weekly digest writes itself.
Managing DirectorMarketing agency

Pricing

The Porter MCP ships with every paid Porter plan. No per-seat Claude fee.

$19/mo per data source

Porter is the only MCP connector in this category that publishes pricing on the product page. Everyone else hides it behind a demo request.

Your Meta Ads data is secure

Security for the Porter MCP integration is handled at four layers: authentication, access model, storage, and AI training policy.

OAuth 2.0 authentication

Porter authenticates against Meta Business Manager using standard OAuth. Your Facebook and Instagram credentials never touch Porter or Claude — only the OAuth refresh token does, stored encrypted at rest.

Read-only by default

The MCP integration reads your Meta Ads data. It does not pause campaigns, change budgets, or edit ads. Write operations remain in Ads Manager. Write mode can be opted into per workspace if needed.

No data used for AI training

Your Meta Ads data is never used to train AI models — not by Porter, not by Anthropic. Claude queries your data at request time; no copy persists on the model side.

Revocable access

Revoke Porter’s access from Meta Business Settings in one click. All cached Meta Ads data in Porter is purged within 24 hours of revocation.

Encrypted in transit and at rest

TLS 1.2+ between Claude, Porter, and Meta’s API. AES-256 at rest for cached data. Data centers are SOC 2 Type II compliant (via Porter’s cloud provider).

Fine-grained scopes

Porter requests only the Meta Ads scopes required for read-only reporting (ads_read, business_management). No access to organic Facebook posts, Messenger DMs, or user profile data beyond what the Business Manager user has.

Frequently Asked Questions about Meta Ads + Claude

Setup & integration

What is the Porter MCP?

The Model Context Protocol server that exposes your Porter-connected marketing data to Claude. Install the integration once, every Porter connector — Meta Ads, Google Ads, GA4, Shopify, and 20+ more — becomes queryable in natural language.

Which Claude apps does the integration work with?

Claude Desktop (Mac, Windows), Claude Web (claude.ai), and Claude Code (CLI). Same MCP endpoint, same behavior across all three surfaces.

Do I need Claude Pro?

A free Claude account works for testing. Production use benefits from Claude Pro or Team due to higher usage limits — especially for agencies running long weekly digests.

How long does setup take?

Under five minutes. Connect Meta Ads to Porter via OAuth, add the MCP integration endpoint in Claude, and start prompting.

Data & API

Does Porter store my Meta Ads data?

The MCP pulls live from the Meta Marketing API by default. Cached mode is available for faster recurring queries and historical comparisons beyond Meta’s 37-month API retention window.

Which Meta Ads data does Claude see?

Every field exposed through the Meta Marketing API, renamed to marketer-friendly language. See the field categories above — 250+ metrics and dimensions.

Multiple Meta Ads accounts — does it work?

Yes. Connect as many Business Manager accounts as your plan allows. Claude queries across accounts in one prompt. Agencies routinely run 50+ accounts on a single Porter integration.

Does “Meta Ads” include Instagram ads?

Yes. Meta Ads covers Facebook Ads, Instagram Ads, Messenger, and Audience Network placements under one connector. You do not need a separate Instagram integration.

Does it work for Facebook Ads only (no Instagram)?

Yes. The MCP integration queries whatever is in your Meta Business Manager. If the account only runs Facebook Ads, Claude only sees Facebook Ads.

Security

Can Claude change things in Meta?

No. The Porter MCP is read-only by default. Pauses, budget changes, and creative edits still happen in Ads Manager. Write mode is opt-in per workspace.

Is my data used to train AI models?

No. Your Meta Ads data is never used for model training — not by Porter, not by Anthropic.

How is authentication handled?

OAuth 2.0 with Meta Business Manager. Porter never sees your Meta password. Revoke access anytime from Meta Business Settings.

What happens to my data if I cancel?

Cached data is purged within 24 hours of cancellation. Your Meta Ads account is unchanged — Porter only ever had read access.

Pricing

Is the MCP integration a separate charge?

No. MCP access ships with every paid Porter plan starting at $19/month per data source.

Can I test it before paying?

Yes. 14-day free trial includes full MCP integration access. No credit card required.

How does Porter pricing compare to Adzviser, Pipeboard, Coupler, Windsor?

See the full comparison table above. Porter publishes pricing on every product page. Most competitors hide pricing behind a sales demo.

Start chatting with your Meta Ads data

Setup runs under five minutes. First useful Claude answer takes five seconds. OAuth connect, one MCP integration, 250+ Meta Ads fields ready to query.

Connect Meta Ads to Claude Book a 15-min demo

Learn more

How to connect Meta Ads to Claude (tutorial) What is an MCP? (for marketers) 50+ Meta Ads + Claude prompts Claude for Marketers (pillar page) Claude for Marketing Agencies Porter MCP integration docs