AdsAgent — Meta Ads MCP

ads_update_copy_prepare

Prepare body/title/description edits on the same Ad ID, preserving media and Page

Input Schema

Name	Required	Description	Default
`body`	No
`ad_id`	Yes
`title`	No
`description`	No
`ad_account_id`	Yes

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"
-}
```

Changed3 schema fields changedOct 22, 2026

removedOutput schema / $defs

Removed value: -{
-  "s0": {
-    "properties": {
-      "account_currency": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "action": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "ad_account_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "ad_count": {
-        "type": "integer"
-      },
-      "ad_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "ad_name_after": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "ad_name_before": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "ad_status": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "adset_count": {
-        "type": "integer"
-      },
-      "adset_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "adset_status": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "bid": {
-        "$ref": "#/$defs/s1"
-      },
-      "budget": {
-        "$ref": "#/$defs/s1"
-      },
-      "campaign_count": {
-        "type": "integer"
-      },
-      "campaign_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "campaign_status": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "change_percent": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "copies": {
-        "type": "integer"
-      },
-      "count": {
-        "type": "integer"
-      },
-      "creative_after": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "creative_before": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "cross_account": {
-        "type": "boolean"
-      },
-      "current_daily_budget": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "engagement_mode": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "entity_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "entity_type": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "groups": {
-        "items": {
-          "properties": {
-            "adsets": {
-              "items": {
-                "properties": {
-                  "name": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  },
-                  "target_adset_id": {
-                    "type": [
-                      "string",
-                      "null"
-                    ]
-                  }
-                },
-                "type": "object"
-              },
-              "type": "array"
-            },
-            "bid": {
-              "$ref": "#/$defs/s6"
-            },
-            "budget": {
-              "$ref": "#/$defs/s6"
-            },
-            "campaign_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "layout": {
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "items": {
-        "items": {
-          "properties": {
-            "ad_account_id": {
-              "type": "string"
-            },
-            "ad_id": {
-              "type": "string"
-            },
-            "campaign_id": {
-              "type": "string"
-            },
-            "current_configured_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "current_daily_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "new_daily_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "target_configured_status": {
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "mode": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "new_daily_budget": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "note": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "page_id_after": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "page_id_before": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "publish_start_label": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "source_ad_account_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "source_ad_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "source_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "source_level": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "source_name": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "statuses": {
-        "properties": {
-          "ad": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "adset": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "campaign": {
-            "type": [
-              "string",
-              "null"
-            ]
-          }
-        },
-        "type": "object"
-      },
-      "structure": {
-        "properties": {
-          "ads": {
-            "type": "integer"
-          },
-          "adsets": {
-            "type": "integer"
-          },
-          "auxiliary_writes": {
-            "type": "integer"
-          },
-          "campaigns": {
-            "type": "integer"
-          },
-          "creative_keys": {
-            "type": "integer"
-          },
-          "layouts": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          }
-        },
-        "type": "object"
-      },
-      "target_ad_account_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "template_name": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "warnings": {
-        "items": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "anyOf": [
-                {
-                  "properties": {
-                    "code": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "code"
-                  ]
-                },
-                {
-                  "required": [
-                    "message"
-                  ]
-                }
-              ],
-              "properties": {
-                "message": {
-                  "type": "string"
-                }
-              },
-              "type": "object"
-            }
-          ]
-        },
-        "type": "array"
-      }
-    },
-    "type": "object"
-  },
-  "s1": {
-    "properties": {
-      "amount": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "currency": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "daily_budget": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "level": {
-        "type": "string"
-      },
-      "mode": {
-        "type": "string"
-      },
-      "total_daily_budget": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "unit": {
-        "type": "string"
-      }
-    },
-    "type": [
-      "null",
-      "object"
-    ]
-  },
-  "s6": {
-    "properties": {
-      "amount": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "currency": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "daily_budget": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "level": {
-        "type": "string"
-      },
-      "mode": {
-        "type": "string"
-      },
-      "total_daily_budget": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "unit": {
-        "type": "string"
-      }
-    },
-    "type": "object"
-  }
-}

changedOutput schema / else / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "approval_request": {
-        "properties": {
-          "approval_ref": {
-            "type": "string"
-          },
-          "confirm_token": {
-            "type": "string"
-          },
-          "confirm_tool": {
-            "type": "string"
-          },
-          "expires_at": {
-            "type": "string"
-          },
-          "instruction_template_id": {
-            "type": "string"
-          },
-          "mode": {
-            "type": "string"
-          },
-          "plan_digest": {
-            "type": "string"
-          },
-          "schema_version": {
-            "type": "integer"
-          },
-          "status": {
-            "const": "approval_required"
-          },
-          "summary": {
-            "$ref": "#/$defs/s0"
-          },
-          "tool_name": {
-            "type": "string"
-          },
-          "user_instruction": {
-            "type": "string"
-          },
-          "warnings": {
-            "items": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "anyOf": [
-                    {
-                      "properties": {
-                        "code": {
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "code"
-                      ]
-                    },
-                    {
-                      "required": [
-                        "message"
-                      ]
-                    }
-                  ],
-                  "properties": {
-                    "message": {
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                }
-              ]
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "status",
-          "confirm_token",
-          "expires_at",
-          "summary"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "approval_request"
-    ]
-  },
-  {
-    "properties": {
-      "ad_account_id": {
-        "type": "string"
-      },
-      "ad_id": {
-        "type": "string"
-      },
-      "status": {
-        "const": "unchanged"
-      },
-      "summary": {
-        "$ref": "#/$defs/s0"
-      }
-    },
-    "required": [
-      "status",
-      "ad_account_id",
-      "ad_id",
-      "summary"
-    ]
-  }
-]New value: +[
+  {
+    "required": [
+      "approval_request"
+    ]
+  },
+  {
+    "properties": {
+      "status": {
+        "const": "unchanged"
+      }
+    },
+    "required": [
+      "ad_account_id",
+      "ad_id",
+      "status",
+      "summary"
+    ]
+  }
+]

addedOutput schema / else / else / properties

Added value: +{
+  "ad_account_id": {
+    "type": "string"
+  },
+  "ad_id": {
+    "type": "string"
+  },
+  "approval_request": {
+    "properties": {
+      "approval_ref": {
+        "type": "string"
+      },
+      "confirm_token": {
+        "type": "string"
+      },
+      "confirm_tool": {
+        "type": "string"
+      },
+      "expires_at": {
+        "type": "string"
+      },
+      "instruction_template_id": {
+        "type": "string"
+      },
+      "mode": {
+        "type": "string"
+      },
+      "plan_digest": {
+        "type": "string"
+      },
+      "schema_version": {
+        "type": "integer"
+      },
+      "status": {
+        "const": "approval_required"
+      },
+      "summary": {
+        "properties": {
+          "account_currency": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "action": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "ad_account_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "ad_count": {
+            "type": "integer"
+          },
+          "ad_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "ad_name_after": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "ad_name_before": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "ad_status": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "adset_count": {
+            "type": "integer"
+          },
+          "adset_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "adset_status": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "bid": {
+            "properties": {
+              "amount": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "currency": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "daily_budget": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "level": {
+                "type": "string"
+              },
+              "mode": {
+                "type": "string"
+              },
+              "total_daily_budget": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "unit": {
+                "type": "string"
+              }
+            },
+            "type": [
+              "null",
+              "object"
+            ]
+          },
+          "budget": {
+            "properties": {
+              "amount": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "currency": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "daily_budget": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "level": {
+                "type": "string"
+              },
+              "mode": {
+                "type": "string"
+              },
+              "total_daily_budget": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "unit": {
+                "type": "string"
+              }
+            },
+            "type": [
+              "null",
+              "object"
+            ]
+          },
+          "campaign_count": {
+            "type": "integer"
+          },
+          "campaign_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "campaign_status": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "change_percent": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "copies": {
+            "type": "integer"
+          },
+          "count": {
+            "type": "integer"
+          },
+          "creative_after": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "creative_before": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "cross_account": {
+            "type": "boolean"
+          },
+          "current_daily_budget": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "engagement_mode": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "entity_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "entity_type": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "groups": {
+            "items": {
+              "properties": {
+                "adsets": {
+                  "items": {
+                    "properties": {
+                      "name": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      },
+                      "target_adset_id": {
+                        "type": [
+                          "string",
+                          "null"
+                        ]
+                      }
+                    },
+                    "type": "object"
+                  },
+                  "type": "array"
+                },
+                "bid": {
+                  "properties": {
+                    "amount": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "currency": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "daily_budget": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "level": {
+                      "type": "string"
+                    },
+                    "mode": {
+                      "type": "string"
+                    },
+                    "total_daily_budget": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "unit": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "budget": {
+                  "properties": {
+                    "amount": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "currency": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "daily_budget": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "level": {
+                      "type": "string"
+                    },
+                    "mode": {
+                      "type": "string"
+                    },
+                    "total_daily_budget": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "unit": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                },
+                "campaign_name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "layout": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "items": {
+            "items": {
+              "properties": {
+                "ad_account_id": {
+                  "type": "string"
+                },
+                "ad_id": {
+                  "type": "string"
+                },
+                "campaign_id": {
+                  "type": "string"
+                },
+                "current_configured_status": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "current_daily_budget": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "new_daily_budget": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "target_configured_status": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "mode": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "new_daily_budget": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "note": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "page_id_after": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "page_id_before": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "publish_start_label": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_ad_account_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_ad_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_level": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "statuses": {
+            "properties": {
+              "ad": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "adset": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "campaign": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          "structure": {
+            "properties": {
+              "ads": {
+                "type": "integer"
+              },
+              "adsets": {
+                "type": "integer"
+              },
+              "auxiliary_writes": {
+                "type": "integer"
+              },
+              "campaigns": {
+                "type": "integer"
+              },
+              "creative_keys": {
+                "type": "integer"
+              },
+              "layouts": {
+                "items": {
+                  "type": "string"
+                },
+                "type": "array"
+              }
+            },
+            "type": "object"
+          },
+          "target_ad_account_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "template_name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "warnings": {
+            "items": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "anyOf": [
+                    {
+                      "properties": {
+                        "code": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "code"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "message"
+                      ]
+                    }
+                  ],
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              ]
+            },
+            "type": "array"
+          }
+        },
+        "type": "object"
+      },
+      "tool_name": {
+        "type": "string"
+      },
+      "user_instruction": {
+        "type": "string"
+      },
+      "warnings": {
+        "items": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "anyOf": [
+                {
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "code"
+                  ]
+                },
+                {
+                  "required": [
+                    "message"
+                  ]
+                }
+              ],
+              "properties": {
+                "message": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            }
+          ]
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "status",
+      "confirm_token",
+      "expires_at",
+      "summary"
+    ],
+    "type": "object"
+  },
+  "status": {
+    "type": "string"
+  },
+  "summary": {
+    "properties": {
+      "account_currency": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "action": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "ad_account_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "ad_count": {
+        "type": "integer"
+      },
+      "ad_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "ad_name_after": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "ad_name_before": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "ad_status": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "adset_count": {
+        "type": "integer"
+      },
+      "adset_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "adset_status": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "bid": {
+        "properties": {
+          "amount": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "currency": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "daily_budget": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "level": {
+            "type": "string"
+          },
+          "mode": {
+            "type": "string"
+          },
+          "total_daily_budget": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "unit": {
+            "type": "string"
+          }
+        },
+        "type": [
+          "null",
+          "object"
+        ]
+      },
+      "budget": {
+        "properties": {
+          "amount": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "currency": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "daily_budget": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "level": {
+            "type": "string"
+          },
+          "mode": {
+            "type": "string"
+          },
+          "total_daily_budget": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "unit": {
+            "type": "string"
+          }
+        },
+        "type": [
+          "null",
+          "object"
+        ]
+      },
+      "campaign_count": {
+        "type": "integer"
+      },
+      "campaign_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "campaign_status": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "change_percent": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "copies": {
+        "type": "integer"
+      },
+      "count": {
+        "type": "integer"
+      },
+      "creative_after": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "creative_before": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "cross_account": {
+        "type": "boolean"
+      },
+      "current_daily_budget": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "engagement_mode": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "entity_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "entity_type": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "groups": {
+        "items": {
+          "properties": {
+            "adsets": {
+              "items": {
+                "properties": {
+                  "name": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  },
+                  "target_adset_id": {
+                    "type": [
+                      "string",
+                      "null"
+                    ]
+                  }
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "bid": {
+              "properties": {
+                "amount": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "currency": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "daily_budget": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "level": {
+                  "type": "string"
+                },
+                "mode": {
+                  "type": "string"
+                },
+                "total_daily_budget": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "unit": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "budget": {
+              "properties": {
+                "amount": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "currency": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "daily_budget": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "level": {
+                  "type": "string"
+                },
+                "mode": {
+                  "type": "string"
+                },
+                "total_daily_budget": {
+                  "type": [
+                    "number",
+                    "null"
+                  ]
+                },
+                "unit": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "campaign_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "layout": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "items": {
+        "items": {
+          "properties": {
+            "ad_account_id": {
+              "type": "string"
+            },
+            "ad_id": {
+              "type": "string"
+            },
+            "campaign_id": {
+              "type": "string"
+            },
+            "current_configured_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "current_daily_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "new_daily_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "target_configured_status": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "mode": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "new_daily_budget": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "note": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "page_id_after": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "page_id_before": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "publish_start_label": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "source_ad_account_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "source_ad_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "source_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "source_level": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "source_name": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "statuses": {
+        "properties": {
+          "ad": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "adset": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "campaign": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      },
+      "structure": {
+        "properties": {
+          "ads": {
+            "type": "integer"
+          },
+          "adsets": {
+            "type": "integer"
+          },
+          "auxiliary_writes": {
+            "type": "integer"
+          },
+          "campaigns": {
+            "type": "integer"
+          },
+          "creative_keys": {
+            "type": "integer"
+          },
+          "layouts": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          }
+        },
+        "type": "object"
+      },
+      "target_ad_account_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "template_name": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "warnings": {
+        "items": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "anyOf": [
+                {
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "code"
+                  ]
+                },
+                {
+                  "required": [
+                    "message"
+                  ]
+                }
+              ],
+              "properties": {
+                "message": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            }
+          ]
+        },
+        "type": "array"
+      }
+    },
+    "type": "object"
+  }
+}

Changed1 schema field changedOct 18, 2026

changedOutput schema / else / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "approval_request": {
-        "properties": {
-          "approval_ref": {
-            "type": "string"
-          },
-          "confirm_token": {
-            "type": "string"
-          },
-          "expires_at": {
-            "type": "string"
-          },
-          "mode": {
-            "type": "string"
-          },
-          "plan_digest": {
-            "type": "string"
-          },
-          "schema_version": {
-            "type": "integer"
-          },
-          "status": {
-            "const": "approval_required"
-          },
-          "summary": {
-            "$ref": "#/$defs/s0"
-          },
-          "tool_name": {
-            "type": "string"
-          },
-          "user_instruction": {
-            "type": "string"
-          },
-          "warnings": {
-            "items": {
-              "anyOf": [
-                {
-                  "type": "string"
-                },
-                {
-                  "anyOf": [
-                    {
-                      "properties": {
-                        "code": {
-                          "type": "string"
-                        }
-                      },
-                      "required": [
-                        "code"
-                      ]
-                    },
-                    {
-                      "required": [
-                        "message"
-                      ]
-                    }
-                  ],
-                  "properties": {
-                    "message": {
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                }
-              ]
-            },
-            "type": "array"
-          }
-        },
-        "required": [
-          "status",
-          "confirm_token",
-          "expires_at",
-          "summary"
-        ],
-        "type": "object"
-      },
-      "status": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "approval_request"
-    ]
-  },
-  {
-    "properties": {
-      "ad_account_id": {
-        "type": "string"
-      },
-      "ad_id": {
-        "type": "string"
-      },
-      "status": {
-        "const": "unchanged"
-      },
-      "summary": {
-        "$ref": "#/$defs/s0"
-      }
-    },
-    "required": [
-      "status",
-      "ad_account_id",
-      "ad_id",
-      "summary"
-    ]
-  }
-]New value: +[
+  {
+    "properties": {
+      "approval_request": {
+        "properties": {
+          "approval_ref": {
+            "type": "string"
+          },
+          "confirm_token": {
+            "type": "string"
+          },
+          "confirm_tool": {
+            "type": "string"
+          },
+          "expires_at": {
+            "type": "string"
+          },
+          "instruction_template_id": {
+            "type": "string"
+          },
+          "mode": {
+            "type": "string"
+          },
+          "plan_digest": {
+            "type": "string"
+          },
+          "schema_version": {
+            "type": "integer"
+          },
+          "status": {
+            "const": "approval_required"
+          },
+          "summary": {
+            "$ref": "#/$defs/s0"
+          },
+          "tool_name": {
+            "type": "string"
+          },
+          "user_instruction": {
+            "type": "string"
+          },
+          "warnings": {
+            "items": {
+              "anyOf": [
+                {
+                  "type": "string"
+                },
+                {
+                  "anyOf": [
+                    {
+                      "properties": {
+                        "code": {
+                          "type": "string"
+                        }
+                      },
+                      "required": [
+                        "code"
+                      ]
+                    },
+                    {
+                      "required": [
+                        "message"
+                      ]
+                    }
+                  ],
+                  "properties": {
+                    "message": {
+                      "type": "string"
+                    }
+                  },
+                  "type": "object"
+                }
+              ]
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "status",
+          "confirm_token",
+          "expires_at",
+          "summary"
+        ],
+        "type": "object"
+      },
+      "status": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "approval_request"
+    ]
+  },
+  {
+    "properties": {
+      "ad_account_id": {
+        "type": "string"
+      },
+      "ad_id": {
+        "type": "string"
+      },
+      "status": {
+        "const": "unchanged"
+      },
+      "summary": {
+        "$ref": "#/$defs/s0"
+      }
+    },
+    "required": [
+      "status",
+      "ad_account_id",
+      "ad_id",
+      "summary"
+    ]
+  }
+]

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"
+}
```
AddedSep 17, 2026

