Meta Ads MCP — by Pragmatic Growth

Operational · uptime 47m

Tools

Modules

Modes

API Documentation Health OpenAPI Spec GitHub

Quick Start

Connect with Claude Code

Add secrets to .env (gitignored), then reference them in .mcp.json:

# .env
META_MCP_URL=https://meta-mcp.pragmaticgrowth.com/mcp
MCP_API_KEY=your_api_key

// .mcp.json
{
  "mcpServers": {
    "meta-mcp": {
      "command": "npx",
      "args": [
        "mcp-remote",
        "${META_MCP_URL}",
        "--header",
        "Authorization: Bearer ${MCP_API_KEY}"
      ]
    }
  }
}

Environment variables are resolved automatically — no secrets in .mcp.json.

REST API

Call any endpoint directly. Requires Authorization (API key) and X-Meta-Token (Meta access token).

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "X-Meta-Token: YOUR_META_TOKEN" \
     https://meta-mcp.pragmaticgrowth.com/api/v1/campaigns

Graph API Proxy

Access any Meta Graph API endpoint. The path after /api/v1/meta/ maps directly to the Graph API.

curl -H "Authorization: Bearer YOUR_API_KEY" \
     -H "X-Meta-Token: YOUR_META_TOKEN" \
     https://meta-mcp.pragmaticgrowth.com/api/v1/meta/me/adaccounts?fields=id,name

Endpoints

GET/api/v1/accountsAd accounts

CRUD/api/v1/campaignsCampaigns

CRUD/api/v1/adsetsAd sets

CRUD/api/v1/adsAds

GET/api/v1/creativesCreatives

GET/api/v1/insights/:idInsights

GET/api/v1/imagesImages

GET/api/v1/audiencesAudiences

GET/api/v1/pixelsPixels

POST/api/v1/conversions/:pixelIdConversions API

ANY/api/v1/meta/*Graph API proxy

POST/mcpMCP protocol