{
  "info": {
    "name": "Meta Ads (Facebook & Instagram) — mcp.ai",
    "description": "REST API for the Meta Ads (Facebook & Instagram) MCP. Set {{apiKey}} to a workspace key (sk_live_…) created at https://mcp.ai/settings/api-keys.",
    "schema": "https://schema.getpostman.com/json/collection/v2.1.0/collection.json"
  },
  "auth": {
    "type": "bearer",
    "bearer": [
      {
        "key": "token",
        "value": "{{apiKey}}",
        "type": "string"
      }
    ]
  },
  "variable": [
    {
      "key": "baseUrl",
      "value": "https://api.mcp.ai/api/meta_ads",
      "type": "string"
    },
    {
      "key": "apiKey",
      "value": "sk_live_...",
      "type": "string"
    }
  ],
  "item": [
    {
      "name": "meta_ads_list_accounts",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/accounts",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "accounts"
          ]
        },
        "description": "List Meta connections (logins) + ad accounts inside each",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_status",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/status",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "status"
          ]
        },
        "description": "Validate token, expiry, connected ad accounts and scopes",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_campaigns",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/campaigns",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "campaigns"
          ]
        },
        "description": "List campaigns: id, name, status, objective, budget, dates",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"account\": \"\",\n  \"include_paused\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_campaign_write",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/campaigns/write",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "campaigns",
            "write"
          ]
        },
        "description": "Create, update, pause or activate campaigns. Budgets in cents.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"account\": \"\",\n  \"action\": \"\",\n  \"campaign_id\": \"\",\n  \"name\": \"\",\n  \"objective\": \"\",\n  \"daily_budget\": 0,\n  \"lifetime_budget\": 0,\n  \"status\": \"\",\n  \"special_ad_categories\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_campaign_delete",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/campaigns/delete",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "campaigns",
            "delete"
          ]
        },
        "description": "Delete campaign (irreversible)",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"campaign_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_adset_detail",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/adsets",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "adsets"
          ]
        },
        "description": "Ad set detail: targeting, budget, schedule, billing, optimization",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"account\": \"\",\n  \"include_paused\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_adset_write",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/adsets/write",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "adsets",
            "write"
          ]
        },
        "description": "Create or update ad sets. Targeting as JSON string.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"account\": \"\",\n  \"action\": \"\",\n  \"adset_id\": \"\",\n  \"campaign_id\": \"\",\n  \"name\": \"\",\n  \"daily_budget\": 0,\n  \"lifetime_budget\": 0,\n  \"billing_event\": \"\",\n  \"optimization_goal\": \"\",\n  \"targeting\": \"\",\n  \"start_time\": \"\",\n  \"end_time\": \"\",\n  \"status\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_adset_delete",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/adsets/delete",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "adsets",
            "delete"
          ]
        },
        "description": "Delete ad set (irreversible)",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"adset_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_ads",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/ads",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "ads"
          ]
        },
        "description": "List ads with creatives and insights (spend, revenue, ROAS, actions)",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"account\": \"\",\n  \"include_paused\": false,\n  \"since\": \"\",\n  \"until\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_today",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/insights/today",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "insights",
            "today"
          ]
        },
        "description": "Today dashboard per ad: spend, revenue, ROAS, CPA, impressions, clicks, CTR + _summary",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"account\": \"\",\n  \"include_zero\": false\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_realtime",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/insights/realtime",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "insights",
            "realtime"
          ]
        },
        "description": "Hourly realtime breakdown for today per ad + _summary",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_roas",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/insights/roas",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "insights",
            "roas"
          ]
        },
        "description": "ROAS for a date range via /insights (includes ads in any status). Default level=ad.",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"account\": \"\",\n  \"since\": \"\",\n  \"until\": \"\",\n  \"level\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_creative_write",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/creatives/write",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "creatives",
            "write"
          ]
        },
        "description": "Create creative, create ad or update ad",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"account\": \"\",\n  \"action\": \"\",\n  \"name\": \"\",\n  \"page_id\": \"\",\n  \"message\": \"\",\n  \"link\": \"\",\n  \"image_hash\": \"\",\n  \"video_id\": \"\",\n  \"call_to_action_type\": \"\",\n  \"adset_id\": \"\",\n  \"creative_id\": \"\",\n  \"ad_id\": \"\",\n  \"status\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_creative_delete",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/creatives/delete",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "creatives",
            "delete"
          ]
        },
        "description": "Delete ad (irreversible)",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"ad_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_pages",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/pages",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "pages"
          ]
        },
        "description": "Pages: list / insights / posts / post_insights",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"action\": \"\",\n  \"page_id\": \"\",\n  \"post_id\": \"\",\n  \"period\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_business",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/business",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "business"
          ]
        },
        "description": "Business Manager: list / accounts / pages / users / pixels",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"action\": \"\",\n  \"business_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_media",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/media",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "media"
          ]
        },
        "description": "List uploaded images or videos",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"account\": \"\",\n  \"action\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_media_write",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/media/write",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "media",
            "write"
          ]
        },
        "description": "Upload images/videos or get curl command for large local videos",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"account\": \"\",\n  \"action\": \"\",\n  \"image_url\": \"\",\n  \"video_url\": \"\",\n  \"title\": \"\",\n  \"file_path\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_audience",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/audiences",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "audiences"
          ]
        },
        "description": "List Custom Audiences",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"account\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_audience_write",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/audiences/write",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "audiences",
            "write"
          ]
        },
        "description": "Create audience or add users (PII SHA-256 hashed automatically)",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"account\": \"\",\n  \"action\": \"\",\n  \"audience_id\": \"\",\n  \"name\": \"\",\n  \"description\": \"\",\n  \"users\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    },
    {
      "name": "meta_ads_audience_delete",
      "request": {
        "method": "POST",
        "header": [
          {
            "key": "Content-Type",
            "value": "application/json"
          }
        ],
        "url": {
          "raw": "{{baseUrl}}/audiences/delete",
          "host": [
            "{{baseUrl}}"
          ],
          "path": [
            "audiences",
            "delete"
          ]
        },
        "description": "Delete Custom Audience (irreversible)",
        "body": {
          "mode": "raw",
          "raw": "{\n  \"auth_account\": \"\",\n  \"audience_id\": \"\"\n}",
          "options": {
            "raw": {
              "language": "json"
            }
          }
        }
      }
    }
  ]
}