Meta Ads MCP. Manage ad spend and performance entirely via chat.
Works with every AI agent you already use
…and any MCP-compatible client
Just plug in your AI agents and start using Vinkius.
Meta Ads gives your AI agent direct access to run Facebook and Instagram campaigns. You can manage ad sets, list creatives, pull deep performance metrics (ROAS, CTR, CPC), and build custom audiences—all without opening Meta Ads Manager.
It's full ad spend control for your chat window.
What your AI agents can do
Activate campaign
Switches a paused ad campaign back on so it can start running ads again.
Get account info
Retrieves general details about your overall Meta Ad account, like its name and status.
Get account insights
Pulls aggregated performance data for the entire ad account (e.g., total spend, reach).
Retrieves high-level metrics like total spend, reach, and ROAS for your entire ad account using get_account_insights.
Pulls detailed performance data (CTR, CPC, conversions) specific to individual campaigns via get_campaign_insights.
Lists and helps create custom or lookalike audiences using the list_audiences tool for precise targeting.
Activates paused campaigns (activate_campaign) or pauses underperforming ones (pause_campaign) on demand.
Walks through your account hierarchy: lists all campaigns (list_campaigns), then ad sets, and finally individual ads using list_ad_sets and list_ads.
Ask AI about this MCP
Supported MCP Clients
Waiting for input…
Meta Ads MCP Server: 10 Tools for Campaign Management
These tools allow your AI client to read, write, and report on every aspect of your Meta ad account—from basic info checks to complex performance analytics.
019d75d3activate campaign
Switches a paused ad campaign back on so it can start running ads again.
019d75d3get account info
Retrieves general details about your overall Meta Ad account, like its name and status.
019d75d3get account insights
Pulls aggregated performance data for the entire ad account (e.g., total spend, reach).
019d75d3get campaign insights
Gets specific metrics and performance breakdowns for one selected campaign.
019d75d3list ad sets
Shows all the ad sets that belong inside a specific campaign you select.
019d75d3list ads
Lists every single individual ad creative within an ad set.
019d75d3list audiences
Retrieves a list of all custom or lookalike audiences you've built for targeting.
019d75d3list campaigns
Shows every Meta ad campaign currently active or paused on the account.
019d75d3list creatives
Lists all available ad creatives linked to your ad accounts for review.
019d75d3pause campaign
Turns off a campaign, stopping it from spending any more money immediately.
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 Meta Ads, then connect any of our 4,700+ other servers whenever your AI needs more. One click, no limits.
- Use this MCP plus 4,700+ 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
What you can do with this MCP connector
Meta Ads gives your agent direct control over running Facebook and Instagram campaigns. You can manage everything from setting up ad spend to digging into performance metrics—all without ever opening the Meta Ads Manager dashboard. It's full campaign control for your chat window, period.
Account Overview and High-Level Metrics
Start by checking out the general status with get_account_info; that’ll give you the account name and tell you if it's active or what its current state is. To get a bird's-eye view of how the whole thing's running, use get_account_insights. This tool pulls aggregated performance data for your entire ad account—think total money spent, overall reach, and more.
You don't have to guess where you stand; you just ask the agent, and it gives you the big picture.
Controlling Campaigns and Ad Spend Status
You need to manage which campaigns are running and which ones gotta take a break. Use list_campaigns to pull a list of every single ad campaign that's currently active or sitting paused on your account. If you find something underperforming, you can stop the bleeding instantly by calling pause_campaign. Conversely, if you know a good campaign is just taking a nap, use activate_campaign to switch it back on and let it start spending money again.
Digging Deep into Performance Data
Metrics are everything. While get_account_insights handles the whole account view, you gotta drill down for specifics. To get detailed performance data—like CTR, CPC, or conversion counts—for a specific campaign, call get_campaign_insights. This gives you granular reporting on one selected ad campaign. You can then follow that same deep dive at the ad set level by running list_ad_sets, which shows every ad set belonging to a chosen campaign.
Auditing Your Ad Structure and Creatives
If you're auditing the entire structure, you gotta work your way down the chain. You start with listing all campaigns via list_campaigns. From there, you use list_ad_sets to see every ad set inside a campaign. Next, you use list_ads to pull up individual ads within an ad set. For reviewing your assets, you can run list_creatives, which shows all the available ad creatives linked to your account for review.
This entire process lets you walk through every layer of your ad structure.
Managing Audiences and Targeting Segments
Targeting is half the battle. You need to know what segments are available. Use list_audiences to retrieve a list of all custom or lookalike audiences you've built up for targeting. This lets your agent confirm which pools you can use before running any campaigns.
How It Actually Works With Your Agent
It’s simple, man. You connect the Meta Ads integration via Vinkius Marketplace and give your AI client access credentials. After that, you just tell your agent what you need done—'Pause campaign X,' or 'What was our ROAS last week?' Your agent executes the required API calls using these tools—whether it’s pulling a report or managing budgets—and hands you a clean answer right in the chat window.
You don't deal with complex menus; your AI client handles the heavy lifting.
How Meta Ads MCP Works
- 1 First, subscribe to the Meta Ads integration on Vinkius Marketplace. Then, you'll need to set up a connected app in Meta for Developers using your business credentials.
- 2 Next, tell your AI agent what needs doing (e.g., 'What was my ROAS last month?'). The agent identifies the correct tool and executes it against the live ad account data.
- 3 Finally, you get an immediate summary of metrics, insights, or actions required—all without ever opening Facebook Ads Manager.
The bottom line is: your AI client talks directly to Meta's APIs, letting you run complex marketing tasks using only natural conversation.
Who Is Meta Ads MCP For?
This is for the performance marketer who hates clicking through dashboards at 2 AM. It’s also for agency account managers dealing with five different clients and needing a single source of truth on ad spend. If your job involves digging into ROAS, targeting, or pausing campaigns based on data, you need this.
Uses get_campaign_insights and list_ads to identify which specific ad creatives are draining budget versus which ones actually convert.
Manages multiple client accounts by pulling unified data across various campaigns using list_campaigns without switching profiles.
Checks ROAS trends and audience performance (get_account_insights, list_audiences) to know exactly where the next product catalog push needs to go.
What Changes When You Connect
- Stop guessing on budget cuts. Use
get_campaign_insightsto pinpoint exactly which campaigns are underperforming, letting you make data-backed decisions instead of gut feelings. - Need a new audience? The
list_audiencestool lets you review all your custom segments and build lookalike targets right from your chat window—no manual upload needed. - Don't waste time navigating the ad hierarchy. With
list_campaigns,list_ad_sets, andlist_ads, your agent maps out your entire campaign structure in a single conversation flow. - Instant control over spending. Need to halt an account? Use
pause_campaignor, if it's working perfectly, useactivate_campaign—all with one simple command. - See the big picture quickly.
get_account_insightsgives you top-level stats (ROAS, clicks, reach) for the whole account immediately, bypassing deep menu diving.
Real-World Use Cases
Slowing Down a Bleeding Campaign
A brand owner sees ROAS dipping. They ask their agent: 'Pull performance data for Q3.' The agent runs get_account_insights, identifies the poor performer, and immediately executes pause_campaign on that specific campaign to stop wasted spend.
Building a New Retargeting Group
An agency needs better retargeting. They ask the agent to list existing audiences (list_audiences), confirm they have the right pool of top customers, and then instruct the AI to create a new lookalike segment for testing.
Auditing Ad Spend Before Launch
A marketer needs an audit. They start by listing all campaigns (list_campaigns), drill down into ad sets (list_ad_sets) to check the targeting parameters, and finally list creatives (list_creatives) to ensure compliance before launching a new set.
Checking Quarterly Performance
An e-commerce brand owner asks: 'What were my top conversion metrics this quarter?' The agent runs get_campaign_insights across key campaigns, giving immediate ROAS and purchase counts without needing to download a spreadsheet.
The Tradeoffs
Over-relying on guesswork
Just manually pausing every campaign that hasn't hit its daily goal because it looks 'low.' This wastes time and revenue.
→
Don't just pause. Run get_campaign_insights first. Use the data to confirm if poor performance is due to spend, targeting (check list_audiences), or creative failure (review list_creatives). Only pause when metrics prove it.
Getting lost in ad structure
Opening the Meta Ads Manager and clicking through Campaign -> Ad Set -> Ad, spending 10 minutes just to find one metric.
→
Don't navigate. Ask your agent: 'What is my CTR for ads targeting lookalike audiences?' The agent uses list_audiences and get_campaign_insights in a single query.
Assuming data availability
Asking the agent to calculate ROAS when the campaign hasn't been active long enough, or if the correct ad account ID wasn't passed.
→
Always start by confirming details. Run get_account_info first. If you need historical data, check your documentation for time frame limitations before asking for metrics.
When It Fits, When It Doesn't
Use this server if your workflow requires constant ad spend monitoring and iterative optimization. Specifically, if you frequently run reports (ROAS, CPC) or manage campaign status changes—like pausing an underperformer or activating a winner—this is essential. Don't use it if all you need to do is view basic account settings; get_account_info handles that fine. However, if your primary goal is advanced bidding strategy modeling or integrating complex external data sources (like Google Ads data), this server alone isn't enough. You still need a full marketing stack and potentially another integration for cross-platform comparison.
Independent Platform Disclaimer: Vinkius is an independent platform and is not affiliated with, endorsed by, sponsored by, verified by, or otherwise authorized by Meta 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 10 capabilities that interface natively with Claude, ChatGPT, Cursor, and any MCP client. No middleware. No custom integration required.
Available Capabilities
Checking ad performance usually means switching between dashboards, tabs, and spreadsheets.
Today, seeing how your ads are doing is a manual mess. You have to jump into the Meta Ads Manager, check Campaign A for its ROAS, then switch over to Ad Set B to see CTR, and finally pull down an audience list in a separate tab just to cross-reference targeting segments. It takes clicking through five different menus and copy/pasting data into three different sheets.
With this MCP server, you ask your agent one question: 'Compare the ROAS of my top three campaigns against the performance of the 1% lookalike audience.' You get a single, actionable report back instantly. It’s not just reading numbers; it’s getting an answer.
Meta Ads MCP Server: Manage ads and audiences through chat.
The biggest time sink is the administrative loop: checking campaign status, listing creatives for review, then figuring out if a better audience exists. You spend minutes just navigating to `list_campaigns`, then clicking into each one to run `get_campaign_insights` manually.
Now, you tell your agent: 'List all campaigns that are paused and check their last performance metrics.' The server runs the necessary tools (`list_campaigns` followed by checks) and gives you a consolidated list of what needs attention. You save time; you keep money.
Common Questions About Meta Ads MCP
How do I use the `get_account_insights` tool to check my total ad spend? +
You simply ask your agent for 'total account spend and reach.' The agent runs get_account_insights, pulling aggregated metrics like total spending, clicks, and impressions across all campaigns.
Can I use `list_audiences` to see my custom lookalike segments? +
Yes. Running list_audiences displays every audience segment you've created in your account, including the source and size of any lookalikes or custom lists.
What is the difference between `get_campaign_insights` and `get_account_insights`? +
get_account_insights gives you a high-level summary for everything. Use get_campaign_insights when you need deep performance metrics (like ROAS, CTR) confined to one specific campaign.
How do I pause an ad that's performing poorly using the `pause_campaign` tool? +
First, use list_campaigns to get the exact name or ID of the campaign. Then, instruct your agent to 'Pause [Campaign Name]' and it runs pause_campaign, stopping all spend immediately.
Does this server help me find my best ad creatives? (Using `list_creatives`) +
While list_creatives shows you the available ads, asking your agent to cross-reference that list with get_campaign_insights lets you identify which creatives actually drove the highest ROAS.
If I want to check all ad sets within a campaign, do I use `list_ad_sets`? +
Yes. This tool pulls an accurate list of every active or paused ad set attached to a specific campaign ID. You can then iterate through these sets to find the budget or targeting details you need for optimization.
My campaign suddenly stopped running; how do I use `activate_campaign`? +
You run activate_campaign using the campaign ID. The tool attempts to re-enable it immediately, which is useful if the pause was unintentional or temporary. It’s worth checking the account status first.
What kind of basic details can I get with the `get_account_info` tool? +
This function provides high-level, essential data about your connected ad account itself—things like the name, currency, and overall status. It's perfect for verifying connection credentials or checking if the account is in good standing before running deep reports.
How do I get my Meta Ads API credentials? +
- Go to developers.facebook.com and log in.
- Click My Apps → Create App.
- Select Business as the app type.
- Fill in the app name and connect it to your Business Manager.
- Add the Marketing API product to your app.
- Go to Settings → Basic and copy your App ID and App Secret.
- Generate a System User Access Token in Business Manager (Business Settings → System Users → Generate Token).
- Paste all values below.
💡 For production use, submit your app for App Review to get stable, long-lived tokens.
Can I manage both Facebook and Instagram ads? +
Yes. Meta Ads Manager unifies Facebook and Instagram advertising. Your AI agent manages campaigns across both platforms through the same API — including placements in Feed, Stories, Reels, and Messenger.
Can I create lookalike audiences? +
Yes. Your AI agent can create lookalike audiences from customer lists, website visitors, or app users — with configurable similarity percentages (1% being most similar, 10% broadest reach).
What conversion metrics can I track? +
Track purchases, add-to-cart, initiate checkout, lead submissions, app installs, registrations, page views, and custom conversion events — with attribution windows of 1-day click, 7-day click, and 1-day view.
Multi-server workflows that include Meta Ads MCP
MCP Servers for Cross-Platform Ad Analytics
Your media buyer checks Google Ads and Meta Ads separately for each client every morning , 12 clients across 2 platforms is 24 logins before the first coffee, and nobody catches that Client B's CPA doubled overnight until the budget is gone
Retarget Ad Audiences Automatically via MCP
Ad performance analyzed, winning audiences identified, email retargeting campaign sent , your ads and emails work together
Use it with your favorite AI tools
Connect this server to Cursor, Claude, VS Code, and more.
More in this category
TomTom Parking Availability
Search parking spots — audit locations and availability via AI.
Riot Games
Access League of Legends player data — summoner profiles, match history, ranked stats, champion masteries and live games.
Meituan Waimai
Essential food delivery gig API — manage orders, track delivery, handle refunds, and control restaurant menus via Meituan Waimai.
You might also like
Tuputech Moderation
Bring Tuputech's Advanced Anti-Spam and AI Evaluation endpoints to your server. Scan text, images, and audio automatically via AI.
Salesforce Service Cloud
Manage support cases, search the knowledge base, track case metrics, and resolve customer issues through natural conversation.
Nubank MX
Manage your Nubank Mexico banking from any AI agent — check balances, review transactions, send SPEI transfers, pay bills, and track spending analytics.