Read a stored dashboard page in USD
| Name | Required | Description | 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 | ||
| metadata_contract_version | No | ||
| include_zero_insight_entities | No |
| Name | Required | Description | Default |
|---|---|---|---|
| message | No | ||
| retryable | No | ||
| support_ref | No |
Changes observed during successful MCP inspections.
Input schema / properties / connection_contextRemoved value: -{
- "pattern": "^mctx_v1_[0-9a-f]{64}$",
- "type": "string"
-}Output schema / $defsRemoved value: -{
- "s0": {
- "additionalProperties": {
- "properties": {
- "complete": {
- "type": "boolean"
- },
- "excluded_rows": {
- "type": "integer"
- },
- "reason": {
- "type": [
- "string",
- "null"
- ]
- }
- },
- "type": "object"
- },
- "type": "object"
- },
- "s2": {
- "items": {
- "properties": {
- "adset_specs": {
- "items": {
- "items": {
- "properties": {
- "event_type": {
- "type": "string"
- },
- "window_days": {
- "type": "integer"
- }
- },
- "type": "object"
- },
- "type": [
- "array",
- "null"
- ]
- },
- "type": "array"
- },
- "as_of": {
- "type": [
- "string",
- "null"
- ]
- },
- "count": {
- "type": [
- "number",
- "null"
- ]
- },
- "count_rows": {
- "type": "integer"
- },
- "currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "indicator": {
- "type": [
- "string",
- "null"
- ]
- },
- "mixed_adset_specs": {
- "type": "boolean"
- },
- "reasons": {
- "items": {
- "type": "string"
- },
- "type": "array"
- },
- "rows": {
- "type": "integer"
- },
- "value": {
- "type": [
- "number",
- "null"
- ]
- },
- "value_currency": {
- "type": [
- "string",
- "null"
- ]
- },
- "value_rows": {
- "type": "integer"
- }
- },
- "type": "object"
- },
- "type": "array"
- },
- "s7": {
- "properties": {
- "as_of": {
- "type": [
- "string",
- "null"
- ]
- },
- "conversion_value": {
- "type": [
- "number",
- "null"
- ]
- },
- "conversions": {
- "type": [
- "number",
- "null"
- ]
- },
- "status": {
- "type": "string"
- }
- },
- "type": "object"
- },
- "s8": {
- "additionalProperties": {
- "type": [
- "number",
- "null"
- ]
- },
- "type": "object"
- },
- "s9": {
- "description": "Configuration snapshot time only.",
- "format": "date-time",
- "type": "string"
- },
- "sa": {
- "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"
- }
-}Output schema / else / anyOfPrevious 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"
- ]
- }
-]New value: +[
+ {
+ "required": [
+ "items",
+ "meta"
+ ]
+ },
+ {
+ "required": [
+ "result_page"
+ ]
+ }
+]Output schema / else / propertiesAdded value: +{
+ "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": {
+ "description": "Configuration snapshot time only.",
+ "format": "date-time",
+ "type": "string"
+ },
+ "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": {
+ "additionalProperties": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "type": "object"
+ },
+ "funnel_observation": {
+ "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"
+ },
+ "historical_result": {
+ "properties": {
+ "as_of": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "conversion_value": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "conversions": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "id": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "impressions": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "lifetime_budget": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "metric_completeness": {
+ "additionalProperties": {
+ "properties": {
+ "complete": {
+ "type": "boolean"
+ },
+ "excluded_rows": {
+ "type": "integer"
+ },
+ "reason": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "object"
+ },
+ "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": {
+ "items": {
+ "properties": {
+ "adset_specs": {
+ "items": {
+ "items": {
+ "properties": {
+ "event_type": {
+ "type": "string"
+ },
+ "window_days": {
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": "array"
+ },
+ "as_of": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "count_rows": {
+ "type": "integer"
+ },
+ "currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "indicator": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mixed_adset_specs": {
+ "type": "boolean"
+ },
+ "reasons": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "rows": {
+ "type": "integer"
+ },
+ "value": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "value_currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value_rows": {
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "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": {
+ "description": "Configuration snapshot time only.",
+ "format": "date-time",
+ "type": "string"
+ },
+ "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": {
+ "additionalProperties": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "type": "object"
+ },
+ "funnel_observation": {
+ "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"
+ },
+ "historical_result": {
+ "properties": {
+ "as_of": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "conversion_value": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "conversions": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "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": {
+ "additionalProperties": {
+ "properties": {
+ "complete": {
+ "type": "boolean"
+ },
+ "excluded_rows": {
+ "type": "integer"
+ },
+ "reason": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "object"
+ },
+ "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": {
+ "items": {
+ "properties": {
+ "adset_specs": {
+ "items": {
+ "items": {
+ "properties": {
+ "event_type": {
+ "type": "string"
+ },
+ "window_days": {
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": "array"
+ },
+ "as_of": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "count_rows": {
+ "type": "integer"
+ },
+ "currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "indicator": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mixed_adset_specs": {
+ "type": "boolean"
+ },
+ "reasons": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "rows": {
+ "type": "integer"
+ },
+ "value": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "value_currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value_rows": {
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "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": {
+ "additionalProperties": {
+ "properties": {
+ "complete": {
+ "type": "boolean"
+ },
+ "excluded_rows": {
+ "type": "integer"
+ },
+ "reason": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "object"
+ },
+ "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"
+ },
+ "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"
+ },
+ "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": {
+ "additionalProperties": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "type": "object"
+ },
+ "historical_result": {
+ "properties": {
+ "as_of": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "conversion_value": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "conversions": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "status": {
+ "type": "string"
+ }
+ },
+ "type": "object"
+ },
+ "impressions": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "metric_completeness": {
+ "additionalProperties": {
+ "properties": {
+ "complete": {
+ "type": "boolean"
+ },
+ "excluded_rows": {
+ "type": "integer"
+ },
+ "reason": {
+ "type": [
+ "string",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ },
+ "type": "object"
+ },
+ "reach": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "result_segments": {
+ "items": {
+ "properties": {
+ "adset_specs": {
+ "items": {
+ "items": {
+ "properties": {
+ "event_type": {
+ "type": "string"
+ },
+ "window_days": {
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": "array"
+ },
+ "as_of": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "count": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "count_rows": {
+ "type": "integer"
+ },
+ "currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "indicator": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "mixed_adset_specs": {
+ "type": "boolean"
+ },
+ "reasons": {
+ "items": {
+ "type": "string"
+ },
+ "type": "array"
+ },
+ "rows": {
+ "type": "integer"
+ },
+ "value": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "value_currency": {
+ "type": [
+ "string",
+ "null"
+ ]
+ },
+ "value_rows": {
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "type": "array"
+ },
+ "roas": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "spend": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "spend_usd": {
+ "type": [
+ "number",
+ "null"
+ ]
+ }
+ },
+ "type": "object"
+ }
+}Output schema / else / anyOfPrevious 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"
+ ]
+ }
+]Output schema / then / properties / categoryAdded value: +{
+ "type": "string"
+}Output schema / then / properties / expectedAdded value: +{
+ "type": "boolean"
+}Output schema / then / properties / failure_kindAdded value: +{
+ "type": "string"
+}Output schema / then / properties / responsibility_hintAdded value: +{
+ "type": "string"
+}Output schema / then / properties / routeAdded value: +{
+ "type": "string"
+}Output schema / then / properties / user_visibleAdded value: +{
+ "type": "boolean"
+}Input schema / properties / connection_contextAdded value: +{
+ "pattern": "^mctx_v1_[0-9a-f]{64}$",
+ "type": "string"
+}Output schema / $defs / s2 / items / properties / adset_specsAdded value: +{
+ "items": {
+ "items": {
+ "properties": {
+ "event_type": {
+ "type": "string"
+ },
+ "window_days": {
+ "type": "integer"
+ }
+ },
+ "type": "object"
+ },
+ "type": [
+ "array",
+ "null"
+ ]
+ },
+ "type": "array"
+}Output schema / $defs / s2 / items / properties / mixed_adset_specsAdded value: +{
+ "type": "boolean"
+}Output schema / $defs / s4Removed value: -{
- "properties": {
- "as_of": {
- "type": [
- "string",
- "null"
- ]
- },
- "conversion_value": {
- "type": [
- "number",
- "null"
- ]
- },
- "conversions": {
- "type": [
- "number",
- "null"
- ]
- },
- "status": {
- "type": "string"
- }
- },
- "type": "object"
-}Output schema / $defs / s5Removed value: -{
- "additionalProperties": {
- "type": [
- "number",
- "null"
- ]
- },
- "type": "object"
-}Output schema / $defs / s6Removed value: -{
- "description": "Configuration snapshot time only.",
- "format": "date-time",
- "type": "string"
-}Output schema / $defs / s7 / properties / as_ofAdded value: +{
+ "type": [
+ "string",
+ "null"
+ ]
+}Output schema / $defs / s7 / properties / conversion_valueAdded value: +{
+ "type": [
+ "number",
+ "null"
+ ]
+}Output schema / $defs / s7 / properties / conversionsAdded value: +{
+ "type": [
+ "number",
+ "null"
+ ]
+}Output schema / $defs / s7 / properties / proves_source_coverageRemoved value: -{
- "const": false
-}Output schema / $defs / s7 / properties / proves_zeroRemoved value: -{
- "const": false
-}Output schema / $defs / s7 / properties / status / enumRemoved value: -[
- "selected_events_returned",
- "no_selected_events_returned",
- "read_unverified",
- "insights_unavailable"
-]Output schema / $defs / s7 / properties / status / typeAdded value: +"string"Output schema / $defs / s8Added value: +{
+ "additionalProperties": {
+ "type": [
+ "number",
+ "null"
+ ]
+ },
+ "type": "object"
+}Output schema / $defs / s9Added value: +{
+ "description": "Configuration snapshot time only.",
+ "format": "date-time",
+ "type": "string"
+}Output schema / $defs / saAdded 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"
+}Output schema / else / anyOfPrevious 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"
+ ]
+ }
+]Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?
Annotations already declare readOnlyHint=true, destructiveHint=false, and openWorldHint=false, so the description need only add context beyond that safety profile. It adds only 'stored dashboard page' and 'USD', with no mention of pagination behavior, authentication needs, data freshness, or what 'stored' means.
Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.
Is the description appropriately sized, front-loaded, and free of redundancy?
The single sentence is front-loaded and free of filler, but it is severely under-specified for a 17-parameter tool. Conciseness here comes at the cost of the detail an agent needs to invoke the tool correctly.
Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.
Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?
Given 17 input parameters, only 4 required, and 0% schema description coverage, the description is far too incomplete. Even with an output schema reducing the need to document return values, it does not explain scoping, date ranges, grouping, pagination, sorting, or attribution semantics.
Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.
Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?
The schema has 17 parameters with 0% description coverage, and the description explains none of them. Critical parameters such as scope, group_by, date_from, date_to, view_mode, attribution, result_cursor, and inventory_anchor are left entirely undocumented, so the description fails to compensate for the schema gap.
Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.
Does the description clearly state what the tool does and how it differs from similar tools?
The description has a specific verb ('Read') and resource ('stored dashboard page'), and adds currency context ('in USD'). However, 'stored dashboard page' is vague and it does not distinguish this tool from siblings like insights_query_overview or console_export_csv, which also query/read dashboard data.
Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.
Does the description explain when to use this tool, when not to, or what alternatives exist?
It provides no guidance on when to use this tool versus insights_query_overview, insights_query_batch_overview, or console_export_csv. There are no exclusions, prerequisites, or context beyond an implied read operation.
Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.
Add one secure layer between your agents and this server.