AdsAgent — Meta Ads MCP

entities_prepare_update

Prepare one AdsAgent approval to change status, budget, bid, targeting or other fields of 1-10 campaigns, ad sets or ads

Tool call template

Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {
      "level": "<level>",
      "ids": "<ids>",
      "ad_account_id": "<ad_account_id>",
      "changes": "<changes>"
    },
    "name": "entities_prepare_update"
  }
}

Input Schema

Name	Required	Description
`ids`	Yes	Numeric ids of the entities to change; all must be of the given level and ad account.
`level`	Yes
`changes`	Yes	Field -> new value, applied to every id. Common fields: status (ACTIVE\|PAUSED), name, daily_budget, lifetime_budget (account-currency major units; lifetime needs end_time), bid_amount, bid_strategy, roas_average_floor (2.0 = 2x), cost_cap, spend_cap (null removes), start_time, end_time (ISO-8601 with timezone), and for ad sets targeting (countries, age_min, age_max, genders, interests, placements, advantage_audience) and frequency_control {max_frequency, interval_days}. Creative fields are not supported here; invalid or unchangeable fields return needs_input.
`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": {
-      "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"
-    ]
-  },
-  "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": "object"
-  },
-  "s5": {
-    "items": {
-      "properties": {
-        "disposition": {
-          "enum": [
-            "accepted",
-            "excluded"
-          ]
-        },
-        "index": {
-          "type": "integer"
-        },
-        "operation": {
-          "type": "string"
-        },
-        "reason": {
-          "type": "string"
-        },
-        "reason_code": {
-          "type": "string"
-        },
-        "suggested": {
-          "items": {
-            "properties": {
-              "field": {
-                "type": "string"
-              },
-              "reason_code": {
-                "type": "string"
-              },
-              "value": {}
-            },
-            "type": "object"
-          },
-          "type": "array"
-        },
-        "summary": {
-          "type": "object"
-        }
-      },
-      "required": [
-        "index",
-        "operation",
-        "summary",
-        "disposition"
-      ],
-      "type": "object"
-    },
-    "type": "array"
-  }
-}

changedOutput schema / else / else / anyOf

Previous value: -[
-  {
-    "anyOf": [
-      {
-        "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": {
-                "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/s0"
-                  },
-                  "budget": {
-                    "$ref": "#/$defs/s0"
-                  },
-                  "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/s1"
-                        },
-                        "budget": {
-                          "$ref": "#/$defs/s1"
-                        },
-                        "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"
-          }
-        },
-        "required": [
-          "approval_request"
-        ]
-      },
-      {
-        "properties": {
-          "missing_requirements": {
-            "items": {
-              "properties": {
-                "code": {
-                  "type": "string"
-                },
-                "entity_id": {
-                  "type": "string"
-                },
-                "field": {
-                  "type": "string"
-                },
-                "message": {
-                  "type": "string"
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "safe_to_retry_with_user_input": {
-            "const": true
-          },
-          "status": {
-            "const": "needs_input"
-          },
-          "user_instruction": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "status",
-          "user_instruction",
-          "safe_to_retry_with_user_input",
-          "missing_requirements"
-        ]
-      }
-    ]
-  },
-  {
-    "properties": {
-      "approval_request": {
-        "properties": {
-          "accepted": {
-            "$ref": "#/$defs/s5"
-          },
-          "approval_ref": {
-            "type": "string"
-          },
-          "confirm_tool": {
-            "type": "string"
-          },
-          "excluded": {
-            "$ref": "#/$defs/s5"
-          },
-          "expected_changes": {
-            "$ref": "#/$defs/s5"
-          },
-          "expires_at": {
-            "type": "string"
-          },
-          "instruction_template_id": {
-            "type": "string"
-          },
-          "items": {
-            "items": {
-              "properties": {
-                "disposition": {
-                  "enum": [
-                    "accepted",
-                    "excluded"
-                  ]
-                },
-                "index": {
-                  "type": "integer"
-                },
-                "operation": {
-                  "type": "string"
-                },
-                "reason": {
-                  "type": "string"
-                },
-                "reason_code": {
-                  "type": "string"
-                },
-                "receipt": {
-                  "type": "object"
-                },
-                "state": {
-                  "type": "string"
-                },
-                "suggested": {
-                  "items": {
-                    "properties": {
-                      "field": {
-                        "type": "string"
-                      },
-                      "reason_code": {
-                        "type": "string"
-                      },
-                      "value": {}
-                    },
-                    "type": "object"
-                  },
-                  "type": "array"
-                },
-                "summary": {
-                  "type": "object"
-                }
-              },
-              "required": [
-                "index",
-                "state",
-                "receipt"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "plan_digest": {
-            "type": "string"
-          },
-          "presentation": {
-            "type": "string"
-          },
-          "state": {
-            "type": "string"
-          },
-          "status": {
-            "type": "string"
-          }
-        },
-        "required": [
-          "state",
-          "confirm_tool",
-          "expected_changes",
-          "accepted",
-          "excluded",
-          "items"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "approval_request"
-    ]
-  },
-  {
-    "properties": {
-      "accepted": {
-        "$ref": "#/$defs/s5"
-      },
-      "approval_ref": {
-        "type": "string"
-      },
-      "confirm_tool": {
-        "type": "string"
-      },
-      "excluded": {
-        "$ref": "#/$defs/s5"
-      },
-      "expected_changes": {
-        "$ref": "#/$defs/s5"
-      },
-      "expires_at": {
-        "type": "string"
-      },
-      "instruction_template_id": {
-        "type": "string"
-      },
-      "items": {
-        "items": {
-          "properties": {
-            "disposition": {
-              "enum": [
-                "accepted",
-                "excluded"
-              ]
-            },
-            "index": {
-              "type": "integer"
-            },
-            "operation": {
-              "type": "string"
-            },
-            "reason": {
-              "type": "string"
-            },
-            "reason_code": {
-              "type": "string"
-            },
-            "receipt": {
-              "type": "object"
-            },
-            "state": {
-              "type": "string"
-            },
-            "suggested": {
-              "items": {
-                "properties": {
-                  "field": {
-                    "type": "string"
-                  },
-                  "reason_code": {
-                    "type": "string"
-                  },
-                  "value": {}
-                },
-                "type": "object"
-              },
-              "type": "array"
-            },
-            "summary": {
-              "type": "object"
-            }
-          },
-          "required": [
-            "index",
-            "state",
-            "receipt"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "plan_digest": {
-        "type": "string"
-      },
-      "presentation": {
-        "type": "string"
-      },
-      "state": {
-        "type": "string"
-      },
-      "status": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "state",
-      "confirm_tool",
-      "expected_changes",
-      "accepted",
-      "excluded",
-      "items"
-    ]
-  }
-]New value: +[
+  {
+    "required": [
+      "approval_request"
+    ]
+  },
+  {
+    "properties": {
+      "safe_to_retry_with_user_input": {
+        "const": true
+      },
+      "status": {
+        "const": "needs_input"
+      }
+    },
+    "required": [
+      "missing_requirements",
+      "safe_to_retry_with_user_input",
+      "status",
+      "user_instruction"
+    ]
+  },
+  {
+    "required": [
+      "accepted",
+      "confirm_tool",
+      "excluded",
+      "expected_changes",
+      "items",
+      "state"
+    ]
+  }
+]

addedOutput schema / else / else / properties

Added value: +{
+  "accepted": {
+    "items": {
+      "properties": {
+        "disposition": {
+          "enum": [
+            "accepted",
+            "excluded"
+          ]
+        },
+        "index": {
+          "type": "integer"
+        },
+        "operation": {
+          "type": "string"
+        },
+        "reason": {
+          "type": "string"
+        },
+        "reason_code": {
+          "type": "string"
+        },
+        "suggested": {
+          "items": {
+            "properties": {
+              "field": {
+                "type": "string"
+              },
+              "reason_code": {
+                "type": "string"
+              },
+              "value": {}
+            },
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "summary": {
+          "type": "object"
+        }
+      },
+      "required": [
+        "index",
+        "operation",
+        "summary",
+        "disposition"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "approval_ref": {
+    "type": "string"
+  },
+  "approval_request": {
+    "anyOf": [
+      {
+        "properties": {
+          "status": {
+            "const": "approval_required"
+          }
+        },
+        "required": [
+          "confirm_token",
+          "expires_at",
+          "status",
+          "summary"
+        ]
+      },
+      {
+        "required": [
+          "accepted",
+          "confirm_tool",
+          "excluded",
+          "expected_changes",
+          "items",
+          "state"
+        ]
+      }
+    ],
+    "properties": {
+      "accepted": {
+        "items": {
+          "properties": {
+            "disposition": {
+              "enum": [
+                "accepted",
+                "excluded"
+              ]
+            },
+            "index": {
+              "type": "integer"
+            },
+            "operation": {
+              "type": "string"
+            },
+            "reason": {
+              "type": "string"
+            },
+            "reason_code": {
+              "type": "string"
+            },
+            "suggested": {
+              "items": {
+                "properties": {
+                  "field": {
+                    "type": "string"
+                  },
+                  "reason_code": {
+                    "type": "string"
+                  },
+                  "value": {}
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "summary": {
+              "type": "object"
+            }
+          },
+          "required": [
+            "index",
+            "operation",
+            "summary",
+            "disposition"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "approval_ref": {
+        "type": "string"
+      },
+      "confirm_token": {
+        "type": "string"
+      },
+      "confirm_tool": {
+        "type": "string"
+      },
+      "excluded": {
+        "items": {
+          "properties": {
+            "disposition": {
+              "enum": [
+                "accepted",
+                "excluded"
+              ]
+            },
+            "index": {
+              "type": "integer"
+            },
+            "operation": {
+              "type": "string"
+            },
+            "reason": {
+              "type": "string"
+            },
+            "reason_code": {
+              "type": "string"
+            },
+            "suggested": {
+              "items": {
+                "properties": {
+                  "field": {
+                    "type": "string"
+                  },
+                  "reason_code": {
+                    "type": "string"
+                  },
+                  "value": {}
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "summary": {
+              "type": "object"
+            }
+          },
+          "required": [
+            "index",
+            "operation",
+            "summary",
+            "disposition"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "expected_changes": {
+        "items": {
+          "properties": {
+            "disposition": {
+              "enum": [
+                "accepted",
+                "excluded"
+              ]
+            },
+            "index": {
+              "type": "integer"
+            },
+            "operation": {
+              "type": "string"
+            },
+            "reason": {
+              "type": "string"
+            },
+            "reason_code": {
+              "type": "string"
+            },
+            "suggested": {
+              "items": {
+                "properties": {
+                  "field": {
+                    "type": "string"
+                  },
+                  "reason_code": {
+                    "type": "string"
+                  },
+                  "value": {}
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "summary": {
+              "type": "object"
+            }
+          },
+          "required": [
+            "index",
+            "operation",
+            "summary",
+            "disposition"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "expires_at": {
+        "type": "string"
+      },
+      "instruction_template_id": {
+        "type": "string"
+      },
+      "items": {
+        "items": {
+          "properties": {
+            "disposition": {
+              "enum": [
+                "accepted",
+                "excluded"
+              ]
+            },
+            "index": {
+              "type": "integer"
+            },
+            "operation": {
+              "type": "string"
+            },
+            "reason": {
+              "type": "string"
+            },
+            "reason_code": {
+              "type": "string"
+            },
+            "receipt": {
+              "type": "object"
+            },
+            "state": {
+              "type": "string"
+            },
+            "suggested": {
+              "items": {
+                "properties": {
+                  "field": {
+                    "type": "string"
+                  },
+                  "reason_code": {
+                    "type": "string"
+                  },
+                  "value": {}
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "summary": {
+              "type": "object"
+            }
+          },
+          "required": [
+            "index",
+            "state",
+            "receipt"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "mode": {
+        "type": "string"
+      },
+      "plan_digest": {
+        "type": "string"
+      },
+      "presentation": {
+        "type": "string"
+      },
+      "schema_version": {
+        "type": "integer"
+      },
+      "state": {
+        "type": "string"
+      },
+      "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"
+      },
+      "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"
+      }
+    },
+    "type": "object"
+  },
+  "confirm_tool": {
+    "type": "string"
+  },
+  "excluded": {
+    "items": {
+      "properties": {
+        "disposition": {
+          "enum": [
+            "accepted",
+            "excluded"
+          ]
+        },
+        "index": {
+          "type": "integer"
+        },
+        "operation": {
+          "type": "string"
+        },
+        "reason": {
+          "type": "string"
+        },
+        "reason_code": {
+          "type": "string"
+        },
+        "suggested": {
+          "items": {
+            "properties": {
+              "field": {
+                "type": "string"
+              },
+              "reason_code": {
+                "type": "string"
+              },
+              "value": {}
+            },
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "summary": {
+          "type": "object"
+        }
+      },
+      "required": [
+        "index",
+        "operation",
+        "summary",
+        "disposition"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "expected_changes": {
+    "items": {
+      "properties": {
+        "disposition": {
+          "enum": [
+            "accepted",
+            "excluded"
+          ]
+        },
+        "index": {
+          "type": "integer"
+        },
+        "operation": {
+          "type": "string"
+        },
+        "reason": {
+          "type": "string"
+        },
+        "reason_code": {
+          "type": "string"
+        },
+        "suggested": {
+          "items": {
+            "properties": {
+              "field": {
+                "type": "string"
+              },
+              "reason_code": {
+                "type": "string"
+              },
+              "value": {}
+            },
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "summary": {
+          "type": "object"
+        }
+      },
+      "required": [
+        "index",
+        "operation",
+        "summary",
+        "disposition"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "expires_at": {
+    "type": "string"
+  },
+  "instruction_template_id": {
+    "type": "string"
+  },
+  "items": {
+    "items": {
+      "properties": {
+        "disposition": {
+          "enum": [
+            "accepted",
+            "excluded"
+          ]
+        },
+        "index": {
+          "type": "integer"
+        },
+        "operation": {
+          "type": "string"
+        },
+        "reason": {
+          "type": "string"
+        },
+        "reason_code": {
+          "type": "string"
+        },
+        "receipt": {
+          "type": "object"
+        },
+        "state": {
+          "type": "string"
+        },
+        "suggested": {
+          "items": {
+            "properties": {
+              "field": {
+                "type": "string"
+              },
+              "reason_code": {
+                "type": "string"
+              },
+              "value": {}
+            },
+            "type": "object"
+          },
+          "type": "array"
+        },
+        "summary": {
+          "type": "object"
+        }
+      },
+      "required": [
+        "index",
+        "state",
+        "receipt"
+      ],
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "missing_requirements": {
+    "items": {
+      "properties": {
+        "code": {
+          "type": "string"
+        },
+        "entity_id": {
+          "type": "string"
+        },
+        "field": {
+          "type": "string"
+        },
+        "message": {
+          "type": "string"
+        }
+      },
+      "type": "object"
+    },
+    "type": "array"
+  },
+  "plan_digest": {
+    "type": "string"
+  },
+  "presentation": {
+    "type": "string"
+  },
+  "safe_to_retry_with_user_input": {
+    "const": true
+  },
+  "state": {
+    "type": "string"
+  },
+  "status": {
+    "type": "string"
+  },
+  "user_instruction": {
+    "type": "string"
+  }
+}

Changed2 schema fields changedOct 18, 2026

addedOutput schema / $defs / s5

Added value: +{
+  "items": {
+    "properties": {
+      "disposition": {
+        "enum": [
+          "accepted",
+          "excluded"
+        ]
+      },
+      "index": {
+        "type": "integer"
+      },
+      "operation": {
+        "type": "string"
+      },
+      "reason": {
+        "type": "string"
+      },
+      "reason_code": {
+        "type": "string"
+      },
+      "suggested": {
+        "items": {
+          "properties": {
+            "field": {
+              "type": "string"
+            },
+            "reason_code": {
+              "type": "string"
+            },
+            "value": {}
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "summary": {
+        "type": "object"
+      }
+    },
+    "required": [
+      "index",
+      "operation",
+      "summary",
+      "disposition"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

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": {
-            "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/s0"
-              },
-              "budget": {
-                "$ref": "#/$defs/s0"
-              },
-              "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/s1"
-                    },
-                    "budget": {
-                      "$ref": "#/$defs/s1"
-                    },
-                    "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"
-      }
-    },
-    "required": [
-      "approval_request"
-    ]
-  },
-  {
-    "properties": {
-      "missing_requirements": {
-        "items": {
-          "properties": {
-            "code": {
-              "type": "string"
-            },
-            "entity_id": {
-              "type": "string"
-            },
-            "field": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "safe_to_retry_with_user_input": {
-        "const": true
-      },
-      "status": {
-        "const": "needs_input"
-      },
-      "user_instruction": {
-        "type": "string"
-      }
-    },
-    "required": [
-      "status",
-      "user_instruction",
-      "safe_to_retry_with_user_input",
-      "missing_requirements"
-    ]
-  }
-]New value: +[
+  {
+    "anyOf": [
+      {
+        "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": {
+                "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/s0"
+                  },
+                  "budget": {
+                    "$ref": "#/$defs/s0"
+                  },
+                  "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/s1"
+                        },
+                        "budget": {
+                          "$ref": "#/$defs/s1"
+                        },
+                        "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"
+          }
+        },
+        "required": [
+          "approval_request"
+        ]
+      },
+      {
+        "properties": {
+          "missing_requirements": {
+            "items": {
+              "properties": {
+                "code": {
+                  "type": "string"
+                },
+                "entity_id": {
+                  "type": "string"
+                },
+                "field": {
+                  "type": "string"
+                },
+                "message": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "safe_to_retry_with_user_input": {
+            "const": true
+          },
+          "status": {
+            "const": "needs_input"
+          },
+          "user_instruction": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "status",
+          "user_instruction",
+          "safe_to_retry_with_user_input",
+          "missing_requirements"
+        ]
+      }
+    ]
+  },
+  {
+    "properties": {
+      "approval_request": {
+        "properties": {
+          "accepted": {
+            "$ref": "#/$defs/s5"
+          },
+          "approval_ref": {
+            "type": "string"
+          },
+          "confirm_tool": {
+            "type": "string"
+          },
+          "excluded": {
+            "$ref": "#/$defs/s5"
+          },
+          "expected_changes": {
+            "$ref": "#/$defs/s5"
+          },
+          "expires_at": {
+            "type": "string"
+          },
+          "instruction_template_id": {
+            "type": "string"
+          },
+          "items": {
+            "items": {
+              "properties": {
+                "disposition": {
+                  "enum": [
+                    "accepted",
+                    "excluded"
+                  ]
+                },
+                "index": {
+                  "type": "integer"
+                },
+                "operation": {
+                  "type": "string"
+                },
+                "reason": {
+                  "type": "string"
+                },
+                "reason_code": {
+                  "type": "string"
+                },
+                "receipt": {
+                  "type": "object"
+                },
+                "state": {
+                  "type": "string"
+                },
+                "suggested": {
+                  "items": {
+                    "properties": {
+                      "field": {
+                        "type": "string"
+                      },
+                      "reason_code": {
+                        "type": "string"
+                      },
+                      "value": {}
+                    },
+                    "type": "object"
+                  },
+                  "type": "array"
+                },
+                "summary": {
+                  "type": "object"
+                }
+              },
+              "required": [
+                "index",
+                "state",
+                "receipt"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "plan_digest": {
+            "type": "string"
+          },
+          "presentation": {
+            "type": "string"
+          },
+          "state": {
+            "type": "string"
+          },
+          "status": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "state",
+          "confirm_tool",
+          "expected_changes",
+          "accepted",
+          "excluded",
+          "items"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "approval_request"
+    ]
+  },
+  {
+    "properties": {
+      "accepted": {
+        "$ref": "#/$defs/s5"
+      },
+      "approval_ref": {
+        "type": "string"
+      },
+      "confirm_tool": {
+        "type": "string"
+      },
+      "excluded": {
+        "$ref": "#/$defs/s5"
+      },
+      "expected_changes": {
+        "$ref": "#/$defs/s5"
+      },
+      "expires_at": {
+        "type": "string"
+      },
+      "instruction_template_id": {
+        "type": "string"
+      },
+      "items": {
+        "items": {
+          "properties": {
+            "disposition": {
+              "enum": [
+                "accepted",
+                "excluded"
+              ]
+            },
+            "index": {
+              "type": "integer"
+            },
+            "operation": {
+              "type": "string"
+            },
+            "reason": {
+              "type": "string"
+            },
+            "reason_code": {
+              "type": "string"
+            },
+            "receipt": {
+              "type": "object"
+            },
+            "state": {
+              "type": "string"
+            },
+            "suggested": {
+              "items": {
+                "properties": {
+                  "field": {
+                    "type": "string"
+                  },
+                  "reason_code": {
+                    "type": "string"
+                  },
+                  "value": {}
+                },
+                "type": "object"
+              },
+              "type": "array"
+            },
+            "summary": {
+              "type": "object"
+            }
+          },
+          "required": [
+            "index",
+            "state",
+            "receipt"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "plan_digest": {
+        "type": "string"
+      },
+      "presentation": {
+        "type": "string"
+      },
+      "state": {
+        "type": "string"
+      },
+      "status": {
+        "type": "string"
+      }
+    },
+    "required": [
+      "state",
+      "confirm_tool",
+      "expected_changes",
+      "accepted",
+      "excluded",
+      "items"
+    ]
+  }
+]

AddedOct 17, 2026

TDQS

A3.6/5.0

Behavior3/5

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

Annotations already declare readOnlyHint=false, destructiveHint=false and openWorldHint=false, so the agent knows this is a bounded, non-destructive write. The description usefully signals that this only *prepares* an approval rather than applying changes, and that creative fields are excluded. However, it omits what happens after preparation (which confirm tool completes it, that approval is queued), the fact noted only in the schema that invalid fields return needs_input.

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?

A single front-loaded sentence with zero filler; the core scope (approval-staging, 1-10 entities, field families) is stated immediately. It is arguably too terse for a batch mutation tool, but nothing is wasted.

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?

An output schema exists, so return values need no explanation, and the description plus annotations cover scope and safety for a 4-param staged change. What is missing is the approval lifecycle context (that this must be paired with operations_confirm_entity_update / deny), which matters for an agent orchestrating a two-step flow.

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 50%, and the description partially compensates by naming the changeable fields (status, budget, bid, targeting) and the entity levels. The heavy lifting is in the rich 'changes' schema description (units, enums, targeting sub-keys), and ad_account_id remains undocumented in both, so it does not fully close the gap.

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?

Specific verb+resource: it states that this stages an AdsAgent approval to change status/budget/bid/targeting on 1-10 campaigns, ad sets or ads. That is clear enough to distinguish it from read or confirm tools, but it never differentiates itself from the many single-field prepare siblings (campaigns_prepare_status_change, adsets_prepare_budget_change, etc.).

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 '1-10 campaigns, ad sets or ads' and 'or other fields' wording implies this is the general/multi-field, multi-entity path versus the narrow per-field siblings, but that routing is left to inference. There is no explicit when-to-use or when-not statement and no mention of the required follow-up confirm step.

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?