AdsAgent — Meta Ads MCP

copy_ad_quick_copy

Prepare copies of live ads: request_mode=single uses ad_id, source_ad_account_id and target_ad_account_id; grouped uses grouped_plan.campaigns. v3 requires explicit statuses. Choose preserve_post/new_creatives; partnership preserves the post. For a whole tree use copy_ad_clone_structure. Review, then launch_confirm Use the workflow's original link_id when exposed.

Input Schema

Name	Required	Description	Default
`request`	Yes	Strict public copy request including documented compatibility aliases.

Output Schema

Name	Required	Description	Default
`message`	No
`retryable`	No
`support_ref`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 23, 2026
- removedInput schema / properties / connection_context
```
Removed value: -{
-  "pattern": "^mctx_v1_[0-9a-f]{64}$",
-  "type": "string"
-}
```

Changed25 schema fields changedOct 20, 2026

addedInput schema / properties / request / properties / ad_status / anyOf

Added value: +[
+  {
+    "description": "Use 开启 or 暂停.",
+    "enum": [
+      "开启",
+      "启用",
+      "暂停",
+      "active",
+      "paused"
+    ],
+    "type": "string"
+  },
+  {
+    "deprecated": true,
+    "description": "Deprecated platform values; use 开启 or 暂停.",
+    "enum": [
+      "ACTIVE",
+      "PAUSED"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

addedInput schema / properties / request / properties / ad_status / default
```
Added value: +null
```
removedInput schema / properties / request / properties / ad_status / enum
```
Removed value: -[
-  "ACTIVE",
-  "PAUSED"
-]
```
removedInput schema / properties / request / properties / ad_status / type
```
Removed value: -"string"
```

addedInput schema / properties / request / properties / adset_status / anyOf

Added value: +[
+  {
+    "description": "Use 开启 or 暂停.",
+    "enum": [
+      "开启",
+      "启用",
+      "暂停",
+      "active",
+      "paused"
+    ],
+    "type": "string"
+  },
+  {
+    "deprecated": true,
+    "description": "Deprecated platform values; use 开启 or 暂停.",
+    "enum": [
+      "ACTIVE",
+      "PAUSED"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

addedInput schema / properties / request / properties / adset_status / default
```
Added value: +null
```
removedInput schema / properties / request / properties / adset_status / enum
```
Removed value: -[
-  "ACTIVE",
-  "PAUSED"
-]
```
removedInput schema / properties / request / properties / adset_status / type
```
Removed value: -"string"
```

addedInput schema / properties / request / properties / campaign_status / anyOf

Added value: +[
+  {
+    "description": "Use 开启 or 暂停.",
+    "enum": [
+      "开启",
+      "启用",
+      "暂停",
+      "active",
+      "paused"
+    ],
+    "type": "string"
+  },
+  {
+    "deprecated": true,
+    "description": "Deprecated platform values; use 开启 or 暂停.",
+    "enum": [
+      "ACTIVE",
+      "PAUSED"
+    ],
+    "type": "string"
+  },
+  {
+    "type": "null"
+  }
+]

addedInput schema / properties / request / properties / campaign_status / default
```
Added value: +null
```
removedInput schema / properties / request / properties / campaign_status / enum
```
Removed value: -[
-  "ACTIVE",
-  "PAUSED"
-]
```
removedInput schema / properties / request / properties / campaign_status / type
```
Removed value: -"string"
```
changedInput schema / properties / request / properties / countries_override / items / maxLength
```
Previous value: -8New value: +200
```
changedInput schema / properties / request / properties / excluded_countries_override / items / maxLength
```
Previous value: -8New value: +200
```

addedInput schema / properties / request / properties / grouped_plan / properties / ad_status / anyOf

Added value: +[
+  {
+    "enum": [
+      "开启",
+      "启用",
+      "暂停",
+      "active",
+      "paused"
+    ],
+    "type": "string"
+  },
+  {
+    "deprecated": true,
+    "enum": [
+      "ACTIVE",
+      "PAUSED"
+    ],
+    "type": "string"
+  }
+]

removedInput schema / properties / request / properties / grouped_plan / properties / ad_status / enum
```
Removed value: -[
-  "ACTIVE",
-  "PAUSED"
-]
```
removedInput schema / properties / request / properties / grouped_plan / properties / ad_status / type
```
Removed value: -"string"
```

addedInput schema / properties / request / properties / grouped_plan / properties / adset_status / anyOf

Added value: +[
+  {
+    "enum": [
+      "开启",
+      "启用",
+      "暂停",
+      "active",
+      "paused"
+    ],
+    "type": "string"
+  },
+  {
+    "deprecated": true,
+    "enum": [
+      "ACTIVE",
+      "PAUSED"
+    ],
+    "type": "string"
+  }
+]

removedInput schema / properties / request / properties / grouped_plan / properties / adset_status / enum
```
Removed value: -[
-  "ACTIVE",
-  "PAUSED"
-]
```
removedInput schema / properties / request / properties / grouped_plan / properties / adset_status / type
```
Removed value: -"string"
```

addedInput schema / properties / request / properties / grouped_plan / properties / campaign_status / anyOf

Added value: +[
+  {
+    "enum": [
+      "开启",
+      "启用",
+      "暂停",
+      "active",
+      "paused"
+    ],
+    "type": "string"
+  },
+  {
+    "deprecated": true,
+    "enum": [
+      "ACTIVE",
+      "PAUSED"
+    ],
+    "type": "string"
+  }
+]

removedInput schema / properties / request / properties / grouped_plan / properties / campaign_status / enum
```
Removed value: -[
-  "ACTIVE",
-  "PAUSED"
-]
```
removedInput schema / properties / request / properties / grouped_plan / properties / campaign_status / type
```
Removed value: -"string"
```
changedInput schema / properties / request / properties / grouped_plan / properties / campaigns / items / properties / adsets / items / properties / countries_override / items / maxLength
```
Previous value: -8New value: +200
```
changedInput schema / properties / request / properties / grouped_plan / properties / campaigns / items / properties / adsets / items / properties / excluded_countries_override / items / maxLength
```
Previous value: -8New value: +200
```

Changed2 schema fields changedOct 18, 2026
- addedOutput schema / else / else / properties / approval_request / properties / confirm_tool
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / else / else / properties / approval_request / properties / instruction_template_id
```
Added value: +{
+  "type": "string"
+}
```
Changed6 schema fields changedOct 15, 2026
- addedOutput schema / else / then / properties / category
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / else / then / properties / expected
```
Added value: +{
+  "type": "boolean"
+}
```
- addedOutput schema / else / then / properties / failure_kind
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / else / then / properties / responsibility_hint
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / else / then / properties / route
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / else / then / properties / user_visible
```
Added value: +{
+  "type": "boolean"
+}
```
Changed1 schema field changedOct 13, 2026
- addedInput schema / properties / connection_context
```
Added value: +{
+  "pattern": "^mctx_v1_[0-9a-f]{64}$",
+  "type": "string"
+}
```
Changed3 schema fields changedOct 9, 2026
- addedOutput schema / else / else / properties / approval_request / properties / summary / properties / preflight / properties / checks / items / properties / provider_error_code
```
Added value: +{
+  "type": "integer"
+}
```
- addedOutput schema / else / else / properties / approval_request / properties / summary / properties / preflight / properties / checks / items / properties / provider_error_subcode
```
Added value: +{
+  "type": "integer"
+}
```
- addedOutput schema / else / else / properties / approval_request / properties / summary / properties / preflight / properties / checks / items / properties / reason_code
```
Added value: +{
+  "type": "string"
+}
```

Changed1 schema field changedOct 8, 2026

addedOutput schema / else / else / properties / approval_request / properties / summary / properties / preflight

Added value: +{
+  "properties": {
+    "ad_account_id": {
+      "type": "string"
+    },
+    "billing": {
+      "properties": {
+        "available_funds_major": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "balance_semantics": {
+          "type": "string"
+        },
+        "currency": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "low_remaining_spend_cap": {
+          "type": "boolean"
+        },
+        "note": {
+          "type": "string"
+        },
+        "reported_balance_major": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "spend_cap_remaining_major": {
+          "type": [
+            "number",
+            "null"
+          ]
+        }
+      },
+      "type": "object"
+    },
+    "checked_at": {
+      "type": "string"
+    },
+    "checks": {
+      "items": {
+        "properties": {
+          "asset_id": {
+            "type": "string"
+          },
+          "asset_type": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "type": "array"
+    },
+    "status": {
+      "type": "string"
+    },
+    "timing": {
+      "properties": {
+        "account_local_now": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "hours_left_today": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "note": {
+          "type": "string"
+        },
+        "schedule_valid": {
+          "type": "boolean"
+        },
+        "timezone_name": {
+          "type": [
+            "string",
+            "null"
+          ]
+        },
+        "utc_offset_hours": {
+          "type": "number"
+        },
+        "windows": {
+          "items": {
+            "properties": {
+              "end_time": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "hours_remaining": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "hours_until_start": {
+                "type": "number"
+              },
+              "paused": {
+                "type": "boolean"
+              },
+              "potential_delivery_hours_today": {
+                "type": "number"
+              },
+              "start_time": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          "type": "array"
+        }
+      },
+      "type": "object"
+    },
+    "version": {
+      "type": "integer"
+    },
+    "warnings": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "version",
+    "checked_at",
+    "ad_account_id",
+    "status",
+    "checks",
+    "warnings"
+  ],
+  "type": "object"
+}

Changed3 schema fields changedSep 17, 2026

addedInput schema / properties / request / properties / grouped_plan / properties

Added value: +{
+  "ad_status": {
+    "enum": [
+      "ACTIVE",
+      "PAUSED"
+    ],
+    "type": "string"
+  },
+  "adset_status": {
+    "enum": [
+      "ACTIVE",
+      "PAUSED"
+    ],
+    "type": "string"
+  },
+  "campaign_status": {
+    "enum": [
+      "ACTIVE",
+      "PAUSED"
+    ],
+    "type": "string"
+  },
+  "campaigns": {
+    "items": {
+      "properties": {
+        "adsets": {
+          "items": {
+            "properties": {
+              "ads": {
+                "items": {
+                  "properties": {
+                    "ad_name": {
+                      "maxLength": 500,
+                      "minLength": 1,
+                      "type": "string"
+                    },
+                    "ad_num": {
+                      "maximum": 50,
+                      "minimum": 1,
+                      "type": [
+                        "integer",
+                        "string"
+                      ]
+                    },
+                    "source_ad_id": {
+                      "maxLength": 255,
+                      "minLength": 1,
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "maxItems": 50,
+                "minItems": 1,
+                "type": "array"
+              },
+              "adset_name": {
+                "maxLength": 500,
+                "minLength": 1,
+                "type": "string"
+              },
+              "budget_mode": {
+                "enum": [
+                  "inherit",
+                  "custom"
+                ],
+                "type": "string"
+              },
+              "compliance_beneficiary": {
+                "maxLength": 500,
+                "type": "string"
+              },
+              "compliance_payor": {
+                "maxLength": 500,
+                "type": "string"
+              },
+              "countries_override": {
+                "items": {
+                  "maxLength": 8,
+                  "minLength": 2,
+                  "type": "string"
+                },
+                "maxItems": 250,
+                "type": "array"
+              },
+              "custom_budget": {
+                "minimum": 0,
+                "type": [
+                  "number",
+                  "string"
+                ]
+              },
+              "excluded_countries_override": {
+                "items": {
+                  "maxLength": 8,
+                  "minLength": 2,
+                  "type": "string"
+                },
+                "maxItems": 250,
+                "type": "array"
+              },
+              "start_time": {
+                "maxLength": 100,
+                "type": "string"
+              },
+              "target_adset_id": {
+                "maxLength": 255,
+                "minLength": 1,
+                "type": "string"
+              },
+              "worldwide_override": {
+                "type": [
+                  "boolean",
+                  "string",
+                  "integer"
+                ]
+              }
+            },
+            "required": [
+              "ads"
+            ],
+            "type": "object"
+          },
+          "maxItems": 50,
+          "minItems": 1,
+          "type": "array"
+        },
+        "bid_mode": {
+          "enum": [
+            "auto",
+            "custom"
+          ],
+          "type": "string"
+        },
+        "budget_mode": {
+          "enum": [
+            "inherit",
+            "custom"
+          ],
+          "type": "string"
+        },
+        "campaign_name": {
+          "maxLength": 500,
+          "minLength": 1,
+          "type": "string"
+        },
+        "custom_bid": {
+          "minimum": 0,
+          "type": [
+            "number",
+            "string"
+          ]
+        },
+        "custom_budget": {
+          "minimum": 0,
+          "type": [
+            "number",
+            "string"
+          ]
+        },
+        "is_adset_budget_sharing_enabled": {
+          "type": [
+            "boolean",
+            "string",
+            "integer"
+          ]
+        }
+      },
+      "required": [
+        "adsets"
+      ],
+      "type": "object"
+    },
+    "maxItems": 20,
+    "minItems": 1,
+    "type": "array"
+  },
+  "creation_contract_version": {
+    "enum": [
+      2,
+      3
+    ],
+    "type": [
+      "integer",
+      "string"
+    ]
+  },
+  "engagement_mode": {
+    "enum": [
+      "preserve_post",
+      "new_creatives"
+    ],
+    "type": "string"
+  },
+  "grouped_plan_mode": {
+    "enum": [
+      "new_tree",
+      "append_new_ads"
+    ],
+    "type": "string"
+  },
+  "mode": {
+    "const": "new_ads",
+    "type": "string"
+  },
+  "page_id": {
+    "maxLength": 255,
+    "minLength": 1,
+    "type": "string"
+  },
+  "request_mode": {
+    "const": "grouped",
+    "type": "string"
+  },
+  "source_ad_account_id": {
+    "maxLength": 255,
+    "minLength": 1,
+    "type": "string"
+  },
+  "target_ad_account_id": {
+    "maxLength": 255,
+    "minLength": 1,
+    "type": "string"
+  }
+}

addedInput schema / properties / request / properties / grouped_plan / required
```
Added value: +[
+  "campaigns"
+]
```

removedInput schema / properties / request / properties / grouped_plan / x-canonical-name-fields

Removed value: -[
-  "campaigns[].campaign_name",
-  "campaigns[].adsets[].adset_name",
-  "campaigns[].adsets[].ads[].ad_name"
-]

First observedSep 9, 2026

TDQS

A4.5/5.0

Behavior4/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

Annotations already declare this is not read-only and not destructive, but the description adds useful workflow context: it prepares copies rather than executing them immediately, requires review and launch_confirm, and notes that v3 requires explicit statuses. It does not detail permissions or rate limits, but with annotations present the bar is lower.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is compact and front-loads the core purpose and mode distinctions. The final sentence is slightly awkwardly joined ('launch_confirm Use...'), but overall it avoids bloat and keeps relevant guidance early.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness4/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the complex nested request schema and the presence of an output schema, the description gives the essential operational context: mode branching, v3 status requirements, engagement choice, whole-tree alternative, and confirmation workflow. The mention of link_id is not represented in the visible schema, which slightly reduces completeness, but the core invocation guidance is present.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Schema coverage is 100%, so the baseline is 3, but the description adds meaningful semantics beyond the schema: it maps request_mode to required identifiers, explains that grouped mode depends on grouped_plan.campaigns, and distinguishes preserve_post from new_creatives. It does not cover every nested parameter, but it clarifies the most important branching logic.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose5/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description states a specific verb and resource: 'Prepare copies of live ads,' and immediately distinguishes single versus grouped modes. It also names copy_ad_clone_structure as the alternative for whole-tree copying, so the agent can separate it from siblings.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines5/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

It explicitly says request_mode=single uses ad_id, source_ad_account_id, and target_ad_account_id, while grouped uses grouped_plan.campaigns. It also directs whole-tree use to copy_ad_clone_structure and instructs the agent to review and then call launch_confirm, giving clear workflow and alternative guidance.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All AdsAgent — Meta Ads MCP tools Inspect

Try in Browser

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?