AdsAgent — Meta Ads MCP

overview_update_deny

Destructive

Discard a prepared status, campaign/ad-set budget or bid update with its exact bu_confirm_* or mu_confirm_* token. No Meta write. Use launch_deny for creation/copy drafts and products_delivery_pause_deny for product-family pauses

Tool call template

This tool declares no required parameters. Add optional parameters from the input schema as needed.

{
  "id": 1,
  "jsonrpc": "2.0",
  "method": "tools/call",
  "params": {
    "arguments": {},
    "name": "overview_update_deny"
  }
}

Input Schema

Name	Required	Description	Default
`approval_ref`	No
`confirm_token`	No
`expected_plan_digest`	No

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: -[
-  {
-    "properties": {
-      "action": {
-        "type": "string"
-      },
-      "note": {
-        "type": "string"
-      },
-      "status": {
-        "const": "denied"
-      },
-      "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"
-      },
-      "warnings": {
-        "items": {
-          "anyOf": [
-            {
-              "type": "string"
-            },
-            {
-              "anyOf": [
-                {
-                  "properties": {
-                    "code": {
-                      "type": "string"
-                    }
-                  },
-                  "required": [
-                    "code"
-                  ]
-                },
-                {
-                  "required": [
-                    "message"
-                  ]
-                }
-              ],
-              "properties": {
-                "message": {
-                  "type": "string"
-                }
-              },
-              "type": "object"
-            }
-          ]
-        },
-        "type": "array"
-      }
-    },
-    "required": [
-      "status"
-    ]
-  },
-  {
-    "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: +[
+  {
+    "properties": {
+      "status": {
+        "const": "denied"
+      }
+    },
+    "required": [
+      "status"
+    ]
+  },
+  {
+    "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"
+  },
+  "action": {
+    "type": "string"
+  },
+  "approval_ref": {
+    "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"
+  },
+  "note": {
+    "type": "string"
+  },
+  "plan_digest": {
+    "type": "string"
+  },
+  "presentation": {
+    "type": "string"
+  },
+  "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"
+  },
+  "warnings": {
+    "items": {
+      "anyOf": [
+        {
+          "type": "string"
+        },
+        {
+          "anyOf": [
+            {
+              "properties": {
+                "code": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "code"
+              ]
+            },
+            {
+              "required": [
+                "message"
+              ]
+            }
+          ],
+          "properties": {
+            "message": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        }
+      ]
+    },
+    "type": "array"
+  }
+}

Changed7 schema fields changedOct 18, 2026

addedInput schema / properties / approval_ref
```
Added value: +{
+  "type": "string"
+}
```
addedInput schema / properties / expected_plan_digest
```
Added value: +{
+  "type": "string"
+}
```
removedInput schema / required
```
Removed value: -[
-  "confirm_token"
-]
```

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

addedOutput schema / else / else / anyOf

Added value: +[
+  {
+    "properties": {
+      "action": {
+        "type": "string"
+      },
+      "note": {
+        "type": "string"
+      },
+      "status": {
+        "const": "denied"
+      },
+      "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"
+      },
+      "warnings": {
+        "items": {
+          "anyOf": [
+            {
+              "type": "string"
+            },
+            {
+              "anyOf": [
+                {
+                  "properties": {
+                    "code": {
+                      "type": "string"
+                    }
+                  },
+                  "required": [
+                    "code"
+                  ]
+                },
+                {
+                  "required": [
+                    "message"
+                  ]
+                }
+              ],
+              "properties": {
+                "message": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            }
+          ]
+        },
+        "type": "array"
+      }
+    },
+    "required": [
+      "status"
+    ]
+  },
+  {
+    "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"
+    ]
+  }
+]

removedOutput schema / else / else / properties

Removed value: -{
-  "action": {
-    "type": "string"
-  },
-  "note": {
-    "type": "string"
-  },
-  "status": {
-    "const": "denied"
-  },
-  "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"
-  },
-  "warnings": {
-    "items": {
-      "anyOf": [
-        {
-          "type": "string"
-        },
-        {
-          "anyOf": [
-            {
-              "properties": {
-                "code": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "code"
-              ]
-            },
-            {
-              "required": [
-                "message"
-              ]
-            }
-          ],
-          "properties": {
-            "message": {
-              "type": "string"
-            }
-          },
-          "type": "object"
-        }
-      ]
-    },
-    "type": "array"
-  }
-}

removedOutput schema / else / else / required
```
Removed value: -[
-  "status"
-]
```

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"
+}
```
First observedSep 9, 2026

TDQS

A4.2/5.0

Behavior4/5

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

Annotations already declare destructiveHint=true and readOnlyHint=false, and the description adds the crucial clarification "No Meta write" — discarding has no upstream effect. It does not spell out that the prepared draft is irreversibly lost or what happens on a token mismatch, so it stops short of a 5.

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

Conciseness5/5

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

Three short, front-loaded statements: what it does, the side-effect guarantee, and the sibling routing. No filler, and the most load-bearing facts come first.

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 described, and the destructive/no-write behavior is covered. But for a 3-parameter tool with zero schema coverage, the meaning and requirements of approval_ref and expected_plan_digest are missing, as is any note on failure behavior for an invalid or stale token.

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

Parameters2/5

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

Schema description coverage is 0%, so the description carries the full burden, yet it only characterizes confirm_token (via the bu_confirm_*/mu_confirm_* naming pattern). approval_ref and expected_plan_digest are completely unexplained in both the schema and the description, and no parameter is marked required despite the token being described as mandatory.

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

Purpose5/5

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

States a specific verb ("Discard") and a specific resource (a prepared status, campaign/ad-set budget, or bid update) plus the token required to do it. It also differentiates itself from launch_deny and products_delivery_pause_deny, so an agent can pick it out of a large sibling set without opening the schema.

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

Usage Guidelines5/5

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

Explicitly routes the agent: use launch_deny for creation/copy drafts and products_delivery_pause_deny for product-family pauses. The condition that selects this tool (a prepared status/budget/bid update with a bu_confirm_*/mu_confirm_* token) is stated, and the exclusions are named rather than implied.

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?