AdsAgent — Meta Ads MCP

tasks_get_create_detail

Read-only

Read your create/copy task's saved ad copy and failures. include_live also reads targeting for that task's ad sets in your authorized Meta accounts; it does not rerun the task or change ads

Input Schema

Name	Required	Description	Default
`task_ref`	No
`copy_offset`	No
`include_live`	No
`result_cursor`	No
`copy_generation`	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": {
-      "ad_count": {
-        "type": "integer"
-      },
-      "ads_per_adset": {
-        "type": "integer"
-      },
-      "adset_count": {
-        "type": "integer"
-      },
-      "adsets_per_campaign": {
-        "type": "integer"
-      },
-      "campaign_count": {
-        "type": "integer"
-      }
-    },
-    "type": "object"
-  },
-  "s1": {
-    "properties": {
-      "count": {
-        "type": "integer"
-      },
-      "items": {
-        "items": {
-          "properties": {
-            "ad_id": {
-              "type": "string"
-            },
-            "ad_name": {
-              "type": "string"
-            },
-            "automatic_retry_allowed": {
-              "type": "boolean"
-            },
-            "category": {
-              "type": "string"
-            },
-            "code": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            },
-            "next_action": {
-              "properties": {
-                "arguments": {
-                  "properties": {
-                    "mutation_ref": {
-                      "type": "string"
-                    },
-                    "response_mode": {
-                      "type": "string"
-                    },
-                    "task_ref": {
-                      "type": "string"
-                    }
-                  },
-                  "type": "object"
-                },
-                "instruction": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                },
-                "tool": {
-                  "type": "string"
-                },
-                "type": {
-                  "type": "string"
-                }
-              },
-              "type": [
-                "null",
-                "object",
-                "string"
-              ]
-            },
-            "operator_review_required": {
-              "type": "boolean"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "truncated": {
-        "type": "boolean"
-      }
-    },
-    "type": "object"
-  },
-  "s9": {
-    "items": {
-      "properties": {
-        "ad_id": {
-          "type": "string"
-        },
-        "adset_id": {
-          "type": "string"
-        },
-        "campaign_id": {
-          "type": "string"
-        },
-        "id": {
-          "type": "string"
-        },
-        "name": {
-          "type": "string"
-        },
-        "status": {
-          "type": "string"
-        }
-      },
-      "type": "object"
-    },
-    "type": "array"
-  }
-}

changedOutput schema / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "created_at": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "creation_snapshot": {
-        "properties": {
-          "ad_account_id": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "ad_copies": {
-            "items": {
-              "properties": {
-                "ad_id": {
-                  "type": "string"
-                },
-                "adset_id": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "availability": {
-                  "enum": [
-                    "available",
-                    "partial",
-                    "unavailable"
-                  ]
-                },
-                "body": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "captured_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "description": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "name": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "reason": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "source": {
-                  "const": "task_creation_snapshot"
-                },
-                "submitted_copy": {
-                  "properties": {
-                    "availability": {
-                      "type": "string"
-                    },
-                    "body": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "description": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "reason": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "source": {
-                      "type": "string"
-                    },
-                    "source_ad_id": {
-                      "type": "string"
-                    },
-                    "submitted_at": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    },
-                    "title": {
-                      "type": [
-                        "string",
-                        "null"
-                      ]
-                    }
-                  },
-                  "type": "object"
-                },
-                "title": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "required": [
-                "ad_id",
-                "source",
-                "captured_at",
-                "availability",
-                "reason",
-                "title",
-                "body",
-                "description"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "ad_copies_generation": {
-            "type": "string"
-          },
-          "ad_copies_next_offset": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "ad_copies_next_request": {
-            "properties": {
-              "copy_generation": {
-                "type": "string"
-              },
-              "copy_offset": {
-                "type": "integer"
-              },
-              "include_live": {
-                "const": false
-              }
-            },
-            "required": [
-              "copy_offset",
-              "copy_generation",
-              "include_live"
-            ],
-            "type": [
-              "null",
-              "object"
-            ]
-          },
-          "ad_copies_total": {
-            "type": "integer"
-          },
-          "adsets": {
-            "items": {
-              "properties": {
-                "campaign_id": {
-                  "type": "string"
-                },
-                "fingerprint": {
-                  "type": "string"
-                },
-                "id": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                },
-                "source": {
-                  "type": "string"
-                },
-                "status": {
-                  "type": "string"
-                },
-                "targeting": {
-                  "properties": {
-                    "age_max": {
-                      "type": "integer"
-                    },
-                    "age_min": {
-                      "type": "integer"
-                    },
-                    "countries": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "genders": {
-                      "items": {
-                        "type": "integer"
-                      },
-                      "type": "array"
-                    }
-                  },
-                  "type": "object"
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "captured_at": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "created_objects": {
-            "properties": {
-              "ads": {
-                "$ref": "#/$defs/s9"
-              },
-              "adsets": {
-                "$ref": "#/$defs/s9"
-              },
-              "campaigns": {
-                "$ref": "#/$defs/s9"
-              }
-            },
-            "required": [
-              "campaigns",
-              "adsets",
-              "ads"
-            ],
-            "type": "object"
-          },
-          "failures": {
-            "$ref": "#/$defs/s1"
-          },
-          "source": {
-            "const": "task_creation_snapshot"
-          },
-          "task_ref": {
-            "type": "string"
-          },
-          "task_type": {
-            "type": "string"
-          },
-          "template_name": {
-            "type": [
-              "string",
-              "null"
-            ]
-          }
-        },
-        "required": [
-          "source",
-          "adsets",
-          "created_objects"
-        ],
-        "type": "object"
-      },
-      "execution_summary": {
-        "properties": {
-          "action": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "ad_account_id": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "created": {
-            "$ref": "#/$defs/s0"
-          },
-          "error": {
-            "properties": {
-              "automatic_retry_allowed": {
-                "type": "boolean"
-              },
-              "category": {
-                "type": "string"
-              },
-              "code": {
-                "type": "string"
-              },
-              "message": {
-                "type": "string"
-              },
-              "operator_review_required": {
-                "type": "boolean"
-              },
-              "request_sent": {
-                "type": "boolean"
-              },
-              "retry_exhausted": {
-                "type": "boolean"
-              },
-              "retryable": {
-                "type": "boolean"
-              },
-              "support_ref": {
-                "type": "string"
-              }
-            },
-            "type": [
-              "null",
-              "object",
-              "string"
-            ]
-          },
-          "error_count": {
-            "type": "integer"
-          },
-          "failures": {
-            "$ref": "#/$defs/s1"
-          },
-          "operator_review_required": {
-            "type": "boolean"
-          },
-          "outcome": {
-            "properties": {
-              "created_count_line": {
-                "type": "string"
-              },
-              "summary_line": {
-                "type": "string"
-              },
-              "terminal_status": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "planned": {
-            "$ref": "#/$defs/s0"
-          }
-        },
-        "type": "object"
-      },
-      "finished_at": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "live_snapshot": {
-        "properties": {
-          "ad_account_id": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "adsets": {
-            "items": {
-              "properties": {
-                "campaign_id": {
-                  "type": "string"
-                },
-                "fingerprint": {
-                  "type": "string"
-                },
-                "id": {
-                  "type": "string"
-                },
-                "name": {
-                  "type": "string"
-                },
-                "source": {
-                  "type": "string"
-                },
-                "status": {
-                  "type": "string"
-                },
-                "targeting": {
-                  "properties": {
-                    "age_max": {
-                      "type": "integer"
-                    },
-                    "age_min": {
-                      "type": "integer"
-                    },
-                    "countries": {
-                      "items": {
-                        "type": "string"
-                      },
-                      "type": "array"
-                    },
-                    "genders": {
-                      "items": {
-                        "type": "integer"
-                      },
-                      "type": "array"
-                    }
-                  },
-                  "type": "object"
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "available": {
-            "type": "boolean"
-          },
-          "errors": {
-            "items": {
-              "properties": {
-                "adset_id": {
-                  "type": "string"
-                },
-                "message": {
-                  "type": "string"
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "fetched_at": {
-            "type": "string"
-          },
-          "reason": {
-            "type": "string"
-          },
-          "source": {
-            "const": "meta_live"
-          }
-        },
-        "required": [
-          "source",
-          "available",
-          "adsets"
-        ],
-        "type": "object"
-      },
-      "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"
-      },
-      "started_at": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "status": {
-        "type": "string"
-      },
-      "task_ref": {
-        "type": "string"
-      },
-      "task_type": {
-        "type": "string"
-      },
-      "terminal": {
-        "type": "boolean"
-      }
-    },
-    "required": [
-      "task_type",
-      "status",
-      "terminal",
-      "creation_snapshot"
-    ]
-  },
-  {
-    "properties": {
-      "result_page": {
-        "additionalProperties": false,
-        "properties": {
-          "byte_length": {
-            "minimum": 0,
-            "type": "integer"
-          },
-          "byte_offset": {
-            "minimum": 0,
-            "type": "integer"
-          },
-          "complete": {
-            "description": "Frozen result bytes retrieved, not source completeness.",
-            "type": "boolean"
-          },
-          "data_base64url": {
-            "type": "string"
-          },
-          "encoding": {
-            "const": "mcp-call-tool-result-json-utf8+base64url"
-          },
-          "expires_at": {
-            "type": "string"
-          },
-          "next_cursor": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "segment_sha256": {
-            "type": "string"
-          },
-          "sha256": {
-            "type": "string"
-          },
-          "snapshot_ref": {
-            "type": "string"
-          },
-          "total_bytes": {
-            "minimum": 0,
-            "type": "integer"
-          },
-          "version": {
-            "const": 1
-          }
-        },
-        "required": [
-          "version",
-          "encoding",
-          "snapshot_ref",
-          "sha256",
-          "segment_sha256",
-          "data_base64url",
-          "expires_at",
-          "byte_offset",
-          "byte_length",
-          "total_bytes",
-          "next_cursor",
-          "complete"
-        ],
-        "type": "object"
-      }
-    },
-    "required": [
-      "result_page"
-    ]
-  }
-]New value: +[
+  {
+    "required": [
+      "creation_snapshot",
+      "status",
+      "task_type",
+      "terminal"
+    ]
+  },
+  {
+    "required": [
+      "result_page"
+    ]
+  }
+]

addedOutput schema / else / properties

Added value: +{
+  "created_at": {
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "creation_snapshot": {
+    "properties": {
+      "ad_account_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "ad_copies": {
+        "items": {
+          "properties": {
+            "ad_id": {
+              "type": "string"
+            },
+            "adset_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "availability": {
+              "enum": [
+                "available",
+                "partial",
+                "unavailable"
+              ]
+            },
+            "body": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "captured_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "description": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "reason": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "source": {
+              "const": "task_creation_snapshot"
+            },
+            "submitted_copy": {
+              "properties": {
+                "availability": {
+                  "type": "string"
+                },
+                "body": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "description": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "reason": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "source": {
+                  "type": "string"
+                },
+                "source_ad_id": {
+                  "type": "string"
+                },
+                "submitted_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "title": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "title": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "required": [
+            "ad_id",
+            "source",
+            "captured_at",
+            "availability",
+            "reason",
+            "title",
+            "body",
+            "description"
+          ],
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "ad_copies_generation": {
+        "type": "string"
+      },
+      "ad_copies_next_offset": {
+        "type": [
+          "integer",
+          "null"
+        ]
+      },
+      "ad_copies_next_request": {
+        "properties": {
+          "copy_generation": {
+            "type": "string"
+          },
+          "copy_offset": {
+            "type": "integer"
+          },
+          "include_live": {
+            "const": false
+          }
+        },
+        "required": [
+          "copy_offset",
+          "copy_generation",
+          "include_live"
+        ],
+        "type": [
+          "null",
+          "object"
+        ]
+      },
+      "ad_copies_total": {
+        "type": "integer"
+      },
+      "adsets": {
+        "items": {
+          "properties": {
+            "campaign_id": {
+              "type": "string"
+            },
+            "fingerprint": {
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            },
+            "source": {
+              "type": "string"
+            },
+            "status": {
+              "type": "string"
+            },
+            "targeting": {
+              "properties": {
+                "age_max": {
+                  "type": "integer"
+                },
+                "age_min": {
+                  "type": "integer"
+                },
+                "countries": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "genders": {
+                  "items": {
+                    "type": "integer"
+                  },
+                  "type": "array"
+                }
+              },
+              "type": "object"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "captured_at": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "created_objects": {
+        "properties": {
+          "ads": {
+            "items": {
+              "properties": {
+                "ad_id": {
+                  "type": "string"
+                },
+                "adset_id": {
+                  "type": "string"
+                },
+                "campaign_id": {
+                  "type": "string"
+                },
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "status": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "adsets": {
+            "items": {
+              "properties": {
+                "ad_id": {
+                  "type": "string"
+                },
+                "adset_id": {
+                  "type": "string"
+                },
+                "campaign_id": {
+                  "type": "string"
+                },
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "status": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "campaigns": {
+            "items": {
+              "properties": {
+                "ad_id": {
+                  "type": "string"
+                },
+                "adset_id": {
+                  "type": "string"
+                },
+                "campaign_id": {
+                  "type": "string"
+                },
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "status": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "required": [
+          "campaigns",
+          "adsets",
+          "ads"
+        ],
+        "type": "object"
+      },
+      "failures": {
+        "properties": {
+          "count": {
+            "type": "integer"
+          },
+          "items": {
+            "items": {
+              "properties": {
+                "ad_id": {
+                  "type": "string"
+                },
+                "ad_name": {
+                  "type": "string"
+                },
+                "automatic_retry_allowed": {
+                  "type": "boolean"
+                },
+                "category": {
+                  "type": "string"
+                },
+                "code": {
+                  "type": "string"
+                },
+                "message": {
+                  "type": "string"
+                },
+                "next_action": {
+                  "properties": {
+                    "arguments": {
+                      "properties": {
+                        "mutation_ref": {
+                          "type": "string"
+                        },
+                        "response_mode": {
+                          "type": "string"
+                        },
+                        "task_ref": {
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "instruction": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "tool": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "type": "string"
+                    }
+                  },
+                  "type": [
+                    "null",
+                    "object",
+                    "string"
+                  ]
+                },
+                "operator_review_required": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "truncated": {
+            "type": "boolean"
+          }
+        },
+        "type": "object"
+      },
+      "source": {
+        "const": "task_creation_snapshot"
+      },
+      "task_ref": {
+        "type": "string"
+      },
+      "task_type": {
+        "type": "string"
+      },
+      "template_name": {
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "source",
+      "adsets",
+      "created_objects"
+    ],
+    "type": "object"
+  },
+  "execution_summary": {
+    "properties": {
+      "action": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "ad_account_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "created": {
+        "properties": {
+          "ad_count": {
+            "type": "integer"
+          },
+          "ads_per_adset": {
+            "type": "integer"
+          },
+          "adset_count": {
+            "type": "integer"
+          },
+          "adsets_per_campaign": {
+            "type": "integer"
+          },
+          "campaign_count": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "error": {
+        "properties": {
+          "automatic_retry_allowed": {
+            "type": "boolean"
+          },
+          "category": {
+            "type": "string"
+          },
+          "code": {
+            "type": "string"
+          },
+          "message": {
+            "type": "string"
+          },
+          "operator_review_required": {
+            "type": "boolean"
+          },
+          "request_sent": {
+            "type": "boolean"
+          },
+          "retry_exhausted": {
+            "type": "boolean"
+          },
+          "retryable": {
+            "type": "boolean"
+          },
+          "support_ref": {
+            "type": "string"
+          }
+        },
+        "type": [
+          "null",
+          "object",
+          "string"
+        ]
+      },
+      "error_count": {
+        "type": "integer"
+      },
+      "failures": {
+        "properties": {
+          "count": {
+            "type": "integer"
+          },
+          "items": {
+            "items": {
+              "properties": {
+                "ad_id": {
+                  "type": "string"
+                },
+                "ad_name": {
+                  "type": "string"
+                },
+                "automatic_retry_allowed": {
+                  "type": "boolean"
+                },
+                "category": {
+                  "type": "string"
+                },
+                "code": {
+                  "type": "string"
+                },
+                "message": {
+                  "type": "string"
+                },
+                "next_action": {
+                  "properties": {
+                    "arguments": {
+                      "properties": {
+                        "mutation_ref": {
+                          "type": "string"
+                        },
+                        "response_mode": {
+                          "type": "string"
+                        },
+                        "task_ref": {
+                          "type": "string"
+                        }
+                      },
+                      "type": "object"
+                    },
+                    "instruction": {
+                      "type": "string"
+                    },
+                    "name": {
+                      "type": "string"
+                    },
+                    "tool": {
+                      "type": "string"
+                    },
+                    "type": {
+                      "type": "string"
+                    }
+                  },
+                  "type": [
+                    "null",
+                    "object",
+                    "string"
+                  ]
+                },
+                "operator_review_required": {
+                  "type": "boolean"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "truncated": {
+            "type": "boolean"
+          }
+        },
+        "type": "object"
+      },
+      "operator_review_required": {
+        "type": "boolean"
+      },
+      "outcome": {
+        "properties": {
+          "created_count_line": {
+            "type": "string"
+          },
+          "summary_line": {
+            "type": "string"
+          },
+          "terminal_status": {
+            "type": "string"
+          }
+        },
+        "type": "object"
+      },
+      "planned": {
+        "properties": {
+          "ad_count": {
+            "type": "integer"
+          },
+          "ads_per_adset": {
+            "type": "integer"
+          },
+          "adset_count": {
+            "type": "integer"
+          },
+          "adsets_per_campaign": {
+            "type": "integer"
+          },
+          "campaign_count": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      }
+    },
+    "type": "object"
+  },
+  "finished_at": {
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "live_snapshot": {
+    "properties": {
+      "ad_account_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "adsets": {
+        "items": {
+          "properties": {
+            "campaign_id": {
+              "type": "string"
+            },
+            "fingerprint": {
+              "type": "string"
+            },
+            "id": {
+              "type": "string"
+            },
+            "name": {
+              "type": "string"
+            },
+            "source": {
+              "type": "string"
+            },
+            "status": {
+              "type": "string"
+            },
+            "targeting": {
+              "properties": {
+                "age_max": {
+                  "type": "integer"
+                },
+                "age_min": {
+                  "type": "integer"
+                },
+                "countries": {
+                  "items": {
+                    "type": "string"
+                  },
+                  "type": "array"
+                },
+                "genders": {
+                  "items": {
+                    "type": "integer"
+                  },
+                  "type": "array"
+                }
+              },
+              "type": "object"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "available": {
+        "type": "boolean"
+      },
+      "errors": {
+        "items": {
+          "properties": {
+            "adset_id": {
+              "type": "string"
+            },
+            "message": {
+              "type": "string"
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "fetched_at": {
+        "type": "string"
+      },
+      "reason": {
+        "type": "string"
+      },
+      "source": {
+        "const": "meta_live"
+      }
+    },
+    "required": [
+      "source",
+      "available",
+      "adsets"
+    ],
+    "type": "object"
+  },
+  "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"
+  },
+  "result_page": {
+    "additionalProperties": false,
+    "properties": {
+      "byte_length": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "byte_offset": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "complete": {
+        "description": "Frozen result bytes retrieved, not source completeness.",
+        "type": "boolean"
+      },
+      "data_base64url": {
+        "type": "string"
+      },
+      "encoding": {
+        "const": "mcp-call-tool-result-json-utf8+base64url"
+      },
+      "expires_at": {
+        "type": "string"
+      },
+      "next_cursor": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "segment_sha256": {
+        "type": "string"
+      },
+      "sha256": {
+        "type": "string"
+      },
+      "snapshot_ref": {
+        "type": "string"
+      },
+      "total_bytes": {
+        "minimum": 0,
+        "type": "integer"
+      },
+      "version": {
+        "const": 1
+      }
+    },
+    "required": [
+      "version",
+      "encoding",
+      "snapshot_ref",
+      "sha256",
+      "segment_sha256",
+      "data_base64url",
+      "expires_at",
+      "byte_offset",
+      "byte_length",
+      "total_bytes",
+      "next_cursor",
+      "complete"
+    ],
+    "type": "object"
+  },
+  "started_at": {
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "status": {
+    "type": "string"
+  },
+  "task_ref": {
+    "type": "string"
+  },
+  "task_type": {
+    "type": "string"
+  },
+  "terminal": {
+    "type": "boolean"
+  }
+}

Changed6 schema fields changedOct 15, 2026
- addedOutput schema / then / properties / category
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / then / properties / expected
```
Added value: +{
+  "type": "boolean"
+}
```
- addedOutput schema / then / properties / failure_kind
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / then / properties / responsibility_hint
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / then / properties / route
```
Added value: +{
+  "type": "string"
+}
```
- addedOutput schema / 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"
+}
```

Changed4 schema fields changedOct 7, 2026

addedInput schema / properties / result_cursor
```
Added value: +{
+  "type": "string"
+}
```

addedOutput schema / else / anyOf

Added value: +[
+  {
+    "properties": {
+      "created_at": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "creation_snapshot": {
+        "properties": {
+          "ad_account_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "ad_copies": {
+            "items": {
+              "properties": {
+                "ad_id": {
+                  "type": "string"
+                },
+                "adset_id": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "availability": {
+                  "enum": [
+                    "available",
+                    "partial",
+                    "unavailable"
+                  ]
+                },
+                "body": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "captured_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "description": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "name": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "reason": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "source": {
+                  "const": "task_creation_snapshot"
+                },
+                "submitted_copy": {
+                  "properties": {
+                    "availability": {
+                      "type": "string"
+                    },
+                    "body": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "description": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "reason": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "source": {
+                      "type": "string"
+                    },
+                    "source_ad_id": {
+                      "type": "string"
+                    },
+                    "submitted_at": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    },
+                    "title": {
+                      "type": [
+                        "string",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                },
+                "title": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "required": [
+                "ad_id",
+                "source",
+                "captured_at",
+                "availability",
+                "reason",
+                "title",
+                "body",
+                "description"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "ad_copies_generation": {
+            "type": "string"
+          },
+          "ad_copies_next_offset": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "ad_copies_next_request": {
+            "properties": {
+              "copy_generation": {
+                "type": "string"
+              },
+              "copy_offset": {
+                "type": "integer"
+              },
+              "include_live": {
+                "const": false
+              }
+            },
+            "required": [
+              "copy_offset",
+              "copy_generation",
+              "include_live"
+            ],
+            "type": [
+              "null",
+              "object"
+            ]
+          },
+          "ad_copies_total": {
+            "type": "integer"
+          },
+          "adsets": {
+            "items": {
+              "properties": {
+                "campaign_id": {
+                  "type": "string"
+                },
+                "fingerprint": {
+                  "type": "string"
+                },
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "source": {
+                  "type": "string"
+                },
+                "status": {
+                  "type": "string"
+                },
+                "targeting": {
+                  "properties": {
+                    "age_max": {
+                      "type": "integer"
+                    },
+                    "age_min": {
+                      "type": "integer"
+                    },
+                    "countries": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "genders": {
+                      "items": {
+                        "type": "integer"
+                      },
+                      "type": "array"
+                    }
+                  },
+                  "type": "object"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "captured_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "created_objects": {
+            "properties": {
+              "ads": {
+                "$ref": "#/$defs/s9"
+              },
+              "adsets": {
+                "$ref": "#/$defs/s9"
+              },
+              "campaigns": {
+                "$ref": "#/$defs/s9"
+              }
+            },
+            "required": [
+              "campaigns",
+              "adsets",
+              "ads"
+            ],
+            "type": "object"
+          },
+          "failures": {
+            "$ref": "#/$defs/s1"
+          },
+          "source": {
+            "const": "task_creation_snapshot"
+          },
+          "task_ref": {
+            "type": "string"
+          },
+          "task_type": {
+            "type": "string"
+          },
+          "template_name": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "source",
+          "adsets",
+          "created_objects"
+        ],
+        "type": "object"
+      },
+      "execution_summary": {
+        "properties": {
+          "action": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "ad_account_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "created": {
+            "$ref": "#/$defs/s0"
+          },
+          "error": {
+            "properties": {
+              "automatic_retry_allowed": {
+                "type": "boolean"
+              },
+              "category": {
+                "type": "string"
+              },
+              "code": {
+                "type": "string"
+              },
+              "message": {
+                "type": "string"
+              },
+              "operator_review_required": {
+                "type": "boolean"
+              },
+              "request_sent": {
+                "type": "boolean"
+              },
+              "retry_exhausted": {
+                "type": "boolean"
+              },
+              "retryable": {
+                "type": "boolean"
+              },
+              "support_ref": {
+                "type": "string"
+              }
+            },
+            "type": [
+              "null",
+              "object",
+              "string"
+            ]
+          },
+          "error_count": {
+            "type": "integer"
+          },
+          "failures": {
+            "$ref": "#/$defs/s1"
+          },
+          "operator_review_required": {
+            "type": "boolean"
+          },
+          "outcome": {
+            "properties": {
+              "created_count_line": {
+                "type": "string"
+              },
+              "summary_line": {
+                "type": "string"
+              },
+              "terminal_status": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "planned": {
+            "$ref": "#/$defs/s0"
+          }
+        },
+        "type": "object"
+      },
+      "finished_at": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "live_snapshot": {
+        "properties": {
+          "ad_account_id": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "adsets": {
+            "items": {
+              "properties": {
+                "campaign_id": {
+                  "type": "string"
+                },
+                "fingerprint": {
+                  "type": "string"
+                },
+                "id": {
+                  "type": "string"
+                },
+                "name": {
+                  "type": "string"
+                },
+                "source": {
+                  "type": "string"
+                },
+                "status": {
+                  "type": "string"
+                },
+                "targeting": {
+                  "properties": {
+                    "age_max": {
+                      "type": "integer"
+                    },
+                    "age_min": {
+                      "type": "integer"
+                    },
+                    "countries": {
+                      "items": {
+                        "type": "string"
+                      },
+                      "type": "array"
+                    },
+                    "genders": {
+                      "items": {
+                        "type": "integer"
+                      },
+                      "type": "array"
+                    }
+                  },
+                  "type": "object"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "available": {
+            "type": "boolean"
+          },
+          "errors": {
+            "items": {
+              "properties": {
+                "adset_id": {
+                  "type": "string"
+                },
+                "message": {
+                  "type": "string"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "fetched_at": {
+            "type": "string"
+          },
+          "reason": {
+            "type": "string"
+          },
+          "source": {
+            "const": "meta_live"
+          }
+        },
+        "required": [
+          "source",
+          "available",
+          "adsets"
+        ],
+        "type": "object"
+      },
+      "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"
+      },
+      "started_at": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "status": {
+        "type": "string"
+      },
+      "task_ref": {
+        "type": "string"
+      },
+      "task_type": {
+        "type": "string"
+      },
+      "terminal": {
+        "type": "boolean"
+      }
+    },
+    "required": [
+      "task_type",
+      "status",
+      "terminal",
+      "creation_snapshot"
+    ]
+  },
+  {
+    "properties": {
+      "result_page": {
+        "additionalProperties": false,
+        "properties": {
+          "byte_length": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "byte_offset": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "complete": {
+            "description": "Frozen result bytes retrieved, not source completeness.",
+            "type": "boolean"
+          },
+          "data_base64url": {
+            "type": "string"
+          },
+          "encoding": {
+            "const": "mcp-call-tool-result-json-utf8+base64url"
+          },
+          "expires_at": {
+            "type": "string"
+          },
+          "next_cursor": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "segment_sha256": {
+            "type": "string"
+          },
+          "sha256": {
+            "type": "string"
+          },
+          "snapshot_ref": {
+            "type": "string"
+          },
+          "total_bytes": {
+            "minimum": 0,
+            "type": "integer"
+          },
+          "version": {
+            "const": 1
+          }
+        },
+        "required": [
+          "version",
+          "encoding",
+          "snapshot_ref",
+          "sha256",
+          "segment_sha256",
+          "data_base64url",
+          "expires_at",
+          "byte_offset",
+          "byte_length",
+          "total_bytes",
+          "next_cursor",
+          "complete"
+        ],
+        "type": "object"
+      }
+    },
+    "required": [
+      "result_page"
+    ]
+  }
+]

removedOutput schema / else / properties

Removed value: -{
-  "created_at": {
-    "type": [
-      "string",
-      "null"
-    ]
-  },
-  "creation_snapshot": {
-    "properties": {
-      "ad_account_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "ad_copies": {
-        "items": {
-          "properties": {
-            "ad_id": {
-              "type": "string"
-            },
-            "adset_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "availability": {
-              "enum": [
-                "available",
-                "partial",
-                "unavailable"
-              ]
-            },
-            "body": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "captured_at": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "description": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "reason": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "source": {
-              "const": "task_creation_snapshot"
-            },
-            "submitted_copy": {
-              "properties": {
-                "availability": {
-                  "type": "string"
-                },
-                "body": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "description": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "reason": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "source": {
-                  "type": "string"
-                },
-                "source_ad_id": {
-                  "type": "string"
-                },
-                "submitted_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "title": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "title": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "required": [
-            "ad_id",
-            "source",
-            "captured_at",
-            "availability",
-            "reason",
-            "title",
-            "body",
-            "description"
-          ],
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "ad_copies_generation": {
-        "type": "string"
-      },
-      "ad_copies_next_offset": {
-        "type": [
-          "integer",
-          "null"
-        ]
-      },
-      "ad_copies_next_request": {
-        "properties": {
-          "copy_generation": {
-            "type": "string"
-          },
-          "copy_offset": {
-            "type": "integer"
-          },
-          "include_live": {
-            "const": false
-          }
-        },
-        "required": [
-          "copy_offset",
-          "copy_generation",
-          "include_live"
-        ],
-        "type": [
-          "null",
-          "object"
-        ]
-      },
-      "ad_copies_total": {
-        "type": "integer"
-      },
-      "adsets": {
-        "items": {
-          "properties": {
-            "campaign_id": {
-              "type": "string"
-            },
-            "fingerprint": {
-              "type": "string"
-            },
-            "id": {
-              "type": "string"
-            },
-            "name": {
-              "type": "string"
-            },
-            "source": {
-              "type": "string"
-            },
-            "status": {
-              "type": "string"
-            },
-            "targeting": {
-              "properties": {
-                "age_max": {
-                  "type": "integer"
-                },
-                "age_min": {
-                  "type": "integer"
-                },
-                "countries": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "genders": {
-                  "items": {
-                    "type": "integer"
-                  },
-                  "type": "array"
-                }
-              },
-              "type": "object"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "captured_at": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "created_objects": {
-        "properties": {
-          "ads": {
-            "$ref": "#/$defs/s9"
-          },
-          "adsets": {
-            "$ref": "#/$defs/s9"
-          },
-          "campaigns": {
-            "$ref": "#/$defs/s9"
-          }
-        },
-        "required": [
-          "campaigns",
-          "adsets",
-          "ads"
-        ],
-        "type": "object"
-      },
-      "failures": {
-        "$ref": "#/$defs/s1"
-      },
-      "source": {
-        "const": "task_creation_snapshot"
-      },
-      "task_ref": {
-        "type": "string"
-      },
-      "task_type": {
-        "type": "string"
-      },
-      "template_name": {
-        "type": [
-          "string",
-          "null"
-        ]
-      }
-    },
-    "required": [
-      "source",
-      "adsets",
-      "created_objects"
-    ],
-    "type": "object"
-  },
-  "execution_summary": {
-    "properties": {
-      "action": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "ad_account_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "created": {
-        "$ref": "#/$defs/s0"
-      },
-      "error": {
-        "properties": {
-          "automatic_retry_allowed": {
-            "type": "boolean"
-          },
-          "category": {
-            "type": "string"
-          },
-          "code": {
-            "type": "string"
-          },
-          "message": {
-            "type": "string"
-          },
-          "operator_review_required": {
-            "type": "boolean"
-          },
-          "request_sent": {
-            "type": "boolean"
-          },
-          "retry_exhausted": {
-            "type": "boolean"
-          },
-          "retryable": {
-            "type": "boolean"
-          },
-          "support_ref": {
-            "type": "string"
-          }
-        },
-        "type": [
-          "null",
-          "object",
-          "string"
-        ]
-      },
-      "error_count": {
-        "type": "integer"
-      },
-      "failures": {
-        "$ref": "#/$defs/s1"
-      },
-      "operator_review_required": {
-        "type": "boolean"
-      },
-      "outcome": {
-        "properties": {
-          "created_count_line": {
-            "type": "string"
-          },
-          "summary_line": {
-            "type": "string"
-          },
-          "terminal_status": {
-            "type": "string"
-          }
-        },
-        "type": "object"
-      },
-      "planned": {
-        "$ref": "#/$defs/s0"
-      }
-    },
-    "type": "object"
-  },
-  "finished_at": {
-    "type": [
-      "string",
-      "null"
-    ]
-  },
-  "live_snapshot": {
-    "properties": {
-      "ad_account_id": {
-        "type": [
-          "string",
-          "null"
-        ]
-      },
-      "adsets": {
-        "items": {
-          "properties": {
-            "campaign_id": {
-              "type": "string"
-            },
-            "fingerprint": {
-              "type": "string"
-            },
-            "id": {
-              "type": "string"
-            },
-            "name": {
-              "type": "string"
-            },
-            "source": {
-              "type": "string"
-            },
-            "status": {
-              "type": "string"
-            },
-            "targeting": {
-              "properties": {
-                "age_max": {
-                  "type": "integer"
-                },
-                "age_min": {
-                  "type": "integer"
-                },
-                "countries": {
-                  "items": {
-                    "type": "string"
-                  },
-                  "type": "array"
-                },
-                "genders": {
-                  "items": {
-                    "type": "integer"
-                  },
-                  "type": "array"
-                }
-              },
-              "type": "object"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "available": {
-        "type": "boolean"
-      },
-      "errors": {
-        "items": {
-          "properties": {
-            "adset_id": {
-              "type": "string"
-            },
-            "message": {
-              "type": "string"
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "fetched_at": {
-        "type": "string"
-      },
-      "reason": {
-        "type": "string"
-      },
-      "source": {
-        "const": "meta_live"
-      }
-    },
-    "required": [
-      "source",
-      "available",
-      "adsets"
-    ],
-    "type": "object"
-  },
-  "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"
-  },
-  "started_at": {
-    "type": [
-      "string",
-      "null"
-    ]
-  },
-  "status": {
-    "type": "string"
-  },
-  "task_ref": {
-    "type": "string"
-  },
-  "task_type": {
-    "type": "string"
-  },
-  "terminal": {
-    "type": "boolean"
-  }
-}

removedOutput schema / else / required

Removed value: -[
-  "task_type",
-  "status",
-  "terminal",
-  "creation_snapshot"
-]

Changed1 schema field changedSep 19, 2026

addedOutput schema / else / properties / creation_snapshot / properties / ad_copies / items / properties / submitted_copy

Added value: +{
+  "properties": {
+    "availability": {
+      "type": "string"
+    },
+    "body": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "description": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "reason": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "source": {
+      "type": "string"
+    },
+    "source_ad_id": {
+      "type": "string"
+    },
+    "submitted_at": {
+      "type": [
+        "string",
+        "null"
+      ]
+    },
+    "title": {
+      "type": [
+        "string",
+        "null"
+      ]
+    }
+  },
+  "type": "object"
+}

Changed7 schema fields changedSep 17, 2026

addedInput schema / properties / copy_generation
```
Added value: +{
+  "type": "string"
+}
```

addedInput schema / properties / copy_offset

Added value: +{
+  "default": 0,
+  "type": "integer"
+}

addedOutput schema / else / properties / creation_snapshot / properties / ad_copies

Added value: +{
+  "items": {
+    "properties": {
+      "ad_id": {
+        "type": "string"
+      },
+      "adset_id": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "availability": {
+        "enum": [
+          "available",
+          "partial",
+          "unavailable"
+        ]
+      },
+      "body": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "captured_at": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "description": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "name": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "reason": {
+        "type": [
+          "string",
+          "null"
+        ]
+      },
+      "source": {
+        "const": "task_creation_snapshot"
+      },
+      "title": {
+        "type": [
+          "string",
+          "null"
+        ]
+      }
+    },
+    "required": [
+      "ad_id",
+      "source",
+      "captured_at",
+      "availability",
+      "reason",
+      "title",
+      "body",
+      "description"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / else / properties / creation_snapshot / properties / ad_copies_generation
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / else / properties / creation_snapshot / properties / ad_copies_next_offset
```
Added value: +{
+  "type": [
+    "integer",
+    "null"
+  ]
+}
```

addedOutput schema / else / properties / creation_snapshot / properties / ad_copies_next_request

Added value: +{
+  "properties": {
+    "copy_generation": {
+      "type": "string"
+    },
+    "copy_offset": {
+      "type": "integer"
+    },
+    "include_live": {
+      "const": false
+    }
+  },
+  "required": [
+    "copy_offset",
+    "copy_generation",
+    "include_live"
+  ],
+  "type": [
+    "null",
+    "object"
+  ]
+}

addedOutput schema / else / properties / creation_snapshot / properties / ad_copies_total
```
Added value: +{
+  "type": "integer"
+}
```

First observedSep 9, 2026

TDQS

B3.2/5.0

Behavior3/5

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

Adds real value beyond the annotations by clarifying that the call does not rerun the task or change ads, and that live targeting reads are scoped to authorized Meta accounts. However, it says nothing about how "failures" are surfaced, whether results are paginated, or how much data a single call returns.

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

Conciseness4/5

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

Two tight sentences with the primary read stated first and the include_live caveat second; no filler. Slightly dense in the second sentence but front-loaded and scannable.

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 annotations cover the safety profile. Still, for a 5-parameter tool with zero schema descriptions, the absence of any pagination or cursor guidance leaves a real gap an agent will hit on the first call.

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% across 5 parameters, yet the description only explains include_live. task_ref, copy_offset, result_cursor, and copy_generation (almost certainly pagination and version-selection parameters) get no explanation anywhere, leaving the agent to guess at iteration behavior.

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

Purpose4/5

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

States a specific verb ("Read") and resource ("your create/copy task's saved ad copy and failures"), which distinguishes it from status/history siblings like tasks_get_status and tasks_list_create_history. It could be sharper about the fact that this is the detail/result view of a single task.

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

Usage Guidelines3/5

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

Usage is implied — read saved output of a create/copy task — but no sibling is named and no condition of use is spelled out (e.g., "use tasks_get_status to check progress, this tool to read finished output"). Only the include_live branch is explained.

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?