AdsAgent — Meta Ads MCP

console_query_overview

Read-only

Read a stored dashboard page in USD

Input Schema

TableJSON Schema

Name	Required	Default
`page`	No
`scope`	Yes
`search`	No
`date_to`	Yes
`group_by`	Yes
`sort_dir`	No	desc
`sort_key`	No	spend
`date_from`	Yes
`page_size`	No
`view_mode`	No	grouped
`management`	No
`attribution`	No
`result_cursor`	No
`status_filter`	No
`inventory_anchor`	No
`connection_context`	No
`metadata_contract_version`	No
`include_zero_insight_entities`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
`message`	No
`retryable`	No
`support_ref`	No

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 15, 2026

changedOutput schema / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "daily": {
-        "items": {
-          "properties": {
-            "ad_account_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "bid_amount": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "bid_strategy": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "budget_level": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "clicks": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "configured_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "configured_status_observed_at": {
-              "$ref": "#/$defs/s9"
-            },
-            "conversion_value": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "conversions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpa": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpc": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpm": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "ctr": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "currency": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "daily_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "data_as_of_date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_start": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_stop": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "delivery_issue_codes": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "delivery_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "effective_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "funnel": {
-              "$ref": "#/$defs/s8"
-            },
-            "funnel_observation": {
-              "$ref": "#/$defs/sa"
-            },
-            "historical_result": {
-              "$ref": "#/$defs/s7"
-            },
-            "id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "impressions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "lifetime_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "metric_completeness": {
-              "$ref": "#/$defs/s0"
-            },
-            "money_unit": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "optimization_goal": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "product_type": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "reach": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "result_segments": {
-              "$ref": "#/$defs/s2"
-            },
-            "roas": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "source_observed_at": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "spend": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "spend_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "effective_attribution": {
-        "type": "string"
-      },
-      "funnel_events": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "funnel_semantics": {
-        "properties": {
-          "coverage_requirement": {
-            "const": "verify_insights_and_source_coverage"
-          },
-          "empty_funnel_interpretation": {
-            "const": "no_selected_events_returned_not_zero_proof"
-          },
-          "missing_event_implies_missing_insights": {
-            "const": false
-          },
-          "missing_event_is_zero": {
-            "const": false
-          },
-          "read_coverage_scope": {
-            "const": "query_result_not_upstream_ingestion"
-          },
-          "representation": {
-            "const": "sparse"
-          }
-        },
-        "type": "object"
-      },
-      "items": {
-        "items": {
-          "properties": {
-            "ad_account_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "bid_amount": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "bid_strategy": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "budget_level": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "clicks": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "configured_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "configured_status_observed_at": {
-              "$ref": "#/$defs/s9"
-            },
-            "conversion_value": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "conversions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpa": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpc": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpm": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "ctr": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "currency": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "daily_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "data_as_of_date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_start": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_stop": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "delivery_issue_codes": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "delivery_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "effective_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "funnel": {
-              "$ref": "#/$defs/s8"
-            },
-            "funnel_observation": {
-              "$ref": "#/$defs/sa"
-            },
-            "historical_result": {
-              "$ref": "#/$defs/s7"
-            },
-            "id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "impressions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "lifetime_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "media": {
-              "additionalProperties": false,
-              "properties": {
-                "media_type": {
-                  "enum": [
-                    "image",
-                    "video",
-                    null
-                  ]
-                },
-                "poster_url": {
-                  "description": "Temporary signed cover URL; never a persistent media identity or video playback URL.",
-                  "format": "uri",
-                  "pattern": "^https://",
-                  "type": "string"
-                },
-                "source_observed_at": {
-                  "format": "date-time",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "status": {
-                  "enum": [
-                    "pending",
-                    "ready",
-                    "unavailable",
-                    "failed"
-                  ]
-                },
-                "url_expires_at": {
-                  "format": "date-time",
-                  "type": "string"
-                },
-                "version": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "required": [
-                "status"
-              ],
-              "type": "object"
-            },
-            "metric_completeness": {
-              "$ref": "#/$defs/s0"
-            },
-            "money_unit": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "optimization_goal": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "product_type": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "reach": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "result_segments": {
-              "$ref": "#/$defs/s2"
-            },
-            "roas": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "source_observed_at": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "spend": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "spend_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "meta": {
-        "properties": {
-          "cache_hit": {
-            "type": "boolean"
-          },
-          "coalesced": {
-            "type": "boolean"
-          },
-          "complete": {
-            "type": "boolean"
-          },
-          "data_as_of_date": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "data_freshness": {
-            "properties": {
-              "interval_min": {
-                "type": "integer"
-              },
-              "label": {
-                "type": "string"
-              },
-              "last_pull_failed_account_count": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              },
-              "last_pull_scope": {
-                "const": "workspace"
-              },
-              "last_pull_status": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "last_pulled_at": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "max_staleness_min": {
-                "type": "integer"
-              },
-              "server_now_utc": {
-                "type": "string"
-              },
-              "staleness_seconds": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              }
-            },
-            "type": "object"
-          },
-          "duration_ms": {
-            "type": "integer"
-          },
-          "failed": {
-            "type": "integer"
-          },
-          "freshness_warnings": {
-            "items": {
-              "properties": {
-                "account_count": {
-                  "type": "integer"
-                },
-                "code": {
-                  "type": "string"
-                },
-                "dispersion_seconds": {
-                  "type": "integer"
-                },
-                "last_pull_failed_account_count": {
-                  "type": [
-                    "integer",
-                    "null"
-                  ]
-                },
-                "last_pull_status": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "message": {
-                  "type": "string"
-                },
-                "metrics_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "newest_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "observed_account_count": {
-                  "type": "integer"
-                },
-                "oldest_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "funnel_incomplete": {
-            "type": "boolean"
-          },
-          "funnel_read_coverage": {
-            "properties": {
-              "complete": {
-                "type": "boolean"
-              },
-              "reason": {
-                "type": "string"
-              },
-              "source": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "has_more": {
-            "type": "boolean"
-          },
-          "item_count": {
-            "type": "integer"
-          },
-          "limitations": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "metric_completeness": {
-            "$ref": "#/$defs/s0"
-          },
-          "metrics_source_observed_at": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "missing_scopes": {
-            "items": {
-              "properties": {
-                "index": {
-                  "type": "integer"
-                },
-                "status": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "status"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "next_cursor": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "page": {
-            "type": "integer"
-          },
-          "page_size": {
-            "type": "integer"
-          },
-          "refresh_reused": {
-            "type": "boolean"
-          },
-          "returned_count": {
-            "type": "integer"
-          },
-          "scope_count": {
-            "type": "integer"
-          },
-          "source": {
-            "type": "string"
-          },
-          "source_observed_at": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "source_row_count": {
-            "type": "integer"
-          },
-          "source_truncated": {
-            "type": "boolean"
-          },
-          "source_watermark": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "standard_metrics_complete": {
-            "type": "boolean"
-          },
-          "succeeded": {
-            "type": "integer"
-          },
-          "total_count": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "total_items": {
-            "type": "integer"
-          },
-          "total_pages": {
-            "type": "integer"
-          }
-        },
-        "type": "object"
-      },
-      "summary": {
-        "properties": {
-          "clicks": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "conversion_value": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "conversions": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpa": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpc": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpm": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "ctr": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "funnel": {
-            "$ref": "#/$defs/s8"
-          },
-          "historical_result": {
-            "$ref": "#/$defs/s7"
-          },
-          "impressions": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "metric_completeness": {
-            "$ref": "#/$defs/s0"
-          },
-          "reach": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "result_segments": {
-            "$ref": "#/$defs/s2"
-          },
-          "roas": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "spend": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "spend_usd": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "type": "object"
-      }
-    },
-    "required": [
-      "items",
-      "meta"
-    ]
-  },
-  {
-    "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: +[
+  {
+    "properties": {
+      "daily": {
+        "items": {
+          "properties": {
+            "ad_account_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ad_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ad_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "adset_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "adset_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "bid_amount": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "bid_strategy": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "budget_level": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "clicks": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "configured_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "configured_status_observed_at": {
+              "$ref": "#/$defs/s9"
+            },
+            "conversion_value": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "conversions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpa": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpc": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpm": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "ctr": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "currency": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "daily_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "data_as_of_date": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_start": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_stop": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "delivery_issue_codes": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "delivery_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "effective_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "funnel": {
+              "$ref": "#/$defs/s8"
+            },
+            "funnel_observation": {
+              "$ref": "#/$defs/sa"
+            },
+            "historical_result": {
+              "$ref": "#/$defs/s7"
+            },
+            "id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "impressions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "lifetime_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "metric_completeness": {
+              "$ref": "#/$defs/s0"
+            },
+            "money_unit": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "optimization_goal": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "product_type": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "reach": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "result_segments": {
+              "$ref": "#/$defs/s2"
+            },
+            "roas": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "source_observed_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "spend": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "spend_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "effective_attribution": {
+        "type": "string"
+      },
+      "funnel_events": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "funnel_semantics": {
+        "properties": {
+          "coverage_requirement": {
+            "const": "verify_insights_and_source_coverage"
+          },
+          "empty_funnel_interpretation": {
+            "const": "no_selected_events_returned_not_zero_proof"
+          },
+          "missing_event_implies_missing_insights": {
+            "const": false
+          },
+          "missing_event_is_zero": {
+            "const": false
+          },
+          "read_coverage_scope": {
+            "const": "query_result_not_upstream_ingestion"
+          },
+          "representation": {
+            "const": "sparse"
+          }
+        },
+        "type": "object"
+      },
+      "items": {
+        "items": {
+          "properties": {
+            "ad_account_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ad_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ad_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "adset_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "adset_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "bid_amount": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "bid_strategy": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "budget_level": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "clicks": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "configured_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "configured_status_observed_at": {
+              "$ref": "#/$defs/s9"
+            },
+            "conversion_value": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "conversions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpa": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpc": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpm": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "ctr": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "currency": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "daily_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "data_as_of_date": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_start": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_stop": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "delivery_issue_codes": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "delivery_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "effective_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "funnel": {
+              "$ref": "#/$defs/s8"
+            },
+            "funnel_observation": {
+              "$ref": "#/$defs/sa"
+            },
+            "historical_result": {
+              "$ref": "#/$defs/s7"
+            },
+            "id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "impressions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "lifetime_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "media": {
+              "additionalProperties": false,
+              "properties": {
+                "media_type": {
+                  "enum": [
+                    "image",
+                    "video",
+                    null
+                  ]
+                },
+                "poster_url": {
+                  "description": "Temporary signed cover URL; never a persistent media identity or video playback URL.",
+                  "format": "uri",
+                  "pattern": "^https://",
+                  "type": "string"
+                },
+                "source_observed_at": {
+                  "format": "date-time",
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "status": {
+                  "enum": [
+                    "pending",
+                    "ready",
+                    "unavailable",
+                    "failed"
+                  ]
+                },
+                "url_expires_at": {
+                  "format": "date-time",
+                  "type": "string"
+                },
+                "version": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "required": [
+                "status"
+              ],
+              "type": "object"
+            },
+            "metric_completeness": {
+              "$ref": "#/$defs/s0"
+            },
+            "money_unit": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "optimization_goal": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "product_type": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "reach": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "result_segments": {
+              "$ref": "#/$defs/s2"
+            },
+            "roas": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "source_observed_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "spend": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "spend_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "meta": {
+        "properties": {
+          "cache_hit": {
+            "type": "boolean"
+          },
+          "coalesced": {
+            "type": "boolean"
+          },
+          "complete": {
+            "type": "boolean"
+          },
+          "data_as_of_date": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "data_freshness": {
+            "properties": {
+              "interval_min": {
+                "type": "integer"
+              },
+              "label": {
+                "type": "string"
+              },
+              "last_pull_failed_account_count": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              },
+              "last_pull_scope": {
+                "const": "workspace"
+              },
+              "last_pull_status": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "last_pulled_at": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "max_staleness_min": {
+                "type": "integer"
+              },
+              "server_now_utc": {
+                "type": "string"
+              },
+              "staleness_seconds": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          "duration_ms": {
+            "type": "integer"
+          },
+          "failed": {
+            "type": "integer"
+          },
+          "freshness_warnings": {
+            "items": {
+              "properties": {
+                "account_count": {
+                  "type": "integer"
+                },
+                "code": {
+                  "type": "string"
+                },
+                "dispersion_seconds": {
+                  "type": "integer"
+                },
+                "last_pull_failed_account_count": {
+                  "type": [
+                    "integer",
+                    "null"
+                  ]
+                },
+                "last_pull_status": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "message": {
+                  "type": "string"
+                },
+                "metrics_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "newest_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "observed_account_count": {
+                  "type": "integer"
+                },
+                "oldest_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "funnel_incomplete": {
+            "type": "boolean"
+          },
+          "funnel_read_coverage": {
+            "properties": {
+              "complete": {
+                "type": "boolean"
+              },
+              "reason": {
+                "type": "string"
+              },
+              "source": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "has_more": {
+            "type": "boolean"
+          },
+          "item_count": {
+            "type": "integer"
+          },
+          "limitations": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "metric_completeness": {
+            "$ref": "#/$defs/s0"
+          },
+          "metrics_source_observed_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "missing_scopes": {
+            "items": {
+              "properties": {
+                "index": {
+                  "type": "integer"
+                },
+                "status": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "index",
+                "status"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "next_cursor": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "page": {
+            "type": "integer"
+          },
+          "page_size": {
+            "type": "integer"
+          },
+          "refresh_reused": {
+            "type": "boolean"
+          },
+          "returned_count": {
+            "type": "integer"
+          },
+          "scope_count": {
+            "type": "integer"
+          },
+          "source": {
+            "type": "string"
+          },
+          "source_observed_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_row_count": {
+            "type": "integer"
+          },
+          "source_truncated": {
+            "type": "boolean"
+          },
+          "source_watermark": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "standard_metrics_complete": {
+            "type": "boolean"
+          },
+          "succeeded": {
+            "type": "integer"
+          },
+          "total_count": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "total_items": {
+            "type": "integer"
+          },
+          "total_pages": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "page_metrics": {
+        "properties": {
+          "attribution": {
+            "properties": {
+              "requested": {
+                "type": "string"
+              },
+              "status": {
+                "type": "string"
+              },
+              "window": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          "metric_scope": {
+            "const": "whole_product_card"
+          },
+          "primary": {
+            "properties": {
+              "action_key": {
+                "type": "string"
+              },
+              "cost": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              },
+              "cost_status": {
+                "type": "string"
+              },
+              "currency": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "status": {
+                "type": "string"
+              },
+              "value": {
+                "type": [
+                  "number",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          "profiles": {
+            "items": {
+              "properties": {
+                "kpi_profile": {
+                  "type": "string"
+                },
+                "primary": {
+                  "properties": {
+                    "cost": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    },
+                    "status": {
+                      "type": "string"
+                    },
+                    "value": {
+                      "type": [
+                        "number",
+                        "null"
+                      ]
+                    }
+                  },
+                  "type": "object"
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          }
+        },
+        "type": "object"
+      },
+      "summary": {
+        "properties": {
+          "clicks": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "conversion_value": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "conversions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpa": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpc": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpm": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "ctr": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "funnel": {
+            "$ref": "#/$defs/s8"
+          },
+          "historical_result": {
+            "$ref": "#/$defs/s7"
+          },
+          "impressions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "metric_completeness": {
+            "$ref": "#/$defs/s0"
+          },
+          "reach": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "result_segments": {
+            "$ref": "#/$defs/s2"
+          },
+          "roas": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "spend": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "spend_usd": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      }
+    },
+    "required": [
+      "items",
+      "meta"
+    ]
+  },
+  {
+    "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"
+    ]
+  }
+]

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

Changed16 schema fields changedOct 11, 2026

addedOutput schema / $defs / s2 / items / properties / adset_specs

Added value: +{
+  "items": {
+    "items": {
+      "properties": {
+        "event_type": {
+          "type": "string"
+        },
+        "window_days": {
+          "type": "integer"
+        }
+      },
+      "type": "object"
+    },
+    "type": [
+      "array",
+      "null"
+    ]
+  },
+  "type": "array"
+}

addedOutput schema / $defs / s2 / items / properties / mixed_adset_specs
```
Added value: +{
+  "type": "boolean"
+}
```

removedOutput schema / $defs / s4

Removed value: -{
-  "properties": {
-    "as_of": {
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "conversion_value": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "conversions": {
-      "type": [
-        "number",
-        "null"
-      ]
-    },
-    "status": {
-      "type": "string"
-    }
-  },
-  "type": "object"
-}

removedOutput schema / $defs / s5

Removed value: -{
-  "additionalProperties": {
-    "type": [
-      "number",
-      "null"
-    ]
-  },
-  "type": "object"
-}

removedOutput schema / $defs / s6

Removed value: -{
-  "description": "Configuration snapshot time only.",
-  "format": "date-time",
-  "type": "string"
-}

addedOutput schema / $defs / s7 / properties / as_of

Added value: +{
+  "type": [
+    "string",
+    "null"
+  ]
+}

addedOutput schema / $defs / s7 / properties / conversion_value

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

addedOutput schema / $defs / s7 / properties / conversions

Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}

removedOutput schema / $defs / s7 / properties / proves_source_coverage
```
Removed value: -{
-  "const": false
-}
```
removedOutput schema / $defs / s7 / properties / proves_zero
```
Removed value: -{
-  "const": false
-}
```

removedOutput schema / $defs / s7 / properties / status / enum

Removed value: -[
-  "selected_events_returned",
-  "no_selected_events_returned",
-  "read_unverified",
-  "insights_unavailable"
-]

addedOutput schema / $defs / s7 / properties / status / type
```
Added value: +"string"
```

addedOutput schema / $defs / s8

Added value: +{
+  "additionalProperties": {
+    "type": [
+      "number",
+      "null"
+    ]
+  },
+  "type": "object"
+}

addedOutput schema / $defs / s9

Added value: +{
+  "description": "Configuration snapshot time only.",
+  "format": "date-time",
+  "type": "string"
+}

addedOutput schema / $defs / sa

Added value: +{
+  "properties": {
+    "proves_source_coverage": {
+      "const": false
+    },
+    "proves_zero": {
+      "const": false
+    },
+    "status": {
+      "enum": [
+        "selected_events_returned",
+        "no_selected_events_returned",
+        "read_unverified",
+        "insights_unavailable"
+      ]
+    }
+  },
+  "type": "object"
+}

changedOutput schema / else / anyOf

Previous value: -[
-  {
-    "properties": {
-      "daily": {
-        "items": {
-          "properties": {
-            "ad_account_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "bid_amount": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "bid_strategy": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "budget_level": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "clicks": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "configured_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "configured_status_observed_at": {
-              "$ref": "#/$defs/s6"
-            },
-            "conversion_value": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "conversions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpa": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpc": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpm": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "ctr": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "currency": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "daily_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "data_as_of_date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_start": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_stop": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "delivery_issue_codes": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "delivery_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "effective_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "funnel": {
-              "$ref": "#/$defs/s5"
-            },
-            "funnel_observation": {
-              "$ref": "#/$defs/s7"
-            },
-            "historical_result": {
-              "$ref": "#/$defs/s4"
-            },
-            "id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "impressions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "lifetime_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "metric_completeness": {
-              "$ref": "#/$defs/s0"
-            },
-            "money_unit": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "optimization_goal": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "product_type": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "reach": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "result_segments": {
-              "$ref": "#/$defs/s2"
-            },
-            "roas": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "source_observed_at": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "spend": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "spend_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "effective_attribution": {
-        "type": "string"
-      },
-      "funnel_events": {
-        "items": {
-          "type": "string"
-        },
-        "type": "array"
-      },
-      "funnel_semantics": {
-        "properties": {
-          "coverage_requirement": {
-            "const": "verify_insights_and_source_coverage"
-          },
-          "empty_funnel_interpretation": {
-            "const": "no_selected_events_returned_not_zero_proof"
-          },
-          "missing_event_implies_missing_insights": {
-            "const": false
-          },
-          "missing_event_is_zero": {
-            "const": false
-          },
-          "read_coverage_scope": {
-            "const": "query_result_not_upstream_ingestion"
-          },
-          "representation": {
-            "const": "sparse"
-          }
-        },
-        "type": "object"
-      },
-      "items": {
-        "items": {
-          "properties": {
-            "ad_account_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "ad_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "adset_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "bid_amount": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "bid_strategy": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "budget_level": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "campaign_name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "clicks": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "configured_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "configured_status_observed_at": {
-              "$ref": "#/$defs/s6"
-            },
-            "conversion_value": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "conversions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpa": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpc": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "cpm": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "ctr": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "currency": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "daily_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "data_as_of_date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_start": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "date_stop": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "delivery_issue_codes": {
-              "items": {
-                "type": "string"
-              },
-              "type": "array"
-            },
-            "delivery_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "effective_status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "funnel": {
-              "$ref": "#/$defs/s5"
-            },
-            "funnel_observation": {
-              "$ref": "#/$defs/s7"
-            },
-            "historical_result": {
-              "$ref": "#/$defs/s4"
-            },
-            "id": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "impressions": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "lifetime_budget": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "media": {
-              "additionalProperties": false,
-              "properties": {
-                "media_type": {
-                  "enum": [
-                    "image",
-                    "video",
-                    null
-                  ]
-                },
-                "poster_url": {
-                  "description": "Temporary signed cover URL; never a persistent media identity or video playback URL.",
-                  "format": "uri",
-                  "pattern": "^https://",
-                  "type": "string"
-                },
-                "source_observed_at": {
-                  "format": "date-time",
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "status": {
-                  "enum": [
-                    "pending",
-                    "ready",
-                    "unavailable",
-                    "failed"
-                  ]
-                },
-                "url_expires_at": {
-                  "format": "date-time",
-                  "type": "string"
-                },
-                "version": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "required": [
-                "status"
-              ],
-              "type": "object"
-            },
-            "metric_completeness": {
-              "$ref": "#/$defs/s0"
-            },
-            "money_unit": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "name": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "optimization_goal": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "product_type": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "reach": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "result_segments": {
-              "$ref": "#/$defs/s2"
-            },
-            "roas": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "source_observed_at": {
-              "type": [
-                "string",
-                "null"
-              ]
-            },
-            "spend": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "spend_usd": {
-              "type": [
-                "number",
-                "null"
-              ]
-            },
-            "status": {
-              "type": [
-                "string",
-                "null"
-              ]
-            }
-          },
-          "type": "object"
-        },
-        "type": "array"
-      },
-      "meta": {
-        "properties": {
-          "cache_hit": {
-            "type": "boolean"
-          },
-          "coalesced": {
-            "type": "boolean"
-          },
-          "complete": {
-            "type": "boolean"
-          },
-          "data_as_of_date": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "data_freshness": {
-            "properties": {
-              "interval_min": {
-                "type": "integer"
-              },
-              "label": {
-                "type": "string"
-              },
-              "last_pull_failed_account_count": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              },
-              "last_pull_scope": {
-                "const": "workspace"
-              },
-              "last_pull_status": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "last_pulled_at": {
-                "type": [
-                  "string",
-                  "null"
-                ]
-              },
-              "max_staleness_min": {
-                "type": "integer"
-              },
-              "server_now_utc": {
-                "type": "string"
-              },
-              "staleness_seconds": {
-                "type": [
-                  "integer",
-                  "null"
-                ]
-              }
-            },
-            "type": "object"
-          },
-          "duration_ms": {
-            "type": "integer"
-          },
-          "failed": {
-            "type": "integer"
-          },
-          "freshness_warnings": {
-            "items": {
-              "properties": {
-                "account_count": {
-                  "type": "integer"
-                },
-                "code": {
-                  "type": "string"
-                },
-                "dispersion_seconds": {
-                  "type": "integer"
-                },
-                "last_pull_failed_account_count": {
-                  "type": [
-                    "integer",
-                    "null"
-                  ]
-                },
-                "last_pull_status": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "message": {
-                  "type": "string"
-                },
-                "metrics_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "newest_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                },
-                "observed_account_count": {
-                  "type": "integer"
-                },
-                "oldest_source_observed_at": {
-                  "type": [
-                    "string",
-                    "null"
-                  ]
-                }
-              },
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "funnel_incomplete": {
-            "type": "boolean"
-          },
-          "funnel_read_coverage": {
-            "properties": {
-              "complete": {
-                "type": "boolean"
-              },
-              "reason": {
-                "type": "string"
-              },
-              "source": {
-                "type": "string"
-              }
-            },
-            "type": "object"
-          },
-          "has_more": {
-            "type": "boolean"
-          },
-          "item_count": {
-            "type": "integer"
-          },
-          "limitations": {
-            "items": {
-              "type": "string"
-            },
-            "type": "array"
-          },
-          "metric_completeness": {
-            "$ref": "#/$defs/s0"
-          },
-          "metrics_source_observed_at": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "missing_scopes": {
-            "items": {
-              "properties": {
-                "index": {
-                  "type": "integer"
-                },
-                "status": {
-                  "type": "string"
-                }
-              },
-              "required": [
-                "index",
-                "status"
-              ],
-              "type": "object"
-            },
-            "type": "array"
-          },
-          "next_cursor": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "page": {
-            "type": "integer"
-          },
-          "page_size": {
-            "type": "integer"
-          },
-          "refresh_reused": {
-            "type": "boolean"
-          },
-          "returned_count": {
-            "type": "integer"
-          },
-          "scope_count": {
-            "type": "integer"
-          },
-          "source": {
-            "type": "string"
-          },
-          "source_observed_at": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "source_row_count": {
-            "type": "integer"
-          },
-          "source_truncated": {
-            "type": "boolean"
-          },
-          "source_watermark": {
-            "type": [
-              "string",
-              "null"
-            ]
-          },
-          "standard_metrics_complete": {
-            "type": "boolean"
-          },
-          "succeeded": {
-            "type": "integer"
-          },
-          "total_count": {
-            "type": [
-              "integer",
-              "null"
-            ]
-          },
-          "total_items": {
-            "type": "integer"
-          },
-          "total_pages": {
-            "type": "integer"
-          }
-        },
-        "type": "object"
-      },
-      "summary": {
-        "properties": {
-          "clicks": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "conversion_value": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "conversions": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpa": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpc": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "cpm": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "ctr": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "funnel": {
-            "$ref": "#/$defs/s5"
-          },
-          "historical_result": {
-            "$ref": "#/$defs/s4"
-          },
-          "impressions": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "metric_completeness": {
-            "$ref": "#/$defs/s0"
-          },
-          "reach": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "result_segments": {
-            "$ref": "#/$defs/s2"
-          },
-          "roas": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "spend": {
-            "type": [
-              "number",
-              "null"
-            ]
-          },
-          "spend_usd": {
-            "type": [
-              "number",
-              "null"
-            ]
-          }
-        },
-        "type": "object"
-      }
-    },
-    "required": [
-      "items",
-      "meta"
-    ]
-  },
-  {
-    "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: +[
+  {
+    "properties": {
+      "daily": {
+        "items": {
+          "properties": {
+            "ad_account_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ad_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ad_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "adset_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "adset_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "bid_amount": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "bid_strategy": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "budget_level": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "clicks": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "configured_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "configured_status_observed_at": {
+              "$ref": "#/$defs/s9"
+            },
+            "conversion_value": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "conversions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpa": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpc": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpm": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "ctr": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "currency": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "daily_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "data_as_of_date": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_start": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_stop": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "delivery_issue_codes": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "delivery_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "effective_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "funnel": {
+              "$ref": "#/$defs/s8"
+            },
+            "funnel_observation": {
+              "$ref": "#/$defs/sa"
+            },
+            "historical_result": {
+              "$ref": "#/$defs/s7"
+            },
+            "id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "impressions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "lifetime_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "metric_completeness": {
+              "$ref": "#/$defs/s0"
+            },
+            "money_unit": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "optimization_goal": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "product_type": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "reach": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "result_segments": {
+              "$ref": "#/$defs/s2"
+            },
+            "roas": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "source_observed_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "spend": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "spend_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "effective_attribution": {
+        "type": "string"
+      },
+      "funnel_events": {
+        "items": {
+          "type": "string"
+        },
+        "type": "array"
+      },
+      "funnel_semantics": {
+        "properties": {
+          "coverage_requirement": {
+            "const": "verify_insights_and_source_coverage"
+          },
+          "empty_funnel_interpretation": {
+            "const": "no_selected_events_returned_not_zero_proof"
+          },
+          "missing_event_implies_missing_insights": {
+            "const": false
+          },
+          "missing_event_is_zero": {
+            "const": false
+          },
+          "read_coverage_scope": {
+            "const": "query_result_not_upstream_ingestion"
+          },
+          "representation": {
+            "const": "sparse"
+          }
+        },
+        "type": "object"
+      },
+      "items": {
+        "items": {
+          "properties": {
+            "ad_account_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ad_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "ad_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "adset_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "adset_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "bid_amount": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "bid_strategy": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "budget_level": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "campaign_name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "clicks": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "configured_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "configured_status_observed_at": {
+              "$ref": "#/$defs/s9"
+            },
+            "conversion_value": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "conversions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpa": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpc": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "cpm": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "ctr": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "currency": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "daily_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "data_as_of_date": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_start": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "date_stop": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "delivery_issue_codes": {
+              "items": {
+                "type": "string"
+              },
+              "type": "array"
+            },
+            "delivery_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "effective_status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "funnel": {
+              "$ref": "#/$defs/s8"
+            },
+            "funnel_observation": {
+              "$ref": "#/$defs/sa"
+            },
+            "historical_result": {
+              "$ref": "#/$defs/s7"
+            },
+            "id": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "impressions": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "lifetime_budget": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "media": {
+              "additionalProperties": false,
+              "properties": {
+                "media_type": {
+                  "enum": [
+                    "image",
+                    "video",
+                    null
+                  ]
+                },
+                "poster_url": {
+                  "description": "Temporary signed cover URL; never a persistent media identity or video playback URL.",
+                  "format": "uri",
+                  "pattern": "^https://",
+                  "type": "string"
+                },
+                "source_observed_at": {
+                  "format": "date-time",
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "status": {
+                  "enum": [
+                    "pending",
+                    "ready",
+                    "unavailable",
+                    "failed"
+                  ]
+                },
+                "url_expires_at": {
+                  "format": "date-time",
+                  "type": "string"
+                },
+                "version": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "required": [
+                "status"
+              ],
+              "type": "object"
+            },
+            "metric_completeness": {
+              "$ref": "#/$defs/s0"
+            },
+            "money_unit": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "name": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "optimization_goal": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "product_type": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "reach": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "result_segments": {
+              "$ref": "#/$defs/s2"
+            },
+            "roas": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "source_observed_at": {
+              "type": [
+                "string",
+                "null"
+              ]
+            },
+            "spend": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "spend_usd": {
+              "type": [
+                "number",
+                "null"
+              ]
+            },
+            "status": {
+              "type": [
+                "string",
+                "null"
+              ]
+            }
+          },
+          "type": "object"
+        },
+        "type": "array"
+      },
+      "meta": {
+        "properties": {
+          "cache_hit": {
+            "type": "boolean"
+          },
+          "coalesced": {
+            "type": "boolean"
+          },
+          "complete": {
+            "type": "boolean"
+          },
+          "data_as_of_date": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "data_freshness": {
+            "properties": {
+              "interval_min": {
+                "type": "integer"
+              },
+              "label": {
+                "type": "string"
+              },
+              "last_pull_failed_account_count": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              },
+              "last_pull_scope": {
+                "const": "workspace"
+              },
+              "last_pull_status": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "last_pulled_at": {
+                "type": [
+                  "string",
+                  "null"
+                ]
+              },
+              "max_staleness_min": {
+                "type": "integer"
+              },
+              "server_now_utc": {
+                "type": "string"
+              },
+              "staleness_seconds": {
+                "type": [
+                  "integer",
+                  "null"
+                ]
+              }
+            },
+            "type": "object"
+          },
+          "duration_ms": {
+            "type": "integer"
+          },
+          "failed": {
+            "type": "integer"
+          },
+          "freshness_warnings": {
+            "items": {
+              "properties": {
+                "account_count": {
+                  "type": "integer"
+                },
+                "code": {
+                  "type": "string"
+                },
+                "dispersion_seconds": {
+                  "type": "integer"
+                },
+                "last_pull_failed_account_count": {
+                  "type": [
+                    "integer",
+                    "null"
+                  ]
+                },
+                "last_pull_status": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "message": {
+                  "type": "string"
+                },
+                "metrics_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "newest_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                },
+                "observed_account_count": {
+                  "type": "integer"
+                },
+                "oldest_source_observed_at": {
+                  "type": [
+                    "string",
+                    "null"
+                  ]
+                }
+              },
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "funnel_incomplete": {
+            "type": "boolean"
+          },
+          "funnel_read_coverage": {
+            "properties": {
+              "complete": {
+                "type": "boolean"
+              },
+              "reason": {
+                "type": "string"
+              },
+              "source": {
+                "type": "string"
+              }
+            },
+            "type": "object"
+          },
+          "has_more": {
+            "type": "boolean"
+          },
+          "item_count": {
+            "type": "integer"
+          },
+          "limitations": {
+            "items": {
+              "type": "string"
+            },
+            "type": "array"
+          },
+          "metric_completeness": {
+            "$ref": "#/$defs/s0"
+          },
+          "metrics_source_observed_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "missing_scopes": {
+            "items": {
+              "properties": {
+                "index": {
+                  "type": "integer"
+                },
+                "status": {
+                  "type": "string"
+                }
+              },
+              "required": [
+                "index",
+                "status"
+              ],
+              "type": "object"
+            },
+            "type": "array"
+          },
+          "next_cursor": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "page": {
+            "type": "integer"
+          },
+          "page_size": {
+            "type": "integer"
+          },
+          "refresh_reused": {
+            "type": "boolean"
+          },
+          "returned_count": {
+            "type": "integer"
+          },
+          "scope_count": {
+            "type": "integer"
+          },
+          "source": {
+            "type": "string"
+          },
+          "source_observed_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "source_row_count": {
+            "type": "integer"
+          },
+          "source_truncated": {
+            "type": "boolean"
+          },
+          "source_watermark": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "standard_metrics_complete": {
+            "type": "boolean"
+          },
+          "succeeded": {
+            "type": "integer"
+          },
+          "total_count": {
+            "type": [
+              "integer",
+              "null"
+            ]
+          },
+          "total_items": {
+            "type": "integer"
+          },
+          "total_pages": {
+            "type": "integer"
+          }
+        },
+        "type": "object"
+      },
+      "summary": {
+        "properties": {
+          "clicks": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "conversion_value": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "conversions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpa": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpc": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cpm": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "ctr": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "funnel": {
+            "$ref": "#/$defs/s8"
+          },
+          "historical_result": {
+            "$ref": "#/$defs/s7"
+          },
+          "impressions": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "metric_completeness": {
+            "$ref": "#/$defs/s0"
+          },
+          "reach": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "result_segments": {
+            "$ref": "#/$defs/s2"
+          },
+          "roas": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "spend": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "spend_usd": {
+            "type": [
+              "number",
+              "null"
+            ]
+          }
+        },
+        "type": "object"
+      }
+    },
+    "required": [
+      "items",
+      "meta"
+    ]
+  },
+  {
+    "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"
+    ]
+  }
+]

AddedOct 9, 2026

TDQS

C2.4/5.0

Behavior2/5

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

Annotations declare readOnlyHint=true, destructiveHint=false, openWorldHint=false, so the safety profile is covered. However, the description adds little beyond 'read' and 'USD' – it doesn't disclose what 'stored dashboard page' means, whether results are paginated (page/page_size/result_cursor params suggest pagination but description is silent), what connection_context or inventory_anchor are for, or how this differs behaviorally from writing tools.

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

Conciseness3/5

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

A single short phrase – concise to a fault. It's front-loaded but under-specified for an 18-parameter tool with complex nested scope. Conciseness is present but it comes at the cost of needed information.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness2/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

For an 18-parameter tool with polymorphic scope, credential-like connection_context, pagination tokens, and multiple sort/filter enums, the description is completely inadequate. An output schema exists so return values needn't be explained, but the input semantics, usage context, and relationship to sibling tools are entirely absent.

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 18 parameters, including complex ones like scope (polymorphic oneOf with discriminator), connection_context (opaque mctx_v1_ token), inventory_anchor (32-char hex), view_mode (grouped vs daily), attribution modes, and result_cursor. The description provides zero parameter semantics, leaving many params completely undocumented. With 0% coverage and high param count, this is a major gap.

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

Purpose3/5

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

The description 'Read a stored dashboard page in USD' identifies a verb (read) and a resource (stored dashboard page), but 'stored dashboard page' is vague and doesn't clearly distinguish this tool from siblings like console_export_csv, console_get_stored_entity_evidence, or insights_query_overview. It fails to mention what the query operates over (accounts, campaigns, adsets, ads), which is central to the tool's function.

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

Usage Guidelines2/5

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

No when-to-use guidance, no when-not-to-use guidance, and no mention of alternatives. The description doesn't help the agent decide between this and console_export_csv, console_get_stored_entity_evidence, insights_query_overview, or insights_query_batch_overview, nor does it explain what 'stored' implies.

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?