TDQS

B3.4/5.0

Behavior3/5

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

Annotations already declare the tool is non-readonly, non-destructive, and closed-world. The description adds useful scope information: edits are limited to body/title/description and media/Page are preserved. But it omits the critical behavioral detail that this is a prepare step that requires a separate confirm action before changes take effect, and it doesn't say whether the edit is staged or immediately applied.

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 a single front-loaded sentence with no wasted words. It is appropriately compact, though the terse phrasing makes the staged prepare/confirm workflow slightly opaque.

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

Completeness3/5

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

An output schema exists, so return values need not be explained. Annotations cover the safety profile. But for a prepare-step tool in a larger confirm/deny workflow, the description should explicitly connect to ads_update_copy_confirm/deny and explain that no changes occur until confirmation. It also leaves the required ad_account_id undocumented.

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

Parameters3/5

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

Schema description coverage is 0%, so the description must compensate. It names four of the five parameters (body, title, description, ad_id) and clarifies they apply to a single Ad, which is helpful. However, it completely omits ad_account_id, a required parameter, and provides no format or constraint details for any field.

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

Purpose4/5

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

The description states a specific action (prepare edits) and the exact fields affected (body/title/description) on a specific resource (Ad ID). It also implicitly distinguishes itself from the media- and Page-replacement prepare siblings by saying media and Page are preserved. It falls short of 5 because 'prepare' alone doesn't fully explain the staged nature of the operation.

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

Usage Guidelines3/5

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

The phrase 'preserving media and Page' implies this is the right tool when only copy fields change, and conversely not the right tool when creative or Page must change. However, it never explicitly names the alternative tools (ads_replace_creative_prepare, ads_replace_page_prepare) or states that confirm/deny steps follow. Usage is implied rather than stated.

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?