Facebook Ads MCP. Analyze performance, manage spend, and update ad statuses.
Gemini Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Facebook Ads MCP manages your Meta advertising campaigns through natural conversation. You can pull detailed performance metrics, check ad set targeting, review campaign settings, and update active/paused statuses directly using your agent.
What your AI agents can do
Get ad account info
Gets basic information about your entire Facebook Ad Account.
Get ad details
Retrieves specific information for a single, selected ad.
Get ad set details
Retrieves specific details about a single, selected ad set.
Get basic metadata for your ad account, including its currency and overall status.
Extract granular metrics like impressions, clicks, spend, and reach across time periods.
Fetch lists of all campaigns, ad sets, or individual ads running in the account.
View specific targeting rules, budgets, and creative details for any single component (campaign, ad set, or ad).
Update the active status of an entire campaign, an ad set, or a single ad.
Ask AI about this MCP
Supported MCP Clients
OAuth 2.0 Compatible Gemini Waiting for input…
Facebook Ads: 12 Tools for Ad Account Operations
These tools let you manage every aspect of your ad account, from listing assets to pulling deep metrics and changing status across the board.
Make your AI actually useful.
Add this MCP to Claude, Cursor, or Windsurf and your AI stops guessing. It gets real tools to look things up, take action, and handle the stuff you keep doing by hand.
Start using Facebook Ads on Vinkius019d7595get ad account info
Gets basic information about your entire Facebook Ad Account.
019d7595get ad details
Retrieves specific information for a single, selected ad.
019d7595get ad set details
Retrieves specific details about a single, selected ad set.
019d7595get campaign details
Fetches detailed information for any given campaign.
019d7595get insights
Retrieves performance metrics like clicks, impressions, and spend across the ad account.
019d7595get me
Confirms the identity and permissions of your connected token.
019d7595list ad sets
Lists all the ad sets defined within your account structure.
019d7595list ads
Lists all the ads currently active in your ad account.
019d7595list campaigns
Lists all campaigns that exist in your ad account.
019d7595update ad set status
Changes the active status (pause/activate) of a specific ad set.
019d7595update ad status
Updates the operational status of an individual ad.
019d7595update campaign status
Changes the active status (pause/activate) for an entire campaign.
Choose How to Get Started
Build a custom MCP for your own tools, or connect a ready-made integration from our catalog.
Build Your Own
Turn any API into an MCP. Import a spec, define Agent Skills, or deploy with MCPFusion.
- Import from OpenAPI, Swagger, or YAML specs
- Create Agent Skills with progressive disclosure
- Deploy to edge with MCPFusion framework
- Built in DLP, auth, and compliance on every call
- Real time usage dashboard and cost metering
- Publish to catalog or keep private
Make Your AI Do More
Start with Facebook Ads, then connect any of our 4,800+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,800+ others, all in one place
- Add new capabilities to your AI anytime you want
- Every connection is secured and compliant automatically
- Track usage and costs across all your servers
- Works with Claude, ChatGPT, Cursor, and more
- New servers added to the catalog every week
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Facebook Ads. All third-party trademarks, logos, and brand names are the property of their respective owners. Their use on this website is strictly for informational purposes to identify service compatibility and interoperability.
VINKIUS INFRASTRUCTURE
Cloud Hosted
Managed infra
V8 Isolated
Sandboxed per request
Zero-Trust Proxy
No stored credentials
DLP Enforced
Policy on every call
GDPR Compliant
EU data residency
Token Compression
~60% cost reduction
Works with Claude, ChatGPT, Cursor, and more
The Model Context Protocol standardizes how applications expose capabilities to LLMs. Instead of operating in isolation, your AI gains direct access to external platforms, live data, and real-world actions through secure, standardized connections.
This server provides 12 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Dealing with manual performance checks across multiple tabs is a nightmare.
Today, checking ad health means jumping between the campaign tab, then the ad set tab, and finally the individual ad creative. You copy status codes into one spreadsheet, pull metrics into another, and spend half your morning just confirming if Campaign A is paused or if Ad Set B has hit its budget cap.
With this MCP, you simply ask your agent what's wrong with the paid efforts. It runs the necessary checks—pulling performance data and inspecting details—and delivers a concise report telling you exactly which component needs attention.
Update Statuses With Confidence
You don't have to manually click through the interface to change status. You can list all ads, then ask your agent to run `update_ad_status` on a group of IDs, and it executes the command instantly across the board.
This moves ad management from a series of repetitive clicks into a single, directed conversation. The result is immediate control over your spending.
What you can do with this MCP connector
You connect this MCP to take full control of your paid media efforts without logging into the Facebook Ads platform. Instead of building complex reports or manually adjusting budgets across multiple tabs, you talk to your AI client about what needs fixing. You can pull performance insights showing total spend, clicks, and reach for the entire ad account, then drill down to see exactly which ads are underperforming.
The system even verifies your access level using a zero-trust proxy, so your credentials pass through in transit but never sit on disk—it's safer than most local setups. You can list all campaigns or specific ad sets and check their detailed settings before telling the AI agent what to do next, like pausing an entire campaign that’s draining money too fast.
This MCP lets you manage everything from listing current ads to updating statuses across the board.
019d7595-a38f-7037-930f-423727c779dc 
How Facebook Ads MCP Works
- 1 Connect your MCP-compatible client and provide your Facebook Ads Access Token and Ad Account ID.
- 2 Ask your agent for the data you need; for example, 'Show me all campaigns running in the US.'
- 3 The agent compiles the requested information and delivers it directly to your chat interface.
The bottom line is: You get a single conversational entry point to manage complex ad infrastructure.
Who Is Facebook Ads MCP For?
Digital marketing managers, paid media specialists, and agency account leads. You're the person who wakes up in the morning looking at dashboards full of red numbers and has to manually figure out which ads failed and why.
Using this MCP, you pull performance insights for your ad account, identify underperforming campaigns using get_insights, and then instruct the agent to pause them instantly via update_campaign_status.
You check the basic metadata with get_ad_account_info to ensure billing is correct, then list all ad sets using list_ad_sets before running a status update on them.
You need to report quick metrics. You use this MCP to grab campaign details and performance data for multiple clients, all without copying and pasting from the source dashboard.
What Changes When You Connect
- Stop sifting through spreadsheets. Use
get_insightsto pull key metrics—impressions, clicks, total spend—and get them summarized instantly for reports. - You can pause failing campaigns without navigating multiple dashboards. Just ask your agent to use
update_campaign_statuson ID 123456 and move on. - Don't waste time checking every single ad manually. Use
list_adsto see them all, then tell the agent to apply a pause usingupdate_ad_statusacross the board. - Need to know why an ad set isn't working? Run
get_ad_set_detailsto review its targeting and budget settings right in your chat window. - The platform handles credential safety via a zero-trust proxy. Your access tokens move through Vinkius, used only for the call; they never sit on disk.
Real-World Use Cases
Campaign is bleeding money.
You run get_insights and see Campaign 99 has a high spend but low clicks. You ask your agent to check the details, which triggers get_campaign_details. Seeing poor performance metrics, you tell it to use update_campaign_status to PAUSE the campaign immediately.
Need to audit an ad set.
A client asks why their ads aren't reaching certain demographics. You list all ad sets using list_ad_sets, then pull specific targeting data with get_ad_set_details for the suspected set, confirming if the budget or audience scope is too narrow.
Mass status update required.
The marketing team finished a creative test and needs to pause 30 specific ads. Instead of manually logging into the platform thirty times, you use list_ads to get all IDs, then tell your agent to run update_ad_status on all of them.
Quick account health check.
Before a big meeting, you need basic stats. You first call get_ad_account_info for the balance and currency, then run list_campaigns to confirm how many campaigns are currently running.
The Tradeoffs
Just reading data.
Pulling up a list of ads using list_ads and spending 15 minutes manually cross-referencing the status in a spreadsheet. You gather data, but nothing changes.
→
After listing the ads with list_ads, immediately ask your agent to compare that list against performance metrics from get_insights. If they don't match up, use update_ad_status to correct the ad status directly.
Over-relying on basic listing.
Running list_campaigns and thinking that just because a campaign appears there means it's healthy or active. You miss key details about targeting or budget limits.
→
After using list_campaigns, always follow up by requesting get_campaign_details. This provides the necessary context—the actual budget, status, and ad sets linked to that campaign.
Forgetting permissions.
Trying to execute a change like pausing a campaign without confirming if your token has write access. The call fails silently or gives an error you don't know how to interpret.
→
Always start by calling get_me to confirm the identity and authorized access level for the connected marketing token before attempting any updates.
When It Fits, When It Doesn't
Use this MCP if your core problem is managing ad components—meaning you need to check metrics, list assets, or change an active/paused status. For example, if get_insights shows high spend but low clicks, the clear next step is using update_campaign_status. Don't use this MCP if you only need raw creative ideas; it doesn't generate ad copy. Also, don't use this to analyze complex external market trends—it only reports data from Facebook. If your goal is solely financial forecasting based on outside factors, you might need a dedicated budgeting tool instead.
Common Questions About Facebook Ads MCP
How do I find my Facebook Ad Account ID? +
You can find your Ad Account ID in the Meta Ads Manager. It's the numeric ID shown in the URL or account selector. Ensure you provide it without the 'act_' prefix.
Can I pause an underperforming campaign using this agent? +
Yes! Use the update_campaign_status tool and set the status to PAUSED. You can also resume it later by setting it back to ACTIVE.
Which performance metrics are available in the insights? +
The get_insights tool provides comprehensive data including impressions, clicks, total spend, reach, CPC (cost per click), CTR (click-through rate), and CPP (cost per purchase).
What does using `get_me` confirm about my access level before I change anything? +
It confirms your current token's authorized scope and user identity. This lets you verify the agent has the necessary permissions to run commands like updating status, ensuring everything stays within your defined limits.
How can I check my overall ad account health using `get_ad_account_info`? +
This tool retrieves basic metadata for the entire account. You get quick visibility into things like your current balance, associated currency, and the general operational status of the whole advertising profile.
If I use `list_campaigns`, how do I access related ad set information? +
The tool only lists the campaigns. To drill down into details like targeting or specific budgets, you'll need to follow up by running list_ad_sets using the campaign IDs it provides.
What happens if I try to execute `update_ad_set_status` with an invalid ID? +
The MCP returns a structured error code and message. Your AI client can then parse this response directly, telling you exactly which ID failed or why the status update couldn't run.
What specific targeting and creative details does `get_ad_details` provide? +
It gives deep information about a single ad. You can review its exact creative assets, who it targets, and the detailed budget parameters set for that specific piece of advertising.
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.