Facebook Ads Connector for AI agents.
12 live capabilities
Manage Meta ad campaigns and track marketing ROI via natural language.
Waiting for input…
Why people use Facebook Ads
Stop manual data entry with Facebook Ads for Meta marketing
With this Connector, you just ask your agent for the last 7 days of spend. It pulls the data from `get_insights` and gives you the number instantly. You spend less time clicking and more time thinking about your strategy.
What Vinkius changes
You get a direct line to your Meta data without the UI overhead.
Use it from Claude, ChatGPT, Cursor or another AI client you already have.
One account · 5,900+ Connectors
- Real-world use case 01
Checking for budget bleed
A marketer asks their agent to show spend vs clicks for the week.
- Real-world use case 02
Emergency campaign pause
A business owner tells their agent to stop the Spring sale.
- Real-world use case 03
Quick balance check
A growth lead asks for the account balance to check the remaining budget.
Complete set · 12capabilities
The complete Facebook Ads capability set.
These are the exact actions your AI can choose when you ask it to work with Facebook Ads.
01—04
4 capabilities in this set.
Part of 12 available through Facebook Ads.
- 01 Capability
Get ad account info
Get basic details for your Facebook Ad Account. This helps you see your current balance and currency at a glance.
- 02 Capability
Get ad details
Get specific details for a single ad. Use this to review targeting, budgets, and creative information.
- 03 Capability
Get campaign details
Get the full configuration for a specific campaign. You can use this to check the settings of your top-level ads.
- 04 Capability
Update campaign status
Toggle a campaign's status between active and paused. This helps you manage your high-level strategy quickly.
05—08
4 capabilities in this set.
Part of 12 available through Facebook Ads.
- 05 Capability
Update ad status
Change an ad to active or paused status. Use this to stop underperforming ads immediately.
- 06 Capability
Get ad set details
Get the configuration for a specific ad set. It lets you see the exact settings and budget for your groups.
- 07 Capability
Get insights
Pull performance metrics like impressions, clicks, and spend. This is how you see your actual ROI in real-time.
- 08 Capability
Get me
Check the identity and permissions of your current marketing token. Use this to verify your access level.
09—12
4 capabilities in this set.
Part of 12 available through Facebook Ads.
- 09 Capability
List ad sets
Get a list of all ad sets in your account. This is useful for a quick overview of your active groups.
- 10 Capability
List campaigns
Get a list of all campaigns in your account. This provides a clear view of your entire ad structure.
- 11 Capability
Update ad set status
Change the status of an ad set with one command. It lets you pause or start entire groups of ads at once.
- 12 Capability
List ads
Get a list of all ads in your account. Use this to see every individual creative currently running.
Set up in minutes
One URL. Then ask Facebook Ads to work.
Claude and ChatGPT only need the Connector URL. Copy it once, add it in settings, and use Facebook 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_ujxsf5XyxsXunbVnMc2BwDKgLjBQzobHBXKv9Zyh/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 Facebook Ads, and paste the URL above.
- Step 03
Turn it on in chat
Select +, open Connectors, and enable Facebook Ads for the conversation.
ChatGPT · Web + desktop
Connector URL · ready to paste
Streamable HTTPhttps://edge.vinkius.com/vk_preview_ujxsf5XyxsXunbVnMc2BwDKgLjBQzobHBXKv9Zyh/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 Facebook Ads URL.
- Step 03
Save and start
Save the connection and enable Facebook Ads in your conversation. Desktop may ask you to restart once.
Cursor · IDE configuration
Advanced setup
{
"mcpServers": {
"facebook-ads": {
"url": "https://edge.vinkius.com/vk_preview_ujxsf5XyxsXunbVnMc2BwDKgLjBQzobHBXKv9Zyh/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 Facebook Ads
Open Agent mode in chat and ask: "Using Facebook Ads, help me...". 12 tools available
VS Code Copilot · IDE configuration
Advanced setup
{
"mcpServers": {
"facebook-ads": {
"url": "https://edge.vinkius.com/vk_preview_ujxsf5XyxsXunbVnMc2BwDKgLjBQzobHBXKv9Zyh/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 Facebook Ads
Ask Copilot: "Using Facebook Ads, help me...". 12 tools available
Windsurf · IDE configuration
Advanced setup
{
"mcpServers": {
"facebook-ads": {
"url": "https://edge.vinkius.com/vk_preview_ujxsf5XyxsXunbVnMc2BwDKgLjBQzobHBXKv9Zyh/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 Facebook Ads
Open Cascade and ask: "Using Facebook Ads, help me...". 12 tools available
Cline · IDE configuration
Advanced setup
{
"mcpServers": {
"facebook-ads": {
"url": "https://edge.vinkius.com/vk_preview_ujxsf5XyxsXunbVnMc2BwDKgLjBQzobHBXKv9Zyh/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 Facebook Ads
Ask Cline: "Using Facebook Ads, help me...". 12 tools available
Claude Code · Terminal command
Advanced setup
claude mcp add facebook-ads --transport http "https://edge.vinkius.com/vk_preview_ujxsf5XyxsXunbVnMc2BwDKgLjBQzobHBXKv9Zyh/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 Facebook Ads
Ask Claude: "Using Facebook Ads, show me...". 12 tools are ready
Where the request belongs
Work Facebook Ads can move forward.
Who wakes up in the morning needing this? The performance marketer who needs to pause ads instantly or the small business owner who wants to know their daily ad spend without logging into Meta. It is for anyone tired of the manual grind of Meta Ads Manager.
Performance Marketer
They use this to quickly toggle ad statuses and check CPC metrics to ensure campaigns stay on track during peak hours.
Growth Lead
They use this to pull high-level spend and reach data for weekly reports without manual data exports.
Small Business Owner
They use this to check their daily ad spend and account balance via chat to manage their marketing budget on the fly.
Build the capability set
Add more capabilities.
Each Connector adds new actions and data without changing how you work.
Browse ConnectorsMeta Ads
Equip your AI agent with direct access to Meta Ads. manage Facebook and Instagram campaigns, track ad performance, and optimize spend without opening Meta Ads Manager.
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.
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.
Amazon Ads
Advertising management. manage Sponsored Products, brands, and performance reports via AI.
AdRoll
Retarget customers, launch display ad campaigns, and measure conversion performance across web and social channels.
AdButler
Serve and manage display ads, track impressions, and optimize ad zones across your digital properties with precision.
Bring your own AI
Change the model, client or framework. Keep Facebook 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 Facebook Ads.
The practical details behind the request, access and result.
Can the Facebook Ads MCP help me see my current ad spend?
Yes. It pulls real-time metrics like spend, reach, and clicks directly from your Meta account so you can see your ROI without opening the Ads Manager.
How do I use the Facebook Ads MCP to pause a campaign?
You can just tell your AI agent to pause a specific campaign by name or ID. It will use the Connector to update the status instantly.
Can I check my Meta account balance with the Facebook Ads MCP?
Yes. The Connector can retrieve your account's basic info, including your current balance and currency, through a simple chat command.
Does the Facebook Ads MCP work with Claude and Cursor?
It works with any MCP-compatible client, including Claude, Cursor, Windsurf, and VS Code.
Can I get performance metrics for specific ad sets using the Facebook Ads MCP?
Yes. You can ask for the specific details or insights of any ad set to see how your different audience groups are performing.
Is it possible to see all my active ads at once with the Facebook Ads MCP?
Yes. Your agent can list all ads or all campaigns in your account, giving you a high-level overview of everything currently running.
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 capability 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 capability provides comprehensive data including impressions, clicks, total spend, reach, CPC (cost per click), CTR (click-through rate), and CPP (cost per purchase).
One connection away
Give your agent a direct line to Facebook Ads.
Connect Facebook 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