Meta Ads MCP for your AI
The AdBid Meta Ads MCP is a hosted Model Context Protocol (MCP) server that connects Claude, ChatGPT, Cursor, Perplexity or any MCP client to your Meta (Facebook & Instagram) Ads. Analyze accounts, campaigns, ads, revenue and LTV, then use guarded write tools to pause, activate, rename or adjust budgets after explicit approval. Behind the MCP, the AdBid platform builds, bulk-launches, localizes and AI-manages campaigns. It uses your existing AdBid connection, so you never paste a Meta token.
Meta Ads
Google Ads
TikTok Ads
Snapchat Ads
Moloco Ads
What is Meta Ads MCP?
Meta Ads MCP is a Model Context Protocol server that lets an AI assistant work with your Meta Ads in plain language.
- Claude, ChatGPT, Cursor, Perplexity or any MCP client connects to it
- Hosted remote MCP over Streamable HTTP
- No Node process, no npx bridge, no Meta developer app
- Reads from campaign builder, creatives, attribution and automation
AdBid platform + MCP vs Pipeboard vs official Meta MCP vs open-source servers
AdBid combines selectable read-only access with guarded owner-scoped writes, revenue, LTV and intraday data, plus a platform that creates, edits, bulk-launches, localizes and AI-manages campaigns behind approvals. Rows marked “in AdBid” run in the platform rather than through MCP tools. Claims come from each vendor’s own documentation; last verified 2026-08-26.
Swipe to compare all columns →
| Capability | AdBid platform + MCP | Pipeboard | Official Meta Ads MCP | Open-source (e.g. hashcott) |
|---|---|---|---|---|
| Read Meta Ads from an AI client | 24 tools + 4 analysis prompts | 30+ tools | Reporting, catalog, signal health, activity logs | 35 read tools (Graph v22) |
| Write access (create / edit / pause / spend) | Guarded — pause/activate, rename, budgets and bids; no create/delete | Yes — confirmation on every write | Yes — create/edit ads, ad sets, campaigns | Optional — 19 write tools, off by default |
| Hosting | Hosted remote (Streamable HTTP) | Hosted remote; local install optional | Hosted by Meta | Self-hosted (npx) |
| Tool coverage | 24 read + 3 guarded write tools | 30+ tools, read and write | Reporting, catalog, signal health, activity logs | 35 read tools plus optional writes (Graph v22) |
| Data beyond Meta Graph (Stripe/Play revenue, LTV, 5-min intraday) | Yes | No | No | No |
| Create and edit campaigns | Yes — in AdBid (campaign builder, brief → structure), approvals | Yes — via MCP, confirmation per write | Yes — via MCP | Optional — 19 write tools, off by default |
| Bulk launch across many ad accounts, in parallel | Yes — in AdBid (batch payload → many campaigns) | No | No | No |
| AI campaign management | Yes — in AdBid: 19 action types, approvals, kill switch, autopilot | No | No | No |
| Auto creative + ad generation, localization | Yes — in AdBid (Ad Creative AI, geo-scale) | No | No | No |
| Multi-account with one key | Yes — every connected Meta profile | Yes | Business-portfolio scoped | One token per app |
| Analytics depth | 141 metrics × 12 sources + AI analyst | Meta Graph metrics | Meta Graph metrics | Meta Graph metrics |
| Credential in your client config | AdBid MCP key (revocable); no Meta token | Pipeboard API token | Meta account login | Raw Meta access token + your own developer app |
| Price / license | Free with AdBid account | Free plan; BSL 1.1 source | Free | Free, MIT |
Your assistant, on your ad account
Connect the Meta Ads MCP server in 2 minutes
A hosted remote MCP over Streamable HTTP.
- Claude Desktop: add the block below to claude_desktop_config.json and restart.
- Cursor: paste the same block into .cursor/mcp.json (or Settings → MCP) and reload the window.
- Claude Code: claude mcp add --transport http adbid-ads https://adbid.me/api/mcp --header "Authorization: Bearer adbid_mcp_…"
- ChatGPT, Perplexity, claude.ai: add a custom connector with the URL https://adbid.me/api/mcp and your key as the Bearer token.
From a question to an answer, no exports
Once connected, you ask Claude about your Meta Ads the way you would ask a teammate.
- “List my Meta ad accounts and their currency.”
- “Show active campaigns in act_1234 with their daily budgets.”
- “What’s my CPA and ROAS by country for the last 30 days?”
- “How much did act_1234 spend this month vs last month?”
- “Which creatives scored above 80 on conversions this week?”
- “Estimate the audience size for women 25–44 in Germany interested in yoga.”
- “Show real Stripe revenue and ROAS per campaign, not Meta-attributed.”
- “Any spend anomalies or incidents in the last 7 days?”
- Built-in prompts: weekly_account_review, creative_fatigue_check, refund_risk_audit, ltv_payback_review — one call runs a whole playbook across the tools.
- “Pause campaign 123 after I confirm the exact change.”
- “Change ad set 456 to a $50 daily budget after confirmation.”
Not just read-only: what the AdBid platform does
The MCP shows your AI everything; the AdBid platform behind it acts.
- Create and edit campaigns, ad sets and ads — from a brief or in the campaign builder.
- Bulk launch: one payload → many campaigns across multiple ad accounts, processed in parallel.
- Automatic creative and ad generation, with localization per geo and format.
- AI campaign management: 19 action types (pause, scale, reallocate budget, replace creative…) behind approvals, autopilot optional.
- 141-metric analytics with an AI analyst — the same numbers the MCP returns.
Guarded writes, and no token to paste
The AdBid Ads MCP separates analysis from mutation.
- Every write requires owner verification, a write-capable key and confirm=true.
- No Meta token in your client config — auth goes through AdBid.
- Per-key access you can revoke instantly from Settings.
Common setup errors, and the fix
Most Meta Ads MCP server issues are one of four things.
- Tools don’t appear in the client → restart the client, validate the JSON (a trailing comma is the usual culprit), and make sure the key has no trailing space.
- “Unauthorized” → the key was revoked or the Facebook connection expired in AdBid. Reconnect Facebook in Settings and generate a fresh key.
- Empty ad-account list → the Facebook user connected in AdBid has no role on the ad accounts. Fix roles in Meta Business settings, then reconnect.
- A write is rejected → use a personal write-capable key and approve the exact change. Creation and deletion remain unavailable through MCP.
How teams use the Meta Ads MCP with the AdBid platform
Workflow examples — not customer results and no invented numbers. Each shows where the MCP sits in a real operating pattern; full walkthroughs are on the case studies page.
Agency analyst, 12 client accounts, one key
Morning check in Claude: spend vs cap, ROAS by client, anomalies from get_incidents — then the buyer applies changes in AdBid behind approvals.
E-commerce: offer testing without losing control
Compare creatives scored on real conversions, pull Stripe revenue per campaign next to Meta-attributed ROAS, then hand the scale decision to AI Media Buying with approvals.
Mobile app: acquisition read against LTV
get_ltv_forecast and cohort revenue beside install cost, so an early cohort is never judged as if its payback window had closed.
What the MCP can do: 27 tools in 7 groups
Twenty-four read tools cover the Meta hierarchy, performance, targeting, leads and AdBid analytics. Three guarded write tools update campaigns, ad sets and ads after explicit approval. Your assistant picks the right tool while the server enforces tenant ownership and key permissions.
Accounts and campaign structure
6 tools — the Meta Ads hierarchy plus the account change log and spend caps.
Insights and spend
3 tools — any level, any date range, breakdowns, plus 5-minute intraday series.
Creatives
3 tools — creative contents, rendered previews, 0–100 conversion scores.
Targeting research
6 tools — interests, locations, audience estimates, custom audiences, pixels, pages.
Leads
2 tools — lead forms and the leads themselves.
Revenue analytics (AdBid-only)
4 tools — Stripe/Play revenue per campaign, LTV forecasts, subscriptions, incidents.
Guarded writes
3 tools — pause/activate, rename, and adjust campaign or ad-set budgets and bids.
Safe changes after explicit approval
Personal-key writes are owner-scoped, audited and read back from Meta after the update. Delete and create operations are not exposed.
update_campaign
Pause, activate or rename a campaign; change daily or lifetime budget.
update_adset
Pause, activate or rename an ad set; change budget or bid amount.
update_ad
Pause, activate or rename an ad.
Accounts and campaign structure
The Meta Ads hierarchy and its change history.
list_ad_accounts
Every Meta ad account you can access, with currency, status and spend.
list_campaigns
Campaigns for an account: status, objective, budget and buying type.
list_adsets
Ad sets for a campaign or account: targeting, optimization goal and budget.
list_ads
Ads for an ad set, campaign or account, with their creative and status.
get_account_activity
The account change log: budget edits, status flips, who and when.
get_spend_limits
Daily spend cap status and cap-collapse forecast per account.
Insights and spend
Performance at any level, any date range, with breakdowns.
get_insights
Impressions, clicks, CTR, CPC, CPM, spend, reach, ROAS and quality rankings — any level, any date, with breakdowns.
get_account_spend
A quick spend summary for an account over any date range, in the account currency.
get_intraday_metrics
5-minute CPM and CTR series — finer than Meta’s daily minimum.
Creatives
What each ad shows and how the creative performs on real conversions.
get_creative
The full creative behind an ad — texts, image or video, and call to action.
get_ad_preview
A rendered preview of any ad, exactly as a placement shows it.
get_creative_performance
Creative collections scored 0–100 on real conversions.
Targeting research
Audience research without opening Ads Manager.
search_targeting_interests
Search Meta’s interest taxonomy, with audience sizes and suggestions.
search_locations
Search geo targeting: countries, regions, cities, zips.
estimate_audience
Estimated audience size for any targeting spec.
list_custom_audiences
Custom and lookalike audiences: type, size and delivery status.
list_pixels
Meta pixels on the account, with when each last fired.
list_pages
Facebook Pages and linked Instagram accounts across your profiles.
Leads
Lead Gen forms and their submissions.
list_lead_forms
Lead Gen forms of your pages, with leads counts.
get_leads
Submitted leads of a form, ready to analyze or export.
Revenue analytics Meta doesn’t have (AdBid-only)
Real Stripe and Google Play revenue, LTV forecasts, subscription economics and incident logs — read through revenue intelligence and predictive LTV.
get_campaign_revenue
Campaigns with real revenue and ROAS from Stripe and Google Play — data Meta doesn’t have.
get_ltv_forecast
Predicted revenue, ROI and LTV per campaign from AdBid cohort analytics.
get_subscription_metrics
Stripe subscription economics: MRR, trials, refunds and billing issues.
get_incidents
Automatic anomaly log: spend outages, drops, spend with zero revenue. Admin accounts only.
Connect the MCP in 5 steps
Connect the ad account
Meta, Google or TikTok. Attribution comes free with it.
Set the target CPA and test structure
Pick the product, geos and one of six testing structures.
Let the agents build the tree
Campaigns, ad sets and ads with consistent naming and budgets.
Preview and approve
Every launch group waits for your review before anything goes live.
Agents run the loop
Stop, reduce, monitor and scale against live CPA, ROAS and revenue.
Common questions about Meta Ads MCP
Read your Meta Ads from AI. Run them in AdBid.
Guides & resources
Where these descriptions come from
Public product material, last checked 2026-08-26.
Read your Meta Ads from AI. Run them in AdBid.
Start free, connect Facebook and generate an MCP key.