Prepare a destination URL change on the same Ad ID; confirm/deny via operations
| Name | Required | Description | Default |
|---|---|---|---|
| ad_id | Yes | ||
| ad_account_id | Yes | ||
| destination_url | Yes |
| Name | Required | Description | Default |
|---|---|---|---|
| message | No | ||
| retryable | No | ||
| support_ref | No |
Changes observed during successful MCP inspections.
Input schema / properties / connection_contextRemoved value: -{
- "pattern": "^mctx_v1_[0-9a-f]{64}$",
- "type": "string"
-}Output schema / $defsRemoved value: -{
- "s0": {
- "properties": {
- "account_currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "action": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_account_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_count": {
- "type": "integer"
- },
- "ad_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_name_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_name_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "ad_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset_count": {
- "type": "integer"
- },
- "adset_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "adset_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "bid": {
- "$ref": "#/$defs/s1"
- },
- "budget": {
- "$ref": "#/$defs/s1"
- },
- "campaign_count": {
- "type": "integer"
- },
- "campaign_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "campaign_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "change_percent": {
- "type": [
- "number",
- "null"
- ]
- },
- "configured_status_before": {
- "type": [
- "string",
- "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"
- ]
- },
- "destination_url_after": {
- "type": "string"
- },
- "destination_url_before": {
- "type": "string"
- },
- "effective_status_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "engagement_mode": {
- "type": [
- "string",
- "null"
- ]
- },
- "entity_id": {
- "type": [
- "string",
- "null"
- ]
- },
- "entity_type": {
- "type": [
- "string",
- "null"
- ]
- },
- "groups": {
- "items": {
- "properties": {
- "adsets": {
- "items": {
- "properties": {
- "name": {
- "type": [
- "string",
- "null"
- ]
- },
- "target_adset_id": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "bid": {
- "$ref": "#/$defs/s6"
- },
- "budget": {
- "$ref": "#/$defs/s6"
- },
- "campaign_name": {
- "type": [
- "string",
- "null"
- ]
- },
- "layout": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "items": {
- "items": {
- "properties": {
- "ad_account_id": {
- "type": "string"
- },
- "ad_id": {
- "type": "string"
- },
- "campaign_id": {
- "type": "string"
- },
- "current_configured_status": {
- "type": [
- "string",
- "null"
- ]
- },
- "current_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "new_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "target_configured_status": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "mode": {
- "type": [
- "string",
- "null"
- ]
- },
- "new_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "note": {
- "type": [
- "string",
- "null"
- ]
- },
- "page_id_after": {
- "type": [
- "string",
- "null"
- ]
- },
- "page_id_before": {
- "type": [
- "string",
- "null"
- ]
- },
- "preserved_fields": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "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": {
- "$ref": "#/$defs/sb"
- }
- },
- "required": [
- "ad_id",
- "destination_url_before",
- "destination_url_after"
- ],
- "type": "object"
- },
- "s1": {
- "properties": {
- "amount": {
- "type": [
- "number",
- "null"
- ]
- },
- "currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "level": {
- "type": "string"
- },
- "mode": {
- "type": "string"
- },
- "total_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "unit": {
- "type": "string"
- }
- },
- "type": [
- "null",
- "object"
- ]
- },
- "s6": {
- "properties": {
- "amount": {
- "type": [
- "number",
- "null"
- ]
- },
- "currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "level": {
- "type": "string"
- },
- "mode": {
- "type": "string"
- },
- "total_daily_budget": {
- "type": [
- "number",
- "null"
- ]
- },
- "unit": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "sb": {
- "items": {
- "anyOf": [
- {
- "type": "string"
- },
- {
- "anyOf": [
- {
- "properties": {
- "code": {
- "type": "string"
- }
- },
- "required": [
- "code"
- ]
- },
- {
- "required": [
- "message"
- ]
- }
- ],
- "properties": {
- "message": {
- "type": "string"
- }
- },
- "type": "object"
- }
- ]
- },
- "type": "array"
- }
-}Output schema / else / else / anyOfPrevious value: -[
- {
- "properties": {
- "approval_request": {
- "properties": {
- "approval_ref": {
- "type": "string"
- },
- "confirm_tool": {
- "type": "string"
- },
- "expires_at": {
- "type": "string"
- },
- "instruction_template_id": {
- "type": "string"
- },
- "mode": {
- "type": "string"
- },
- "plan_digest": {
- "type": "string"
- },
- "schema_version": {
- "type": "integer"
- },
- "status": {
- "const": "approval_required"
- },
- "summary": {
- "$ref": "#/$defs/s0"
- },
- "tool_name": {
- "type": "string"
- },
- "user_instruction": {
- "type": "string"
- },
- "warnings": {
- "$ref": "#/$defs/sb"
- }
- },
- "required": [
- "status",
- "expires_at",
- "summary",
- "approval_ref",
- "plan_digest"
- ],
- "type": "object"
- },
- "status": {
- "type": "string"
- }
- },
- "required": [
- "approval_request"
- ]
- },
- {
- "properties": {
- "ad_account_id": {
- "type": "string"
- },
- "ad_id": {
- "type": "string"
- },
- "status": {
- "const": "unchanged"
- },
- "summary": {
- "$ref": "#/$defs/s0"
- }
- },
- "required": [
- "status",
- "ad_account_id",
- "ad_id",
- "summary"
- ]
- },
- {
- "properties": {
- "account_blocker_code": {
- "type": [
- "string",
- "null"
- ]
- },
- "account_blocker_label": {
- "type": [
- "string",
- "null"
- ]
- },
- "automatic_retry_allowed": {
- "type": "boolean"
- },
- "category": {
- "type": [
- "string",
- "null"
- ]
- },
- "code": {
- "type": [
- "string",
- "null"
- ]
- },
- "manual_new_task_allowed": {
- "type": "boolean"
- },
- "narrative": {
- "properties": {
- "details": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "headline": {
- "type": "string"
- },
- "summary": {
- "type": "string"
- },
- "user_instruction": {
- "type": "string"
- },
- "what_happens_next": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "operator_review_required": {
- "type": "boolean"
- },
- "status": {
- "const": "blocked"
- },
- "summary": {
- "properties": {
- "action": {
- "const": "update_url_on_existing_ad"
- },
- "ad_account_id": {
- "type": "string"
- },
- "ad_id": {
- "type": "string"
- }
- },
- "required": [
- "action",
- "ad_account_id",
- "ad_id"
- ],
- "type": "object"
- },
- "warnings": {
- "$ref": "#/$defs/sb"
- }
- },
- "required": [
- "status",
- "summary"
- ]
- }
-]New value: +[
+ {
+ "required": [
+ "approval_request"
+ ]
+ },
+ {
+ "properties": {
+ "status": {
+ "const": "unchanged"
+ }
+ },
+ "required": [
+ "ad_account_id",
+ "ad_id",
+ "status",
+ "summary"
+ ]
+ },
+ {
+ "properties": {
+ "status": {
+ "const": "blocked"
+ }
+ },
+ "required": [
+ "status",
+ "summary"
+ ]
+ }
+]Output schema / else / else / propertiesAdded value: +{
+ "account_blocker_code": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "account_blocker_label": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_id": {
+ "type": "string"
+ },
+ "ad_id": {
+ "type": "string"
+ },
+ "approval_request": {
+ "properties": {
+ "approval_ref": {
+ "type": "string"
+ },
+ "confirm_tool": {
+ "type": "string"
+ },
+ "expires_at": {
+ "type": "string"
+ },
+ "instruction_template_id": {
+ "type": "string"
+ },
+ "mode": {
+ "type": "string"
+ },
+ "plan_digest": {
+ "type": "string"
+ },
+ "schema_version": {
+ "type": "integer"
+ },
+ "status": {
+ "const": "approval_required"
+ },
+ "summary": {
+ "properties": {
+ "account_currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "action": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_account_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_count": {
+ "type": "integer"
+ },
+ "ad_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_name_after": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_name_before": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "ad_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset_count": {
+ "type": "integer"
+ },
+ "adset_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "adset_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "bid": {
+ "properties": {
+ "amount": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "level": {
+ "type": "string"
+ },
+ "mode": {
+ "type": "string"
+ },
+ "total_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "unit": {
+ "type": "string"
+ }
+ },
+ "type": [
+ "null",
+ "object"
+ ]
+ },
+ "budget": {
+ "properties": {
+ "amount": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "level": {
+ "type": "string"
+ },
+ "mode": {
+ "type": "string"
+ },
+ "total_daily_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "unit": {
+ "type": "string"
+ }
+ },
+ "type": [
+ "null",
+ "object"
+ ]
+ },
+ "campaign_count": {
+ "type": "integer"
+ },
+ "campaign_id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "campaign_status": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "change_percent": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "configured_status_before": {
+ "type": [
+ "string",
+ "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"
+ ]
+ },
+ "destination_url_after": {
+ "type": "string"
+ },
+ "destination_url_before": {
+ "type": "string"
+ },
+ "effective_status_before": {
+ "type": [
+ "string",
+ "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"
+ ]
+ },
+ "preserved_fields": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "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"
+ }
+ },
+ "required": [
+ "ad_id",
+ "destination_url_before",
+ "destination_url_after"
+ ],
+ "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",
+ "expires_at",
+ "summary",
+ "approval_ref",
+ "plan_digest"
+ ],
+ "type": "object"
+ },
+ "automatic_retry_allowed": {
+ "type": "boolean"
+ },
+ "category": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "code": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "manual_new_task_allowed": {
+ "type": "boolean"
+ },
+ "narrative": {
+ "properties": {
+ "details": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "headline": {
+ "type": "string"
+ },
+ "summary": {
+ "type": "string"
+ },
+ "user_instruction": {
+ "type": "string"
+ },
+ "what_happens_next": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "operator_review_required": {
+ "type": "boolean"
+ },
+ "status": {
+ "type": "string"
+ },
+ "summary": {
+ "anyOf": [
+ {
+ "required": [
+ "ad_id",
+ "destination_url_after",
+ "destination_url_before"
+ ]
+ },
+ {
+ "properties": {
+ "action": {
+ "const": "update_url_on_existing_ad"
+ }
+ },
+ "required": [
+ "action",
+ "ad_account_id",
+ "ad_id"
+ ]
+ }
+ ],
+ "properties": {
+ "account_currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "action": {
+ "anyOf": [
+ {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ {
+ "const": "update_url_on_existing_ad"
+ }
+ ]
+ },
+ "ad_account_id": {
+ "type": [
+ "null",
+ "string"
+ ]
+ },
+ "ad_count": {
+ "type": "integer"
+ },
+ "ad_id": {
+ "type": [
+ "null",
+ "string"
+ ]
+ },
+ "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"
+ ]
+ },
+ "configured_status_before": {
+ "type": [
+ "string",
+ "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"
+ ]
+ },
+ "destination_url_after": {
+ "type": "string"
+ },
+ "destination_url_before": {
+ "type": "string"
+ },
+ "effective_status_before": {
+ "type": [
+ "string",
+ "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"
+ ]
+ },
+ "preserved_fields": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "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"
+ }
+ },
+ "required": [
+ "ad_id"
+ ],
+ "type": "object"
+ },
+ "warnings": {
+ "items": {
+ "anyOf": [
+ {
+ "type": "string"
+ },
+ {
+ "anyOf": [
+ {
+ "properties": {
+ "code": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "code"
+ ]
+ },
+ {
+ "required": [
+ "message"
+ ]
+ }
+ ],
+ "properties": {
+ "message": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ }
+ ]
+ },
+ "type": "array"
+ }
+}Output schema / else / else / anyOfPrevious value: -[
- {
- "properties": {
- "approval_request": {
- "properties": {
- "approval_ref": {
- "type": "string"
- },
- "expires_at": {
- "type": "string"
- },
- "mode": {
- "type": "string"
- },
- "plan_digest": {
- "type": "string"
- },
- "schema_version": {
- "type": "integer"
- },
- "status": {
- "const": "approval_required"
- },
- "summary": {
- "$ref": "#/$defs/s0"
- },
- "tool_name": {
- "type": "string"
- },
- "user_instruction": {
- "type": "string"
- },
- "warnings": {
- "$ref": "#/$defs/sb"
- }
- },
- "required": [
- "status",
- "expires_at",
- "summary",
- "approval_ref",
- "plan_digest"
- ],
- "type": "object"
- },
- "status": {
- "type": "string"
- }
- },
- "required": [
- "approval_request"
- ]
- },
- {
- "properties": {
- "ad_account_id": {
- "type": "string"
- },
- "ad_id": {
- "type": "string"
- },
- "status": {
- "const": "unchanged"
- },
- "summary": {
- "$ref": "#/$defs/s0"
- }
- },
- "required": [
- "status",
- "ad_account_id",
- "ad_id",
- "summary"
- ]
- },
- {
- "properties": {
- "account_blocker_code": {
- "type": [
- "string",
- "null"
- ]
- },
- "account_blocker_label": {
- "type": [
- "string",
- "null"
- ]
- },
- "automatic_retry_allowed": {
- "type": "boolean"
- },
- "category": {
- "type": [
- "string",
- "null"
- ]
- },
- "code": {
- "type": [
- "string",
- "null"
- ]
- },
- "manual_new_task_allowed": {
- "type": "boolean"
- },
- "narrative": {
- "properties": {
- "details": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "headline": {
- "type": "string"
- },
- "summary": {
- "type": "string"
- },
- "user_instruction": {
- "type": "string"
- },
- "what_happens_next": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "operator_review_required": {
- "type": "boolean"
- },
- "status": {
- "const": "blocked"
- },
- "summary": {
- "properties": {
- "action": {
- "const": "update_url_on_existing_ad"
- },
- "ad_account_id": {
- "type": "string"
- },
- "ad_id": {
- "type": "string"
- }
- },
- "required": [
- "action",
- "ad_account_id",
- "ad_id"
- ],
- "type": "object"
- },
- "warnings": {
- "$ref": "#/$defs/sb"
- }
- },
- "required": [
- "status",
- "summary"
- ]
- }
-]New value: +[
+ {
+ "properties": {
+ "approval_request": {
+ "properties": {
+ "approval_ref": {
+ "type": "string"
+ },
+ "confirm_tool": {
+ "type": "string"
+ },
+ "expires_at": {
+ "type": "string"
+ },
+ "instruction_template_id": {
+ "type": "string"
+ },
+ "mode": {
+ "type": "string"
+ },
+ "plan_digest": {
+ "type": "string"
+ },
+ "schema_version": {
+ "type": "integer"
+ },
+ "status": {
+ "const": "approval_required"
+ },
+ "summary": {
+ "$ref": "#/$defs/s0"
+ },
+ "tool_name": {
+ "type": "string"
+ },
+ "user_instruction": {
+ "type": "string"
+ },
+ "warnings": {
+ "$ref": "#/$defs/sb"
+ }
+ },
+ "required": [
+ "status",
+ "expires_at",
+ "summary",
+ "approval_ref",
+ "plan_digest"
+ ],
+ "type": "object"
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "approval_request"
+ ]
+ },
+ {
+ "properties": {
+ "ad_account_id": {
+ "type": "string"
+ },
+ "ad_id": {
+ "type": "string"
+ },
+ "status": {
+ "const": "unchanged"
+ },
+ "summary": {
+ "$ref": "#/$defs/s0"
+ }
+ },
+ "required": [
+ "status",
+ "ad_account_id",
+ "ad_id",
+ "summary"
+ ]
+ },
+ {
+ "properties": {
+ "account_blocker_code": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "account_blocker_label": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "automatic_retry_allowed": {
+ "type": "boolean"
+ },
+ "category": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "code": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "manual_new_task_allowed": {
+ "type": "boolean"
+ },
+ "narrative": {
+ "properties": {
+ "details": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "headline": {
+ "type": "string"
+ },
+ "summary": {
+ "type": "string"
+ },
+ "user_instruction": {
+ "type": "string"
+ },
+ "what_happens_next": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "operator_review_required": {
+ "type": "boolean"
+ },
+ "status": {
+ "const": "blocked"
+ },
+ "summary": {
+ "properties": {
+ "action": {
+ "const": "update_url_on_existing_ad"
+ },
+ "ad_account_id": {
+ "type": "string"
+ },
+ "ad_id": {
+ "type": "string"
+ }
+ },
+ "required": [
+ "action",
+ "ad_account_id",
+ "ad_id"
+ ],
+ "type": "object"
+ },
+ "warnings": {
+ "$ref": "#/$defs/sb"
+ }
+ },
+ "required": [
+ "status",
+ "summary"
+ ]
+ }
+]Output schema / else / then / properties / categoryAdded value: +{
+ "type": "string"
+}Output schema / else / then / properties / expectedAdded value: +{
+ "type": "boolean"
+}Output schema / else / then / properties / failure_kindAdded value: +{
+ "type": "string"
+}Output schema / else / then / properties / responsibility_hintAdded value: +{
+ "type": "string"
+}Output schema / else / then / properties / routeAdded value: +{
+ "type": "string"
+}Output schema / else / then / properties / user_visibleAdded value: +{
+ "type": "boolean"
+}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 declare readOnly=false, destructive=false. The description adds meaningful context beyond that: 'Prepare' signals the mutation is staged, not applied, and 'confirm/deny via operations' tells the agent the actual change requires a follow-up call. Missing auth/permission notes but the deferred-mutation semantics are well conveyed.
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 compact sentence that front-loads the action and scope. No wasted words, though it is terse to the point of omitting parameter detail.
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?
An output schema exists so return values needn't be described. But with 0% schema coverage and no parameter explanation, plus minimal workflow guidance, the definition is only minimally complete for a prepare-mutation tool.
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 description coverage is 0% for 3 required params (ad_account_id, ad_id, destination_url). The description does not explain any parameter semantics, leaving the burden unmet. Parameter names are fairly self-evident, but the description adds nothing over the bare schema.
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+resource: 'Prepare a destination URL change on the same Ad ID'. This clearly distinguishes it from ads_update_copy_prepare and from the confirm/deny siblings by noting confirmation happens via operations.
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?
'confirm/deny via operations' implies a staged workflow where this prepare step precedes confirmation, which gives useful context. However, it does not explicitly state when to choose this over alternatives or prerequisites (e.g., that the ad must exist / correct account).
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.