How to Use the Facebook Ads MCP in Claude

Q: How do I connect my Facebook Ads account to Claude Desktop?

Open your claudedesktopconfig.json file and add the Facebook Ads MCP Server configuration under the mcpServers key. Once you restart the desktop app, you will see the tools ready to run inside your chat window.

Q: Can Claude Desktop automatically pause my Facebook Ads?

Yes, if you give your agent explicit permission. It uses updateadstatus or updatecampaignstatus to toggle active states based on the real-time performance trends you ask it to analyze.

Pause bleeding Facebook Ads campaigns and pull real-time performance insights directly inside your Claude Desktop chat window.

See Vinkius in Action

Works with every AI agent you already use

…and any MCP-compatible client

MCP Servers - Free for Subscribers

Connect Facebook Ads MCP to Claude Desktop

Create your Vinkius account to connect Facebook Ads to Claude Desktop and route execution through our secure gateway. The platform manages server hosting, runtime updates, and security layers. Configuration requires no manual server provisioning.

GDPR Free for Subscribers

Setup Facebook Ads with Claude Desktop

Ask AI about this MCP

ChatGPT

Claude

Perplexity

Control Facebook Ads spend with this MCP Server

The `list_campaigns` tool lets you fetch active lists directly inside Claude Desktop so you don't have to open Ads Manager fifty times a day. This server gives your client direct access to your Meta campaigns, allowing you to check which assets drag down your overall return. When an ad set starts burning money, you don't need to switch tabs or run manual reports. Just tell Claude to run `update_ad_set_status` to pause the bleeding instantly. It works directly in your chat interface, keeping your focus where it belongs.

Analyze live performance metrics inside chat

The `get_insights` tool retrieves clean, structured performance metrics for your ad account without making you wade through a cluttered dashboard. This integration acts as a lightweight MCP bridge that bypasses messy native reporting. Your agent can compare these insights with your historical targets to pinpoint exactly which audiences drive your acquisition costs up. You get plain-English summaries of your actual numbers, fast.

Audit campaign structures on demand

The `list_ad_sets` and `list_ads` tools pull your entire account setup directly into Claude Desktop so you can see exactly how your budget is distributed. Mapping out complex funnels becomes a matter of asking your agent a direct question. By querying `get_campaign_details`, your agent inspects the specific configuration of your active campaigns. It flags overlapping audiences or conflicting bids before they cost you money, keeping your account lean.

Setup guide

Set up Facebook Ads MCP in Claude Web or Desktop

1

Open Claude Settings

Go to claude.ai, click your profile icon, then navigate to Customize → Connectors.
2

Add Custom Connector

Click the "+" button and select Add custom connector. Paste your Vinkius endpoint URL: https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp Replace [YOUR_TOKEN_HERE] with your token from cloud.vinkius.com. For OAuth-protected servers, expand Advanced settings to add credentials.
3

Start a conversation

Open a new chat. The Facebook Ads MCP tools are available immediately — no restart needed.

Endpoint URL

https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp

No configuration file needed — paste the URL directly in the Claude web interface.

Available on Free (1 connector), Pro, Max, Team, and Enterprise plans.

Prerequisites

Claude Desktop installed (macOS or Windows)
Active Vinkius subscription with a valid endpoint token

1

Open Claude Desktop Settings

Click the menu icon at the top-left corner, go to Settings → Developer → Edit Config. This opens claude_desktop_config.json in your default text editor.
2

Paste the Facebook Ads MCP configuration

Copy the JSON snippet on the right into the mcpServers object. Replace [YOUR_TOKEN_HERE] with your endpoint token from cloud.vinkius.com.
3

Restart Claude Desktop

Close and reopen the application. Claude needs a full restart to load new MCPs — refreshing a conversation is not enough.
4

Verify the connection

Open a new conversation. Click the 🔌 icon at the bottom of the message input. You should see tools listed under facebook-ads-mcp.

json

{
  "mcpServers": {
    "facebook-ads-mcp": {
      "url": "https://edge.vinkius.com/[YOUR_TOKEN_HERE]/mcp"
    }
  }
}

Get your connection token →

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.

Why Choose Vinkius

Vinkius connects your tools to AI with real-time monitoring and automatic cost savings — all from one dashboard.

Connect Facebook Ads now

Real-time monitoring

Live

visibility into every interaction

Connect your favorite tools to your AI and see exactly what's happening — every request, every response, in real time.

Built-in savings

60%

lower AI costs

Vinkius compresses data between your apps and your AI automatically. Lower bills every month — no configuration required.

Single dashboard

One

place for every integration

Every tool your AI connects to, managed from a single screen. One account, complete control.

Common questions about Facebook Ads MCP in Claude Desktop

Open your `claude_desktop_config.json` file and add the Facebook Ads MCP Server configuration under the `mcpServers` key. Once you restart the desktop app, you will see the tools ready to run inside your chat window.

Yes, if you give your agent explicit permission. It uses `update_ad_status` or `update_campaign_status` to toggle active states based on the real-time performance trends you ask it to analyze.

You can switch between accounts by specifying the target ID when prompting Claude. The underlying `get_ad_account_info` tool will fetch the specific account details you request.

You can ask Claude to loop through a list of IDs returned by `list_campaigns` and apply status changes. Your agent will execute `update_campaign_status` sequentially for each target you approve.

Your Meta developer access tokens are stored locally on your machine and never pass through third-party servers. The MCP architecture ensures that performance metrics and account IDs are only transmitted directly between your local Claude client and the official Meta Graph API.

Use it with your favorite AI tools

Connect this server to Cursor, Claude, VS Code, and more.

OpenAI Agents SDK sdk-python

Google ADK sdk-python

Pydantic AI sdk-python

Vercel AI SDK sdk-typescript