meta-ads-mcp

Server Details

Facebook / Meta Ads automation with AI: analyze performance, test creatives, optimize spend.

Glama couldn't complete the latest health check. If this server requires authentication, missing or expired test credentials may be the cause. A test profile lets Glama authenticate for health checks and discover tools; it is separate from your personal connections.

If you are the author, claim ownership, then add or update a test profile under Admin → Test Profile.

Status: Unhealthy
OAuth: Works in Glama
Last Tested: 2026-09-21 07:30
Transport: Streamable HTTP
URL

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

1 tool updateFeb 27, 2026

Changedcreate_email_report1 field changed

addedInput schema / properties / account_goals

Added value: +{
+  "description": "Business goals for this account (e.g. \"Aim for 65-75 leads/day, ROAS above 3.0x\"). If omitted, previously saved goals are used.",
+  "maxLength": 5000,
+  "type": "string"
+}

1 tool updateFeb 26, 2026

Changedbulk_get_insights3 fields changed

addedInput schema / properties / adset_ids

Added value: +{
+  "description": "Filter to ads from these adsets only (ad level only). Applied server-side at Meta API level. Can be combined with campaign_ids. Example: [\"6017617490963\"]",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / campaign_ids

Added value: +{
+  "description": "Filter to ads from these campaigns only (ad level only). Applied server-side at Meta API level. Example: [\"6017617490961\", \"6017617490962\"]",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

changedInput schema / properties / compact / description

Previous value: -"When true, returns pivoted data (campaign_id, campaign_name, <metric>_by_period) for smaller response. Use \"fields\" param to specify metrics (default: spend). Use when querying many campaigns. Default: false"New value: +"For campaign/adset: returns pivoted data (campaign_id, campaign_name, <metric>_by_period). For ad level: strips derived metrics (ctr, cpc, cpm, reach, conversion_value). Ad level defaults to compact=true; pass false to get all fields."

3 tool updatesFeb 24, 2026

Changedbulk_get_insights4 fields changed

addedInput schema / properties / ad_name_contains

Added value: +{
+  "description": "Filter to ads whose name contains any of these strings (case-insensitive, ad level only). Example: [\"Video\", \"Static\", \"Carousel\"]",
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

addedInput schema / properties / after

Added value: +{
+  "description": "Pagination cursor for ad-level queries. Pass the next_cursor from a previous ad-level response to fetch the next 500 ads. Use with a single account_id.",
+  "type": "string"
+}

changedInput schema / properties / level / description

Previous value: -"The aggregation level. Supported values: \"account\", \"campaign\", \"adset\""New value: +"The aggregation level. Supported values: \"account\", \"campaign\", \"adset\", \"ad\". Ad level returns parsed metrics per ad (spend, impressions, clicks, ctr, roas) with hierarchy context (adset_name, campaign_name). Use account_ids and ad_name_contains to scope ad-level queries."

changedInput schema / properties / level / enum

Previous value: -[
-  "account",
-  "campaign",
-  "adset"
-]New value: +[
+  "account",
+  "campaign",
+  "adset",
+  "ad"
+]

Changedget_ad_accounts14 fields changed

removedInput schema / properties / access_token / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

removedInput schema / properties / access_token / default
```
Removed value: -null
```

addedInput schema / properties / access_token / description

Added value: +"Meta API access token (optional - will use cached token if not provided)"

removedInput schema / properties / access_token / title
```
Removed value: -"Access Token"
```
addedInput schema / properties / access_token / type
```
Added value: +"string"
```
removedInput schema / properties / limit / default
```
Removed value: -200
```

addedInput schema / properties / limit / description

Added value: +"Maximum number of accounts to return (default: 200)"

removedInput schema / properties / limit / title
```
Removed value: -"Limit"
```
removedInput schema / properties / user_id / default
```
Removed value: -"me"
```

addedInput schema / properties / user_id / description

Added value: +"Meta user ID or \"me\" for the current user (default: \"me\")"

removedInput schema / properties / user_id / title
```
Removed value: -"User Id"
```
addedInput schema / required
```
Added value: +[]
```

removedInput schema / title

Removed value: -"get_ad_accountsArguments"

changedOutput schema / (root)

Previous value: -{
-  "properties": {
-    "result": {
-      "title": "Result",
-      "type": "string"
-    }
-  },
-  "required": [
-    "result"
-  ],
-  "title": "get_ad_accountsOutput",
-  "type": "object"
-}New value: +null

Changedsearch9 fields changed

removedInput schema / properties / access_token / anyOf

Removed value: -[
-  {
-    "type": "string"
-  },
-  {
-    "type": "null"
-  }
-]

removedInput schema / properties / access_token / default
```
Removed value: -null
```

addedInput schema / properties / access_token / description

Added value: +"Meta API access token (optional - will use cached token if not provided)"

removedInput schema / properties / access_token / title
```
Removed value: -"Access Token"
```
addedInput schema / properties / access_token / type
```
Added value: +"string"
```

addedInput schema / properties / query / description

Added value: +"Search query string to find relevant Meta Ads records"

removedInput schema / properties / query / title
```
Removed value: -"Query"
```
removedInput schema / title
```
Removed value: -"searchArguments"
```

changedOutput schema / (root)

Previous value: -{
-  "properties": {
-    "result": {
-      "title": "Result",
-      "type": "string"
-    }
-  },
-  "required": [
-    "result"
-  ],
-  "title": "searchOutput",
-  "type": "object"
-}New value: +null

3 tool updatesFeb 23, 2026
- Addedbulk_upload_ad_images
- Addedbulk_upload_ad_videos
- Addedupload_ad_video

1 tool updateFeb 22, 2026

Changedcreate_ad_creative1 field changed

addedInput schema / properties / asset_customization_rules

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "additionalProperties": true,
+        "type": "object"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Asset Customization Rules"
+}

1 tool updateFeb 20, 2026
- Addedcreate_email_report

4 tool updatesFeb 19, 2026

Changedduplicate_ad1 field changed

addedInput schema / properties / pb_token

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Pb Token"
+}

Changedduplicate_adset1 field changed

addedInput schema / properties / pb_token

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Pb Token"
+}

