Meta Ads Connector for AI agents.
10 live capabilities
Manage Facebook and Instagram ad spend and performance through conversation.
Waiting for input…
Why people use Meta Ads
Meta Ads Performance Management
This Connector replaces that clicking with a simple question. You just ask your agent for the ROAS of your Summer Sale campaign, and it pulls the data instantly. You get the answers you need without ever opening a new tab.
What Vinkius changes
You get a conversational interface for your entire Meta advertising account.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Identifying high CPC spikes
A marketer sees a spike in CPC.
- Real-world use case 02
Monitoring daily ROAS
An e-commerce owner wants to know if a sale is working.
- Real-world use case 03
Emergency spend control
A campaign is overspending on a weekend.
Complete set · 10capabilities
The complete Meta Ads capability set.
These are the exact actions your AI can choose when you ask it to work with Meta Ads.
01—04
4 capabilities in this set.
Part of 10 available through Meta Ads.
- 01 Capability
List creatives
Browse through the different images and videos available in your account.
- 02 Capability
Activate campaign
Turn a paused campaign back on once it is ready to run.
- 03 Capability
List ads
View the individual creatives and copy used in a specific ad set.
- 04 Capability
Get account insights
Get a high-level summary of your total account performance.
05—07
3 capabilities in this set.
Part of 10 available through Meta Ads.
- 05 Capability
List audiences
See all your saved custom and lookalike audiences.
- 06 Capability
Pause campaign
Stop a running campaign immediately to prevent overspending.
- 07 Capability
List campaigns
View every active and paused campaign in your Meta ad account.
08—10
3 capabilities in this set.
Part of 10 available through Meta Ads.
- 08 Capability
Get account info
Fetch the basic details and status of your current ad account.
- 09 Capability
Get campaign insights
Pull specific performance numbers like spend and reach for a campaign.
- 10 Capability
List ad sets
See the different targeting groups and budgets within a campaign.
Set up in minutes
One URL. Then ask Meta Ads to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Meta Ads from the conversation.
Choose your client
Live previewAdvanced clients IDE · CLI
Claude · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_xSmcdbyTBcMk8IuE1dUxX4Y8r2aHYbus0WHmjrRr/mcp - Step 01
Open Connectors
In Claude Web or Claude Desktop, open Settings and choose Connectors.
- Step 02
Add the URL
Choose Add custom connector, name it Meta Ads, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Meta Ads for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_xSmcdbyTBcMk8IuE1dUxX4Y8r2aHYbus0WHmjrRr/mcp - Step 01
Open MCP settings
On desktop, open Settings and MCP servers. On web, open your workspace app or connector settings.
- Step 02
Add the URL
Choose Add server with Streamable HTTP, or create a custom MCP app, then paste the Meta Ads URL.
- Step 03
Save and start
Save the connection and enable Meta Ads in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"meta-ads": {
"url": "https://edge.vinkius.com/vk_preview_xSmcdbyTBcMk8IuE1dUxX4Y8r2aHYbus0WHmjrRr/mcp"
}
}
} - Step 01
Open MCP Settings
Press Cmd+Shift+P (macOS) or Ctrl+Shift+P (Windows/Linux) → search "MCP Settings"
- Step 02
Add the server config
Paste the JSON configuration above into the mcp.json file that opens
- Step 03
Save the file
Cursor will automatically detect the new Connector
- Step 04
Start using Meta Ads
Open Agent mode in chat and ask: "Using Meta Ads, help me...". 10 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"meta-ads": {
"url": "https://edge.vinkius.com/vk_preview_xSmcdbyTBcMk8IuE1dUxX4Y8r2aHYbus0WHmjrRr/mcp"
}
}
} - Step 01
Create MCP config
Create a .vscode/mcp.json file in your project root
- Step 02
Add the server config
Paste the JSON configuration above
- Step 03
Enable Agent mode
Open GitHub Copilot Chat and switch to Agent mode using the dropdown
- Step 04
Start using Meta Ads
Ask Copilot: "Using Meta Ads, help me...". 10 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"meta-ads": {
"url": "https://edge.vinkius.com/vk_preview_xSmcdbyTBcMk8IuE1dUxX4Y8r2aHYbus0WHmjrRr/mcp"
}
}
} - Step 01
Open MCP Settings
Go to Settings → MCP Configuration or press Cmd+Shift+P and search "MCP"
- Step 02
Add the server
Paste the JSON configuration above into mcp_config.json
- Step 03
Save and reload
Windsurf will detect the new server automatically
- Step 04
Start using Meta Ads
Open Cascade and ask: "Using Meta Ads, help me...". 10 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"meta-ads": {
"url": "https://edge.vinkius.com/vk_preview_xSmcdbyTBcMk8IuE1dUxX4Y8r2aHYbus0WHmjrRr/mcp"
}
}
} - Step 01
Open Cline MCP Settings
Click the Connectors icon in the Cline sidebar panel
- Step 02
Add remote server
Click "Add Connector" and paste the configuration above
- Step 03
Enable the server
Toggle the server switch to ON
- Step 04
Start using Meta Ads
Ask Cline: "Using Meta Ads, help me...". 10 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add meta-ads --transport http "https://edge.vinkius.com/vk_preview_xSmcdbyTBcMk8IuE1dUxX4Y8r2aHYbus0WHmjrRr/mcp" - Step 01
Install Claude Code
Run npm install -g @anthropic-ai/claude-code if not already installed
- Step 02
Add the Connector
Run the command above in your terminal
- Step 03
Verify the connection
Run claude mcp to list connected servers, or type /mcp inside a session
- Step 04
Start using Meta Ads
Ask Claude: "Using Meta Ads, show me...". 10 tools are ready
Where the request belongs
Work Meta Ads can move forward.
Performance marketers who are tired of dashboard fatigue and e-commerce owners who need to see their ROAS without manual math.
Performance Marketer
Analyzes daily spend and adjusts budgets on the fly to hit KPIs.
E-commerce Brand Owner
Monitors product catalog performance and looks for winning creatives.
Ads Agency Account Manager
Manages multiple client accounts without needing to log in and out of different dashboards.
When one Connector is not enough
Carry the request into a workflow.
Combine Meta Ads with the systems that finish the task.
View all recipesConnectors 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
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsFacebook Ads
Manage your Facebook and Meta Ads via AI. list campaigns, track performance insights, and update ad status directly through your agent.
Google Ads
Equip your AI agent with direct access to Google Ads. manage search, display, and shopping campaigns, track conversions, and optimize ad spend without opening the Google Ads console.
X Ads (Twitter)
Connect your X Ads account to any AI agent. audit campaigns, analyze line item performance, and pull engagement reports through natural conversation.
AdRoll
Retarget customers, launch display ad campaigns, and measure conversion performance across web and social channels.
Amazon Ads
Advertising management. manage Sponsored Products, brands, and performance reports via AI.
Reportei
Generate marketing performance reports from Google, Facebook, and Instagram data in minutes for client presentations.
Bring your own AI
Change the model, client or framework. Keep Meta Ads connected.
-
Claude -
ChatGPT -
Gemini -
Cursor -
VS Code -
Windsurf -
ZCode -
Cline -
Zed -
Continue -
Kiro -
Roo Code -
Zencoder -
Goose -
Void -
Augment Code -
Amp -
Qodo -
Tabnine -
Pieces -
Sourcegraph Cody -
JetBrains -
Warp -
Amazon Q -
Antigravity -
BoltAI -
Raycast -
Jan -
LM Studio -
AnythingLLM -
Open WebUI -
Msty -
Cherry Studio -
LibreChat -
TypingMind -
Chorus -
5ire -
n8n -
LangChain -
LlamaIndex -
CrewAI -
Vercel AI SDK
Before you connect
Questions about Meta Ads.
The practical details behind the request, access and result.
Can I use the Meta Ads MCP to manage both Facebook and Instagram?
Yes, this Connector covers both Facebook and Instagram. You can manage campaigns, check performance, and handle audiences for both platforms in one place.
How does the Meta Ads MCP help with ROAS tracking?
It pulls real-time performance metrics directly from your account. You can ask for your ROAS at any time to see how your spend is converting.
Can I pause my ads using the Meta Ads MCP?
Yes, you can tell your agent to pause any campaign immediately. This is helpful for stopping spend on underperforming ads without opening the dashboard.
Is the Meta Ads MCP good for agencies?
It is excellent for agencies. It allows you to quickly check metrics and manage multiple client accounts through a single conversational interface.
Does the Meta Ads MCP support custom audiences?
Yes, it can list your existing custom and lookalike audiences so you can see what is available for your targeting.
Can I see my creative performance with Meta Ads MCP?
Yes, you can pull data on your different images and videos to see which ones are driving the best results for your brand.
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.
One connection away
Give your agent a direct line to Meta Ads.
Connect Meta Ads once. Keep it beside 5,900+ managed Connectors when the next task needs more.
Explore every Connector No credit card required · Free tier available