Meta Ads Model Context Protocol (MCP) Setup & Tool Reference

Exposes campaign statistics, placement metrics, adset budgets, creatives compilation, and A/B test logs to local AI clients.

Connector Capabilities

Secure Python Model Context Protocol (MCP) server wrapping the Meta Graph API. Exposes ad accounts, adset structures, and placement analytics to your assistant workspace.

Placements Analytics: Compare conversion rates, impressions, and ROI between Facebook Feed, Instagram Stories, Reels, and Audience Network.
Interactive Mutates: Build and publish Meta campaigns, budgets, adsets, and creative links using standard prompt actions.
A/B Test Suite: Request automated statistical comparison between active A/B testing campaign variables.

Installation Steps

Step 1Clone the connector:

Terminal

git clone https://github.com/pralayasimha23/meta-ads-mcp-connector.git
cd meta-ads-mcp-connector

Step 2Setup Python env:

Terminal

python3 -m venv venv
source venv/bin/activate # (venv\Scripts\activate on Windows)
pip install -r requirements.txt

Step 3Configure credentials:

Add a .env file in the folder root:

.env

META_ADS_ACCESS_TOKEN=your_token
META_ADS_AD_ACCOUNT_ID=act_your_id
META_APP_ID=your_app_id
META_APP_SECRET=your_app_secret

Claude Desktop Configuration

Add this configuration to your local claude_desktop_config.json:

JSON

{
  "mcpServers": {
    "meta-ads": {
      "command": "/path/to/meta-ads-mcp-connector/venv/bin/python",
      "args": [
        "/path/to/meta-ads-mcp-connector/server.py"
      ],
      "env": {
        "META_ADS_ACCESS_TOKEN": "YOUR_TOKEN",
        "META_ADS_AD_ACCOUNT_ID": "act_YOUR_ACCOUNT_ID",
        "META_APP_ID": "YOUR_APP_ID",
        "META_APP_SECRET": "YOUR_APP_SECRET"
      }
    }
  }
}

Cursor Registration

Go to Settings > Features > MCP in Cursor. Click + Add New MCP Server. Set type to command and enter:

Command

python /path/to/meta-ads-mcp-connector/server.py

Meta Ads MCP Documentation

Connector Capabilities

Installation Steps

Claude Desktop Configuration

Cursor Registration

Registered Tools Explorer