Changedduplicate_campaign1 field changed

addedInput schema / properties / pb_token

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Pb Token"
+}

Changedduplicate_creative1 field changed

addedInput schema / properties / pb_token

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Pb Token"
+}

2 tool updatesFeb 17, 2026

Addedget_creative_details

Changedget_instagram_accounts3 fields changed

changedInput schema / properties / account_id / description

Previous value: -"Meta Ads account ID (format: act_XXXXXXXXX). Fallback if page_id not provided."New value: +"Meta Ads account ID (format: act_XXXXXXXXX)."

removedInput schema / properties / page_id

Removed value: -{
-  "description": "Facebook Page ID. Returns the Instagram Business Account linked to this page (preferred for instagram_actor_id).",
-  "type": "string"
-}

addedInput schema / required
```
Added value: +[
+  "account_id"
+]
```

1 tool updateFeb 17, 2026
- Addedget_instagram_accounts

1 tool updateFeb 17, 2026

Changedcreate_ad_creative2 fields changed

addedInput schema / properties / thumbnail_url

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Thumbnail Url"
+}

addedInput schema / properties / video_id

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Video Id"
+}

2 tool updatesFeb 16, 2026

Changedcreate_ad_creative1 field changed

addedInput schema / properties / ad_formats

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Ad Formats"
+}

Changedupdate_ad_creative1 field changed

addedInput schema / properties / ad_formats

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Ad Formats"
+}

1 tool updateFeb 13, 2026

Changedbulk_get_insights1 field changed

changedInput schema / properties / level / enum

Previous value: -[
-  "account",
-  "campaign",
-  "adset",
-  "ad"
-]New value: +[
+  "account",
+  "campaign",
+  "adset"
+]

2 tool updatesFeb 12, 2026

Changedcreate_ad_creative7 fields changed

addedInput schema / properties / image_hash / anyOf

Added value: +[
+  {
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

addedInput schema / properties / image_hash / default
```
Added value: +null
```
removedInput schema / properties / image_hash / type
```
Removed value: -"string"
```

addedInput schema / properties / image_hashes

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Image Hashes"
+}

addedInput schema / properties / messages

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Messages"
+}

addedInput schema / properties / optimization_type

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Optimization Type"
+}

changedInput schema / required

Previous value: -[
-  "account_id",
-  "image_hash"
-]New value: +[
+  "account_id"
+]

Changedupdate_ad_creative2 fields changed

addedInput schema / properties / messages

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Messages"
+}

addedInput schema / properties / optimization_type

Added value: +{
+  "anyOf": [
+    {
+      "type": "string"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Optimization Type"
+}

2 tool updatesFeb 11, 2026

Changedcreate_adset1 field changed

addedInput schema / properties / bid_constraints

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Bid Constraints"
+}

Changedupdate_adset1 field changed

addedInput schema / properties / bid_constraints

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": true,
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ],
+  "default": null,
+  "title": "Bid Constraints"
+}

1 tool updateFeb 3, 2026

Changedbulk_get_insights1 field changed

changedInput schema / properties / level / description

Previous value: -"The aggregation level. Supported values: \"account\", \"campaign\""New value: +"The aggregation level. Supported values: \"account\", \"campaign\", \"adset\""

Related MCP Connectors

tiktok-ads-mcpOAuth
co.pipeboard
TikTok Ads automation with AI: analyze performance, manage campaigns, optimize creatives.
Marketing Social Media AI & Machine Learning
2
mcp-serverOAuth
co.flyweel
Access Google & Meta Ads data via AI. Analyse campaign performance in seconds.
Marketing Search Data Platforms
2
PixeroOAuth
io.github.ryanzambrano
AI marketing agent for paid social: Meta ads campaigns, ad creative generation, lead delivery.
Marketing Social Media
1
AdCrunchOAuth
dev.adcrunch
Ask AI about your ads — query Meta, TikTok, and Google Ads performance in natural language.
Marketing Search
21

Related MCP Servers

Meta Ads MCP
Marketing Social Media
swesmith-repos
A
license
A
quality
Not graded
maintenance
Enables AI-powered analysis, management, and optimization of Meta advertising campaigns across Facebook and Instagram, including performance insights, budget optimization, and creative testing.
Updated 9 months ago (2025-12-25 00:52 UTC)
33
Business Source 1.1
fb-ads-automation
Marketing AI & Machine Learning Social Media
shashankrai1983
A
license
Not graded
quality
D
maintenance
Enables full read/write management of Facebook ad campaigns, ad sets, ads, and creatives via the Meta Marketing API through natural language, with AI creative generation, performance analytics, and PDF reporting.
Updated 7 months ago (2026-03-04 04:37 UTC)
MIT
Meta Ads MCP Server
Marketing Social Media
nishi0077
A
license
Not graded
quality
D
maintenance
Enables management and analysis of Meta (Facebook/Instagram) ads through natural language conversations, with 30 tools for reading and writing ad data.
Updated 6 months ago (2026-04-03 07:51 UTC)
MIT
AdKitofficial
Marketing Social Media AI & Machine Learning
adkit
A
license
Not graded
quality
A
maintenance
Manage ad campaigns across Meta, Google, and TikTok, create campaigns, analyze performance, spy on competitors, and generate AI creatives.
Updated 15 days ago (2026-09-06 14:26 UTC)
13
MIT