adAuditGetReturns one owned private ad review, actual credit cost, creative-quality scores, evidence and qualified comparison examples. Missing reports return null; unknown cost and unavailable comparisons stay explicit. Oversized reports include their signed-in review path.
| Name | Required | Description | Default |
|---|---|---|---|
| auditPublicId | Yes |
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||
Changes observed during successful MCP inspections.
Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "ok": {
- "const": true,
- "type": "boolean"
- },
- "output": {
- "additionalProperties": false,
- "properties": {
- "record": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "assetPublicId": {
- "format": "uuid",
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- },
- "auditPublicId": {
- "format": "uuid",
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- },
- "completedAt": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ]
- },
- "createdAt": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "errorCode": {
- "anyOf": [
- {
- "maxLength": 120,
- "type": "string"
- },
- {
- "type": "null"
- }
- ]
- },
- "input": {
- "additionalProperties": false,
- "properties": {
- "assetPublicId": {
- "format": "uuid",
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- },
- "cta": {
- "maxLength": 200,
- "type": "string"
- },
- "headline": {
- "maxLength": 500,
- "type": "string"
- },
- "locale": {
- "enum": [
- "en",
- "es",
- "fr",
- "de",
- "nl",
- "id",
- "ms",
- "tl",
- "th",
- "ja"
- ],
- "type": "string"
- },
- "primaryText": {
- "maxLength": 5000,
- "type": "string"
- }
- },
- "required": [
- "assetPublicId",
- "cta",
- "headline",
- "locale",
- "primaryText"
- ],
- "type": "object"
- },
- "maximumCredits": {
- "minimum": 0,
- "type": "number"
- },
- "report": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "benchmark": {
- "$ref": "#/$defs/__schema0"
- },
- "evidence": {
- "$ref": "#/$defs/__schema1"
- },
- "improvements": {
- "$ref": "#/$defs/__schema3"
- },
- "quality": {
- "$ref": "#/$defs/__schema8"
- },
- "references": {
- "$ref": "#/$defs/__schema11"
- }
- },
- "required": [
- "benchmark",
- "evidence",
- "improvements",
- "quality",
- "references"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "spentCredits": {
- "anyOf": [
- {
- "minimum": 0,
- "type": "number"
- },
- {
- "type": "null"
- }
- ]
- },
- "status": {
- "enum": [
- "quoted",
- "queued",
- "running",
- "completed",
- "failed",
- "needs_review",
- "canceled"
- ],
- "type": "string"
- }
- },
- "required": [
- "assetPublicId",
- "auditPublicId",
- "completedAt",
- "createdAt",
- "errorCode",
- "input",
- "maximumCredits",
- "report",
- "spentCredits",
- "status"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "reportUnavailable": {
- "anyOf": [
- {
- "const": "response_too_large",
- "type": "string"
- },
- {
- "type": "null"
- }
- ]
- },
- "reviewPath": {
- "maxLength": 256,
- "type": "string"
- }
- },
- "required": [
- "record",
- "reportUnavailable",
- "reviewPath"
- ],
- "type": "object"
- },
- "toolName": {
- "const": "adAuditGet",
- "type": "string"
- }
- },
- "required": [
- "ok",
- "output",
- "toolName"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "error": {
- "additionalProperties": false,
- "properties": {
- "code": {
- "enum": [
- "INVALID_INPUT",
- "FORBIDDEN",
- "NOT_FOUND",
- "CONFLICT",
- "FEATURE_DISABLED",
- "CONFIRMATION_REQUIRED",
- "CONFIRMATION_INVALID",
- "UPSTREAM_FAILED",
- "NEEDS_REVIEW",
- "INTERNAL"
- ],
- "type": "string"
- },
- "message": {
- "maxLength": 2048,
- "minLength": 1,
- "type": "string"
- },
- "retryable": {
- "type": "boolean"
- }
- },
- "required": [
- "code",
- "message",
- "retryable"
- ],
- "type": "object"
- },
- "ok": {
- "const": false,
- "type": "boolean"
- },
- "toolName": {
- "const": "adAuditGet",
- "type": "string"
- }
- },
- "required": [
- "error",
- "ok",
- "toolName"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "ok": {
+ "const": true,
+ "type": "boolean"
+ },
+ "output": {
+ "additionalProperties": false,
+ "properties": {
+ "record": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "assetPublicId": {
+ "format": "uuid",
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+ "type": "string"
+ },
+ "auditPublicId": {
+ "format": "uuid",
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+ "type": "string"
+ },
+ "completedAt": {
+ "anyOf": [
+ {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "createdAt": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "errorCode": {
+ "anyOf": [
+ {
+ "maxLength": 120,
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "input": {
+ "additionalProperties": false,
+ "properties": {
+ "assetPublicId": {
+ "format": "uuid",
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+ "type": "string"
+ },
+ "cta": {
+ "maxLength": 200,
+ "type": "string"
+ },
+ "headline": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "locale": {
+ "enum": [
+ "en",
+ "es",
+ "fr",
+ "de",
+ "nl",
+ "id",
+ "ms",
+ "tl",
+ "th",
+ "ja"
+ ],
+ "type": "string"
+ },
+ "primaryText": {
+ "maxLength": 5000,
+ "type": "string"
+ }
+ },
+ "required": [
+ "assetPublicId",
+ "cta",
+ "headline",
+ "locale",
+ "primaryText"
+ ],
+ "type": "object"
+ },
+ "maximumCredits": {
+ "minimum": 0,
+ "type": "number"
+ },
+ "report": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "benchmark": {
+ "$ref": "#/$defs/__schema0"
+ },
+ "evidence": {
+ "$ref": "#/$defs/__schema1"
+ },
+ "improvements": {
+ "$ref": "#/$defs/__schema3"
+ },
+ "quality": {
+ "$ref": "#/$defs/__schema8"
+ },
+ "references": {
+ "$ref": "#/$defs/__schema11"
+ }
+ },
+ "required": [
+ "benchmark",
+ "evidence",
+ "improvements",
+ "quality",
+ "references"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "spentCredits": {
+ "anyOf": [
+ {
+ "minimum": 0,
+ "type": "number"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "status": {
+ "enum": [
+ "quoted",
+ "queued",
+ "running",
+ "completed",
+ "failed",
+ "needs_review",
+ "canceled"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "assetPublicId",
+ "auditPublicId",
+ "completedAt",
+ "createdAt",
+ "errorCode",
+ "input",
+ "maximumCredits",
+ "report",
+ "spentCredits",
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "reportUnavailable": {
+ "anyOf": [
+ {
+ "const": "response_too_large",
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "reviewPath": {
+ "maxLength": 256,
+ "type": "string"
+ }
+ },
+ "required": [
+ "record",
+ "reportUnavailable",
+ "reviewPath"
+ ],
+ "type": "object"
+ },
+ "toolName": {
+ "const": "adAuditGet",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ok",
+ "output",
+ "toolName"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "error": {
+ "additionalProperties": false,
+ "properties": {
+ "code": {
+ "enum": [
+ "AI_SCHEDULING_LIMIT_REACHED",
+ "AI_SCHEDULING_UNAVAILABLE",
+ "INVALID_INPUT",
+ "FORBIDDEN",
+ "NOT_FOUND",
+ "CONFLICT",
+ "FEATURE_DISABLED",
+ "CONFIRMATION_REQUIRED",
+ "CONFIRMATION_INVALID",
+ "UPSTREAM_FAILED",
+ "NEEDS_REVIEW",
+ "INTERNAL"
+ ],
+ "type": "string"
+ },
+ "message": {
+ "maxLength": 2048,
+ "minLength": 1,
+ "type": "string"
+ },
+ "retryable": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "code",
+ "message",
+ "retryable"
+ ],
+ "type": "object"
+ },
+ "ok": {
+ "const": false,
+ "type": "boolean"
+ },
+ "toolName": {
+ "const": "adAuditGet",
+ "type": "string"
+ }
+ },
+ "required": [
+ "error",
+ "ok",
+ "toolName"
+ ],
+ "type": "object"
+ }
+]Output schema / $defs / __schema10 / anyOfAdded value: +[
+ {
+ "const": 0,
+ "type": "number"
+ },
+ {
+ "const": 5,
+ "type": "number"
+ },
+ {
+ "const": 10,
+ "type": "number"
+ },
+ {
+ "const": 15,
+ "type": "number"
+ },
+ {
+ "const": 20,
+ "type": "number"
+ }
+]Output schema / $defs / __schema10 / itemsRemoved value: -{
- "$ref": "#/$defs/__schema11"
-}Output schema / $defs / __schema10 / maxItemsRemoved value: -3Output schema / $defs / __schema10 / typeRemoved value: -"array"Output schema / $defs / __schema11 / additionalPropertiesRemoved value: -falseOutput schema / $defs / __schema11 / itemsAdded value: +{
+ "$ref": "#/$defs/__schema12"
+}Output schema / $defs / __schema11 / maxItemsAdded value: +3Output schema / $defs / __schema11 / propertiesRemoved value: -{
- "componentId": {
- "$ref": "#/$defs/__schema5"
- },
- "componentScore": {
- "$ref": "#/$defs/__schema9"
- },
- "groupId": {
- "maxLength": 160,
- "minLength": 1,
- "type": "string"
- },
- "score": {
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- "variationId": {
- "maxLength": 160,
- "minLength": 1,
- "type": "string"
- },
- "why": {
- "const": "criterion_example",
- "type": "string"
- }
-}Output schema / $defs / __schema11 / requiredRemoved value: -[
- "componentId",
- "componentScore",
- "groupId",
- "score",
- "variationId",
- "why"
-]Output schema / $defs / __schema11 / typePrevious value: -"object"New value: +"array"Output schema / $defs / __schema12Added value: +{
+ "additionalProperties": false,
+ "properties": {
+ "componentId": {
+ "$ref": "#/$defs/__schema5"
+ },
+ "componentScore": {
+ "$ref": "#/$defs/__schema10"
+ },
+ "groupId": {
+ "maxLength": 160,
+ "minLength": 1,
+ "type": "string"
+ },
+ "score": {
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "variationId": {
+ "maxLength": 160,
+ "minLength": 1,
+ "type": "string"
+ },
+ "why": {
+ "const": "criterion_example",
+ "type": "string"
+ }
+ },
+ "required": [
+ "componentId",
+ "componentScore",
+ "groupId",
+ "score",
+ "variationId",
+ "why"
+ ],
+ "type": "object"
+}Output schema / $defs / __schema4 / additionalPropertiesRemoved value: -falseOutput schema / $defs / __schema4 / anyOfAdded value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "action": {
+ "enum": [
+ "lead_with_copy",
+ "place_copy_near_product",
+ "increase_text_contrast",
+ "enlarge_text",
+ "restore_text_margin",
+ "separate_text_blocks",
+ "enlarge_product"
+ ],
+ "type": "string"
+ },
+ "componentId": {
+ "$ref": "#/$defs/__schema5"
+ },
+ "evidenceIds": {
+ "items": {
+ "$ref": "#/$defs/__schema6"
+ },
+ "maxItems": 32,
+ "minItems": 1,
+ "type": "array"
+ },
+ "quote": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "evidenceId": {
+ "maxLength": 200,
+ "minLength": 1,
+ "type": "string"
+ },
+ "text": {
+ "maxLength": 300,
+ "minLength": 1,
+ "type": "string"
+ }
+ },
+ "required": [
+ "evidenceId",
+ "text"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+ },
+ "required": [
+ "action",
+ "componentId",
+ "evidenceIds",
+ "quote"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "componentId": {
+ "$ref": "#/$defs/__schema5"
+ },
+ "evidenceIds": {
+ "items": {
+ "$ref": "#/$defs/__schema7"
+ },
+ "maxItems": 16,
+ "type": "array"
+ },
+ "suggestionKey": {
+ "enum": [
+ "clarify_takeaway",
+ "focus_opening",
+ "make_benefit_concrete",
+ "connect_offering",
+ "align_elements"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "componentId",
+ "evidenceIds",
+ "suggestionKey"
+ ],
+ "type": "object"
+ }
+]Output schema / $defs / __schema4 / propertiesRemoved value: -{
- "componentId": {
- "$ref": "#/$defs/__schema5"
- },
- "evidenceIds": {
- "items": {
- "$ref": "#/$defs/__schema6"
- },
- "maxItems": 16,
- "type": "array"
- },
- "suggestionKey": {
- "enum": [
- "clarify_takeaway",
- "focus_opening",
- "make_benefit_concrete",
- "connect_offering",
- "align_elements"
- ],
- "type": "string"
- }
-}Output schema / $defs / __schema4 / requiredRemoved value: -[
- "componentId",
- "evidenceIds",
- "suggestionKey"
-]Output schema / $defs / __schema4 / typeRemoved value: -"object"Output schema / $defs / __schema7 / additionalPropertiesRemoved value: -falseOutput schema / $defs / __schema7 / maxLengthAdded value: +200Output schema / $defs / __schema7 / minLengthAdded value: +1Output schema / $defs / __schema7 / propertiesRemoved value: -{
- "components": {
- "additionalProperties": false,
- "properties": {
- "attention_design": {
- "$ref": "#/$defs/__schema8"
- },
- "brand_offering_connection": {
- "$ref": "#/$defs/__schema8"
- },
- "coherence": {
- "$ref": "#/$defs/__schema8"
- },
- "message_clarity": {
- "$ref": "#/$defs/__schema8"
- },
- "reason_to_care": {
- "$ref": "#/$defs/__schema8"
- }
- },
- "required": [
- "attention_design",
- "brand_offering_connection",
- "coherence",
- "message_clarity",
- "reason_to_care"
- ],
- "type": "object"
- },
- "rubricVersion": {
- "maxLength": 100,
- "minLength": 1,
- "type": "string"
- },
- "total": {
- "anyOf": [
- {
- "maximum": 100,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ]
- }
-}Output schema / $defs / __schema7 / requiredRemoved value: -[
- "components",
- "rubricVersion",
- "total"
-]Output schema / $defs / __schema7 / typePrevious value: -"object"New value: +"string"Output schema / $defs / __schema8 / additionalPropertiesAdded value: +falseOutput schema / $defs / __schema8 / anyOfRemoved value: -[
- {
- "$ref": "#/$defs/__schema9"
- },
- {
- "type": "null"
- }
-]Output schema / $defs / __schema8 / propertiesAdded value: +{
+ "components": {
+ "additionalProperties": false,
+ "properties": {
+ "attention_design": {
+ "$ref": "#/$defs/__schema9"
+ },
+ "brand_offering_connection": {
+ "$ref": "#/$defs/__schema9"
+ },
+ "coherence": {
+ "$ref": "#/$defs/__schema9"
+ },
+ "message_clarity": {
+ "$ref": "#/$defs/__schema9"
+ },
+ "reason_to_care": {
+ "$ref": "#/$defs/__schema9"
+ }
+ },
+ "required": [
+ "attention_design",
+ "brand_offering_connection",
+ "coherence",
+ "message_clarity",
+ "reason_to_care"
+ ],
+ "type": "object"
+ },
+ "rubricVersion": {
+ "maxLength": 100,
+ "minLength": 1,
+ "type": "string"
+ },
+ "total": {
+ "anyOf": [
+ {
+ "maximum": 100,
+ "minimum": 0,
+ "type": "integer"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ }
+}Output schema / $defs / __schema8 / requiredAdded value: +[
+ "components",
+ "rubricVersion",
+ "total"
+]Output schema / $defs / __schema8 / typeAdded value: +"object"Output schema / $defs / __schema9 / anyOfPrevious value: -[
- {
- "const": 0,
- "type": "number"
- },
- {
- "const": 5,
- "type": "number"
- },
- {
- "const": 10,
- "type": "number"
- },
- {
- "const": 15,
- "type": "number"
- },
- {
- "const": 20,
- "type": "number"
- }
-]New value: +[
+ {
+ "$ref": "#/$defs/__schema10"
+ },
+ {
+ "type": "null"
+ }
+]Output schema / oneOfPrevious value: -[
- {
- "additionalProperties": false,
- "properties": {
- "ok": {
- "const": true,
- "type": "boolean"
- },
- "output": {
- "additionalProperties": false,
- "properties": {
- "record": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "assetPublicId": {
- "format": "uuid",
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- },
- "auditPublicId": {
- "format": "uuid",
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- },
- "completedAt": {
- "anyOf": [
- {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- {
- "type": "null"
- }
- ]
- },
- "createdAt": {
- "maximum": 9007199254740991,
- "minimum": 0,
- "type": "integer"
- },
- "errorCode": {
- "anyOf": [
- {
- "maxLength": 120,
- "type": "string"
- },
- {
- "type": "null"
- }
- ]
- },
- "input": {
- "additionalProperties": false,
- "properties": {
- "assetPublicId": {
- "format": "uuid",
- "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
- "type": "string"
- },
- "cta": {
- "maxLength": 200,
- "type": "string"
- },
- "headline": {
- "maxLength": 500,
- "type": "string"
- },
- "locale": {
- "enum": [
- "en",
- "es",
- "fr",
- "de",
- "nl",
- "id",
- "ms",
- "tl",
- "th",
- "ja"
- ],
- "type": "string"
- },
- "primaryText": {
- "maxLength": 5000,
- "type": "string"
- }
- },
- "required": [
- "assetPublicId",
- "cta",
- "headline",
- "locale",
- "primaryText"
- ],
- "type": "object"
- },
- "maximumCredits": {
- "minimum": 0,
- "type": "number"
- },
- "report": {
- "anyOf": [
- {
- "additionalProperties": false,
- "properties": {
- "benchmark": {
- "$ref": "#/$defs/__schema0"
- },
- "evidence": {
- "$ref": "#/$defs/__schema1"
- },
- "improvements": {
- "$ref": "#/$defs/__schema3"
- },
- "quality": {
- "$ref": "#/$defs/__schema7"
- },
- "references": {
- "$ref": "#/$defs/__schema10"
- }
- },
- "required": [
- "benchmark",
- "evidence",
- "improvements",
- "quality",
- "references"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "spentCredits": {
- "anyOf": [
- {
- "minimum": 0,
- "type": "number"
- },
- {
- "type": "null"
- }
- ]
- },
- "status": {
- "enum": [
- "quoted",
- "queued",
- "running",
- "completed",
- "failed",
- "needs_review",
- "canceled"
- ],
- "type": "string"
- }
- },
- "required": [
- "assetPublicId",
- "auditPublicId",
- "completedAt",
- "createdAt",
- "errorCode",
- "input",
- "maximumCredits",
- "report",
- "spentCredits",
- "status"
- ],
- "type": "object"
- },
- {
- "type": "null"
- }
- ]
- },
- "reportUnavailable": {
- "anyOf": [
- {
- "const": "response_too_large",
- "type": "string"
- },
- {
- "type": "null"
- }
- ]
- },
- "reviewPath": {
- "maxLength": 256,
- "type": "string"
- }
- },
- "required": [
- "record",
- "reportUnavailable",
- "reviewPath"
- ],
- "type": "object"
- },
- "toolName": {
- "const": "adAuditGet",
- "type": "string"
- }
- },
- "required": [
- "ok",
- "output",
- "toolName"
- ],
- "type": "object"
- },
- {
- "additionalProperties": false,
- "properties": {
- "error": {
- "additionalProperties": false,
- "properties": {
- "code": {
- "enum": [
- "INVALID_INPUT",
- "FORBIDDEN",
- "NOT_FOUND",
- "CONFLICT",
- "FEATURE_DISABLED",
- "CONFIRMATION_REQUIRED",
- "CONFIRMATION_INVALID",
- "UPSTREAM_FAILED",
- "NEEDS_REVIEW",
- "INTERNAL"
- ],
- "type": "string"
- },
- "message": {
- "maxLength": 2048,
- "minLength": 1,
- "type": "string"
- },
- "retryable": {
- "type": "boolean"
- }
- },
- "required": [
- "code",
- "message",
- "retryable"
- ],
- "type": "object"
- },
- "ok": {
- "const": false,
- "type": "boolean"
- },
- "toolName": {
- "const": "adAuditGet",
- "type": "string"
- }
- },
- "required": [
- "error",
- "ok",
- "toolName"
- ],
- "type": "object"
- }
-]New value: +[
+ {
+ "additionalProperties": false,
+ "properties": {
+ "ok": {
+ "const": true,
+ "type": "boolean"
+ },
+ "output": {
+ "additionalProperties": false,
+ "properties": {
+ "record": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "assetPublicId": {
+ "format": "uuid",
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+ "type": "string"
+ },
+ "auditPublicId": {
+ "format": "uuid",
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+ "type": "string"
+ },
+ "completedAt": {
+ "anyOf": [
+ {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "createdAt": {
+ "maximum": 9007199254740991,
+ "minimum": 0,
+ "type": "integer"
+ },
+ "errorCode": {
+ "anyOf": [
+ {
+ "maxLength": 120,
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "input": {
+ "additionalProperties": false,
+ "properties": {
+ "assetPublicId": {
+ "format": "uuid",
+ "pattern": "^([0-9a-fA-F]{8}-[0-9a-fA-F]{4}-[1-8][0-9a-fA-F]{3}-[89abAB][0-9a-fA-F]{3}-[0-9a-fA-F]{12}|00000000-0000-0000-0000-000000000000|ffffffff-ffff-ffff-ffff-ffffffffffff)$",
+ "type": "string"
+ },
+ "cta": {
+ "maxLength": 200,
+ "type": "string"
+ },
+ "headline": {
+ "maxLength": 500,
+ "type": "string"
+ },
+ "locale": {
+ "enum": [
+ "en",
+ "es",
+ "fr",
+ "de",
+ "nl",
+ "id",
+ "ms",
+ "tl",
+ "th",
+ "ja"
+ ],
+ "type": "string"
+ },
+ "primaryText": {
+ "maxLength": 5000,
+ "type": "string"
+ }
+ },
+ "required": [
+ "assetPublicId",
+ "cta",
+ "headline",
+ "locale",
+ "primaryText"
+ ],
+ "type": "object"
+ },
+ "maximumCredits": {
+ "minimum": 0,
+ "type": "number"
+ },
+ "report": {
+ "anyOf": [
+ {
+ "additionalProperties": false,
+ "properties": {
+ "benchmark": {
+ "$ref": "#/$defs/__schema0"
+ },
+ "evidence": {
+ "$ref": "#/$defs/__schema1"
+ },
+ "improvements": {
+ "$ref": "#/$defs/__schema3"
+ },
+ "quality": {
+ "$ref": "#/$defs/__schema8"
+ },
+ "references": {
+ "$ref": "#/$defs/__schema11"
+ }
+ },
+ "required": [
+ "benchmark",
+ "evidence",
+ "improvements",
+ "quality",
+ "references"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "spentCredits": {
+ "anyOf": [
+ {
+ "minimum": 0,
+ "type": "number"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "status": {
+ "enum": [
+ "quoted",
+ "queued",
+ "running",
+ "completed",
+ "failed",
+ "needs_review",
+ "canceled"
+ ],
+ "type": "string"
+ }
+ },
+ "required": [
+ "assetPublicId",
+ "auditPublicId",
+ "completedAt",
+ "createdAt",
+ "errorCode",
+ "input",
+ "maximumCredits",
+ "report",
+ "spentCredits",
+ "status"
+ ],
+ "type": "object"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "reportUnavailable": {
+ "anyOf": [
+ {
+ "const": "response_too_large",
+ "type": "string"
+ },
+ {
+ "type": "null"
+ }
+ ]
+ },
+ "reviewPath": {
+ "maxLength": 256,
+ "type": "string"
+ }
+ },
+ "required": [
+ "record",
+ "reportUnavailable",
+ "reviewPath"
+ ],
+ "type": "object"
+ },
+ "toolName": {
+ "const": "adAuditGet",
+ "type": "string"
+ }
+ },
+ "required": [
+ "ok",
+ "output",
+ "toolName"
+ ],
+ "type": "object"
+ },
+ {
+ "additionalProperties": false,
+ "properties": {
+ "error": {
+ "additionalProperties": false,
+ "properties": {
+ "code": {
+ "enum": [
+ "INVALID_INPUT",
+ "FORBIDDEN",
+ "NOT_FOUND",
+ "CONFLICT",
+ "FEATURE_DISABLED",
+ "CONFIRMATION_REQUIRED",
+ "CONFIRMATION_INVALID",
+ "UPSTREAM_FAILED",
+ "NEEDS_REVIEW",
+ "INTERNAL"
+ ],
+ "type": "string"
+ },
+ "message": {
+ "maxLength": 2048,
+ "minLength": 1,
+ "type": "string"
+ },
+ "retryable": {
+ "type": "boolean"
+ }
+ },
+ "required": [
+ "code",
+ "message",
+ "retryable"
+ ],
+ "type": "object"
+ },
+ "ok": {
+ "const": false,
+ "type": "boolean"
+ },
+ "toolName": {
+ "const": "adAuditGet",
+ "type": "string"
+ }
+ },
+ "required": [
+ "error",
+ "ok",
+ "toolName"
+ ],
+ "type": "object"
+ }
+]Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already cover the safety profile (readOnly, idempotent, non-destructive, closed-world), yet the description adds real edge-case behavior: missing reports return null, unknown cost and unavailable comparisons remain explicit, and oversized reports surface a signed-in review path. These are non-obvious behaviors an agent could not infer from the schema or annotations.
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?
Three tightly packed sentences, front-loaded with the primary return content and followed by edge-case behavior. No wasted filler, though the density borders on terse for a first-time reader.
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?
With an output schema present, return values need not be re-explained, and annotations cover the safety profile; the description fills the remaining gap by disclosing null, unknown-cost, and oversized-report handling. Only the parameter's role/format is left unaddressed.
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?
There is a single required parameter (auditPublicId) with 0% schema description coverage, and the description never mentions it or its format, other than implying the record is retrieved by id. The schema carries a uuid format/pattern, but the description adds no parameter meaning beyond that.
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 (Returns) and resource (one owned private ad review), scoped to a single record, which implicitly contrasts with the list-oriented adAuditList sibling. It is clear, but it never names the sibling to make the single-vs-list distinction explicit.
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?
Usage is only implied: you fetch one review by id. There is no statement of when to use this versus adAuditList, nor any prerequisite or exclusions. Adequate but with a clear gap.
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.