google_ads_video_upload_remove_confirm
Confirm one reviewed direct video removal draft.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| draft_id | Yes | ||
| customer_id | Yes | 10-digit Google Ads customer id. | |
| connection_context | No |
Confirm one reviewed direct video removal draft.
| Name | Required | Description | Default |
|---|---|---|---|
| draft_id | Yes | ||
| customer_id | Yes | 10-digit Google Ads customer id. | |
| connection_context | No |
Changes observed during successful MCP inspections.
Input schema / properties / connection_contextAdded value: +{
+ "pattern": "^mctx_v1_[0-9a-f]{64}$",
+ "type": "string"
+}Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare destructiveHint=true and readOnlyHint=false, so the agent knows this mutates and destroys state. The description adds only that the draft must have been reviewed; it says nothing about irreversibility, required permissions, or that the draft_id must originate from a prepare call.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
A single front-loaded sentence with zero filler. It is efficient, though so terse that it borders on under-specification rather than tight writing.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
For a destructive mutation with three parameters, 33% schema coverage and no output schema, the description is too thin. It omits the prepare/confirm relationship, the meaning of the two undocumented parameters, and any statement of effect, all of which the agent needs to invoke it safely.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
Schema coverage is only 33%: draft_id and connection_context are undocumented in both schema and description. The description does not compensate by explaining what a draft_id is or how it is obtained, which is the critical link to the prepare step.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
States a specific verb (Confirm) and resource (direct video removal draft), which cleanly separates it from the *_prepare and *_list siblings in the video upload family. It stops short of a 5 because 'direct video removal' is domain jargon that isn't unpacked, and the draft's origin is not tied to google_ads_video_upload_remove_prepare.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
The word 'reviewed' hints at a prepare-then-confirm workflow, so the agent can infer this tool executes an already-vetted removal draft. However, no explicit condition or named alternative (google_ads_video_upload_remove_prepare) is given, leaving the sequencing to inference.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.