RevenueScope: revenue-first analytics for your EC site

Site KPI summary

get_summary

Read-only

Return headline KPIs (revenue, orders, sessions, RPS, AOV, CVR), engagement metrics and daily trends for the site's calendar month to date, compared with the prior month through the same calendar day (clamped to that month's last day). Pass start_date and end_date together for another inclusive calendar range in the site's analysis timezone; optionally pass compare_start_date and compare_end_date. If comparison dates are omitted, the preceding equal-length range is used. Or pass preset (last_4_weeks, last_12_weeks or year_to_date) instead of dates, for the same periods and comparison as the app's period picker: the period ends on the last Saturday that closes a complete week (weeks run Sunday to Saturday, judged in the site timezone), the comparison is the same number of days directly before it, and year_to_date starts on January 1 of the year of that Saturday. preset cannot be combined with start_date, end_date, compare_start_date or compare_end_date, and period.preset echoes it. Revenue-dependent metrics (revenue, orders, RPS, AOV, CVR) are null unless purchase measurement is confirmed; null means unverified, not zero. Required retrieval failures return isError=true and must not be read as zero. No overall ROAS is returned (kpis.roas is always null); per-platform ROAS for ad-only platforms is in get_breakdown ad_spend_candidates. Optional country (ISO2) and device filters scope session-derived metrics. site_id is optional when OAuth-authenticated (omitting it uses the primary site). When the user names a specific site, such as the sample site, call list_sites first and pass that site_id. This tool has an attached view. When the host shows it, the figures are already on screen: do not repeat them as a table or list in your reply; give only a short takeaway (2-3 sentences).

Input Schema

TableJSON Schema

Name	Required	Description	Default
`device`	No
`preset`	No
`country`	No
`site_id`	No
`end_date`	No
`start_date`	No
`compare_end_date`	No
`compare_start_date`	No

Output Schema

TableJSON Schema

Name	Required	Description	Default
`kpis`	Yes
`basis`	Yes
`notes`	No
`trend`	Yes
`period`	Yes
`is_demo`	Yes
`site_id`	Yes
`display_note`	No
`data_freshness`	Yes
`previous_trend`	Yes
`revenue_status`	Yes
`previous_period`	Yes
`comparison_status`	Yes
`bot_excluded_count`	Yes
`connected_channels`	Yes
`presentation_hints`	Yes
`path_recommendation`	Yes
`ad_spend_data_status`	Yes
`ad_spend_rows_in_period`	Yes
`period_observation_status`	Yes
`ad_spend_channels_in_period`	Yes
`period_boundary_definitions`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed1 schema field changedOct 11, 2026
- addedOutput schema / properties / display_note
```
Added value: +{
+  "type": "string"
+}
```

Changed5 schema fields changedOct 10, 2026

changedOutput schema / properties / presentation_hints / properties / recommended_followup_tools / items / enum

Previous value: -[
-  "get_breakdown",
-  "get_priority_insights",
-  "get_summary"
-]New value: +[
+  "get_breakdown",
+  "get_summary"
+]

changedOutput schema / properties / presentation_hints / properties / recommended_sections / items / enum

Previous value: -[
-  "kpi_summary",
-  "trend",
-  "ad_spend_context",
-  "breakdown",
-  "priority_insights",
-  "recommended_actions"
-]New value: +[
+  "kpi_summary",
+  "trend",
+  "ad_spend_context",
+  "breakdown",
+  "recommended_actions"
+]

changedOutput schema / properties / presentation_hints / properties / response_type / enum

Previous value: -[
-  "analytics_summary",
-  "analytics_breakdown",
-  "priority_insights",
-  "analytics_today"
-]New value: +[
+  "analytics_summary",
+  "analytics_breakdown",
+  "analytics_today"
+]

removedOutput schema / properties / presentation_hints / properties / show_priority_insights
```
Removed value: -{
-  "type": "boolean"
-}
```

changedOutput schema / properties / presentation_hints / required

Previous value: -[
-  "response_type",
-  "primary_metric",
-  "show_period_comparison",
-  "show_trend",
-  "show_breakdown",
-  "show_priority_insights",
-  "prefer_compact_visual_summary",
-  "avoid_long_prose",
-  "recommended_followup_tools",
-  "recommended_sections"
-]New value: +[
+  "response_type",
+  "primary_metric",
+  "show_period_comparison",
+  "show_trend",
+  "show_breakdown",
+  "prefer_compact_visual_summary",
+  "avoid_long_prose",
+  "recommended_followup_tools",
+  "recommended_sections"
+]

Changed4 schema fields changedOct 9, 2026

addedInput schema / properties / preset

Added value: +{
+  "enum": [
+    "last_4_weeks",
+    "last_12_weeks",
+    "year_to_date"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / kpis / properties / orders

Added value: +{
+  "$ref": "#/properties/kpis/properties/revenue"
+}

changedOutput schema / properties / kpis / required

Previous value: -[
-  "revenue",
-  "sessions",
-  "rps",
-  "aov",
-  "cvr",
-  "avg_duration",
-  "bounce_rate",
-  "scroll_depth",
-  "avg_duration_depth_basis",
-  "median_duration_depth_basis",
-  "median_scroll_depth",
-  "roas"
-]New value: +[
+  "revenue",
+  "orders",
+  "sessions",
+  "rps",
+  "aov",
+  "cvr",
+  "avg_duration",
+  "bounce_rate",
+  "scroll_depth",
+  "avg_duration_depth_basis",
+  "median_duration_depth_basis",
+  "median_scroll_depth",
+  "roas"
+]

addedOutput schema / properties / period / properties / preset

Added value: +{
+  "enum": [
+    "last_4_weeks",
+    "last_12_weeks",
+    "year_to_date"
+  ],
+  "type": "string"
+}

Changed1 schema field changedSep 28, 2026

removedInput schema / properties / period

Removed value: -{
-  "anyOf": [
-    {
-      "const": "today",
-      "type": "string"
-    },
-    {
-      "const": "7d",
-      "type": "string"
-    },
-    {
-      "const": "30d",
-      "type": "string"
-    },
-    {
-      "const": "90d",
-      "type": "string"
-    },
-    {
-      "maximum": 365,
-      "minimum": 1,
-      "type": "integer"
-    }
-  ],
-  "default": "30d"
-}

Changed2 schema fields changedSep 27, 2026

changedOutput schema / properties / presentation_hints / properties / recommended_followup_tools / items / enum

Previous value: -[
-  "get_breakdown",
-  "get_priority_insights"
-]New value: +[
+  "get_breakdown",
+  "get_priority_insights",
+  "get_summary"
+]

changedOutput schema / properties / presentation_hints / properties / response_type / enum

Previous value: -[
-  "analytics_summary",
-  "analytics_breakdown",
-  "priority_insights"
-]New value: +[
+  "analytics_summary",
+  "analytics_breakdown",
+  "priority_insights",
+  "analytics_today"
+]

Changed16 schema fields changedSep 27, 2026

addedOutput schema / properties / bot_excluded_count

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

addedOutput schema / properties / comparison_status

Added value: +{
+  "enum": [
+    "available",
+    "unavailable"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / is_demo
```
Added value: +{
+  "type": "boolean"
+}
```
changedOutput schema / properties / kpis / properties / revenue / properties / change / type
```
Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
```
changedOutput schema / properties / kpis / properties / revenue / properties / previous / type
```
Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
```
changedOutput schema / properties / kpis / properties / revenue / properties / value / type
```
Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
```

removedOutput schema / properties / kpis / properties / roas / anyOf

Removed value: -[
-  {
-    "additionalProperties": false,
-    "properties": {
-      "change": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "previous": {
-        "type": [
-          "number",
-          "null"
-        ]
-      },
-      "value": {
-        "type": "number"
-      }
-    },
-    "required": [
-      "value",
-      "previous",
-      "change"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]

addedOutput schema / properties / kpis / properties / roas / type
```
Added value: +"null"
```

addedOutput schema / properties / period_observation_status

Added value: +{
+  "enum": [
+    "observed",
+    "no_observation"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / previous_trend

Added value: +{
+  "anyOf": [
+    {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "conversions": {
+            "type": "number"
+          },
+          "cumulative_revenue": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "cvr": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "date": {
+            "type": "string"
+          },
+          "revenue": {
+            "type": [
+              "number",
+              "null"
+            ]
+          },
+          "sessions": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "date",
+          "revenue",
+          "cumulative_revenue",
+          "sessions",
+          "conversions",
+          "cvr"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / revenue_status

Added value: +{
+  "enum": [
+    "confirmed",
+    "unconfirmed"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / trend / items / properties / cumulative_revenue
```
Added value: +{
+  "type": [
+    "number",
+    "null"
+  ]
+}
```
changedOutput schema / properties / trend / items / properties / cvr / type
```
Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
```
changedOutput schema / properties / trend / items / properties / revenue / type
```
Previous value: -"number"New value: +[
+  "number",
+  "null"
+]
```

changedOutput schema / properties / trend / items / required

Previous value: -[
-  "date",
-  "revenue",
-  "sessions",
-  "conversions",
-  "cvr"
-]New value: +[
+  "date",
+  "revenue",
+  "cumulative_revenue",
+  "sessions",
+  "conversions",
+  "cvr"
+]

changedOutput schema / required

Previous value: -[
-  "site_id",
-  "period",
-  "previous_period",
-  "data_freshness",
-  "period_boundary_definitions",
-  "basis",
-  "kpis",
-  "trend",
-  "path_recommendation",
-  "ad_spend_data_status",
-  "connected_channels",
-  "ad_spend_channels_in_period",
-  "ad_spend_rows_in_period",
-  "presentation_hints"
-]New value: +[
+  "site_id",
+  "revenue_status",
+  "period_observation_status",
+  "is_demo",
+  "comparison_status",
+  "bot_excluded_count",
+  "period",
+  "previous_period",
+  "data_freshness",
+  "period_boundary_definitions",
+  "basis",
+  "kpis",
+  "trend",
+  "previous_trend",
+  "path_recommendation",
+  "ad_spend_data_status",
+  "connected_channels",
+  "ad_spend_channels_in_period",
+  "ad_spend_rows_in_period",
+  "presentation_hints"
+]

Changed7 schema fields changedSep 26, 2026

addedInput schema / properties / compare_end_date

Added value: +{
+  "$ref": "#/properties/start_date"
+}

addedInput schema / properties / compare_start_date

Added value: +{
+  "$ref": "#/properties/start_date"
+}

addedInput schema / properties / end_date

Added value: +{
+  "$ref": "#/properties/start_date"
+}

addedInput schema / properties / start_date

Added value: +{
+  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
+  "type": "string"
+}

addedOutput schema / properties / notes

Added value: +{
+  "items": {
+    "type": "string"
+  },
+  "type": "array"
+}

removedOutput schema / properties / period / properties / timezone / const
```
Removed value: -"Asia/Tokyo"
```

changedOutput schema / properties / period / properties / window_type / enum

Previous value: -[
-  "rolling",
-  "calendar_to_date",
-  "comparison"
-]New value: +[
+  "rolling",
+  "calendar_to_date",
+  "comparison",
+  "calendar_range"
+]

Changed18 schema fields changedSep 4, 2026

addedOutput schema / properties / data_freshness

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "bot_classification_delay_definitions": {
+      "additionalProperties": false,
+      "properties": {
+        "burst_cluster_fallback": {
+          "type": "string"
+        },
+        "burst_cluster_primary": {
+          "type": "string"
+        },
+        "single_page_zero_dwell": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "burst_cluster_primary",
+        "burst_cluster_fallback",
+        "single_page_zero_dwell"
+      ],
+      "type": "object"
+    },
+    "bot_classification_delay_minutes_max_by_rule": {
+      "additionalProperties": false,
+      "properties": {
+        "burst_cluster_fallback": {
+          "const": 480,
+          "type": "number"
+        },
+        "burst_cluster_primary": {
+          "const": 20,
+          "type": "number"
+        },
+        "single_page_zero_dwell": {
+          "const": 480,
+          "type": "number"
+        }
+      },
+      "required": [
+        "burst_cluster_primary",
+        "burst_cluster_fallback",
+        "single_page_zero_dwell"
+      ],
+      "type": "object"
+    },
+    "delay_bounds_assume_scheduled_jobs_operational": {
+      "const": true,
+      "type": "boolean"
+    },
+    "generated_at": {
+      "format": "date-time",
+      "type": "string"
+    },
+    "may_change_because": {
+      "items": {
+        "enum": [
+          "live_ingestion",
+          "open_window",
+          "moving_window",
+          "delayed_bot_classification"
+        ],
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "provisional": {
+      "const": true,
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "generated_at",
+    "provisional",
+    "may_change_because",
+    "bot_classification_delay_minutes_max_by_rule",
+    "bot_classification_delay_definitions",
+    "delay_bounds_assume_scheduled_jobs_operational"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / period / properties / calendar_dates_touched
```
Added value: +{
+  "minimum": 0,
+  "type": "integer"
+}
```
addedOutput schema / properties / period / properties / duration_hours
```
Added value: +{
+  "type": "number"
+}
```

addedOutput schema / properties / period / properties / reference_bounds

Added value: +{
+  "const": "start_inclusive_end_exclusive",
+  "type": "string"
+}

addedOutput schema / properties / period / properties / reference_end_at
```
Added value: +{
+  "format": "date-time",
+  "type": "string"
+}
```
addedOutput schema / properties / period / properties / reference_start_at
```
Added value: +{
+  "format": "date-time",
+  "type": "string"
+}
```

addedOutput schema / properties / period / properties / source_alignment

Added value: +{
+  "enum": [
+    "exact",
+    "mixed"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / period / properties / source_boundaries

Added value: +{
+  "items": {
+    "additionalProperties": false,
+    "properties": {
+      "applies_to": {
+        "items": {
+          "type": "string"
+        },
+        "minItems": 1,
+        "type": "array"
+      },
+      "boundary": {
+        "enum": [
+          "reference_timestamp_window",
+          "database_statement_time_window",
+          "jst_calendar_dates_from_reference_start",
+          "jst_calendar_dates_from_database_window_start",
+          "jst_calendar_dates_inclusive",
+          "account_registry_not_period_scoped",
+          "derived_previous_daily_window",
+          "derived_from_current_and_previous",
+          "defined_per_output_item"
+        ],
+        "type": "string"
+      }
+    },
+    "required": [
+      "applies_to",
+      "boundary"
+    ],
+    "type": "object"
+  },
+  "type": "array"
+}

addedOutput schema / properties / period / properties / timezone

Added value: +{
+  "const": "Asia/Tokyo",
+  "type": "string"
+}

addedOutput schema / properties / period / properties / window_type

Added value: +{
+  "enum": [
+    "rolling",
+    "calendar_to_date",
+    "comparison"
+  ],
+  "type": "string"
+}

changedOutput schema / properties / period / required

Previous value: -[
-  "start",
-  "end",
-  "days"
-]New value: +[
+  "start",
+  "end",
+  "days",
+  "reference_start_at",
+  "reference_end_at",
+  "window_type",
+  "reference_bounds",
+  "timezone",
+  "duration_hours",
+  "calendar_dates_touched",
+  "source_alignment",
+  "source_boundaries"
+]

addedOutput schema / properties / period_boundary_definitions

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "account_registry_not_period_scoped": {
+      "type": "string"
+    },
+    "database_statement_time_window": {
+      "type": "string"
+    },
+    "defined_per_output_item": {
+      "type": "string"
+    },
+    "derived_from_current_and_previous": {
+      "type": "string"
+    },
+    "derived_previous_daily_window": {
+      "type": "string"
+    },
+    "jst_calendar_dates_from_database_window_start": {
+      "type": "string"
+    },
+    "jst_calendar_dates_from_reference_start": {
+      "type": "string"
+    },
+    "jst_calendar_dates_inclusive": {
+      "type": "string"
+    },
+    "path_syntax": {
+      "const": "dot_path_with_array_wildcard",
+      "type": "string"
+    },
+    "reference_timestamp_window": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "path_syntax",
+    "reference_timestamp_window",
+    "database_statement_time_window",
+    "jst_calendar_dates_from_reference_start",
+    "jst_calendar_dates_from_database_window_start",
+    "jst_calendar_dates_inclusive",
+    "account_registry_not_period_scoped",
+    "derived_previous_daily_window",
+    "derived_from_current_and_previous",
+    "defined_per_output_item"
+  ],
+  "type": "object"
+}

addedOutput schema / properties / previous_period / $ref
```
Added value: +"#/properties/period"
```
removedOutput schema / properties / previous_period / additionalProperties
```
Removed value: -false
```

removedOutput schema / properties / previous_period / properties

Removed value: -{
-  "end": {
-    "type": "string"
-  },
-  "start": {
-    "type": "string"
-  }
-}

removedOutput schema / properties / previous_period / required
```
Removed value: -[
-  "start",
-  "end"
-]
```
removedOutput schema / properties / previous_period / type
```
Removed value: -"object"
```

changedOutput schema / required

Previous value: -[
-  "site_id",
-  "period",
-  "previous_period",
-  "basis",
-  "kpis",
-  "trend",
-  "path_recommendation",
-  "ad_spend_data_status",
-  "connected_channels",
-  "ad_spend_channels_in_period",
-  "ad_spend_rows_in_period",
-  "presentation_hints"
-]New value: +[
+  "site_id",
+  "period",
+  "previous_period",
+  "data_freshness",
+  "period_boundary_definitions",
+  "basis",
+  "kpis",
+  "trend",
+  "path_recommendation",
+  "ad_spend_data_status",
+  "connected_channels",
+  "ad_spend_channels_in_period",
+  "ad_spend_rows_in_period",
+  "presentation_hints"
+]

Changed2 schema fields changedSep 4, 2026

addedOutput schema / properties / presentation_hints

Added value: +{
+  "additionalProperties": false,
+  "properties": {
+    "avoid_long_prose": {
+      "const": true,
+      "type": "boolean"
+    },
+    "prefer_compact_visual_summary": {
+      "const": true,
+      "type": "boolean"
+    },
+    "primary_metric": {
+      "type": "string"
+    },
+    "recommended_followup_tools": {
+      "items": {
+        "enum": [
+          "get_breakdown",
+          "get_priority_insights"
+        ],
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "recommended_sections": {
+      "items": {
+        "enum": [
+          "kpi_summary",
+          "trend",
+          "ad_spend_context",
+          "breakdown",
+          "priority_insights",
+          "recommended_actions"
+        ],
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "response_type": {
+      "enum": [
+        "analytics_summary",
+        "analytics_breakdown",
+        "priority_insights"
+      ],
+      "type": "string"
+    },
+    "show_breakdown": {
+      "type": "boolean"
+    },
+    "show_period_comparison": {
+      "type": "boolean"
+    },
+    "show_priority_insights": {
+      "type": "boolean"
+    },
+    "show_trend": {
+      "type": "boolean"
+    }
+  },
+  "required": [
+    "response_type",
+    "primary_metric",
+    "show_period_comparison",
+    "show_trend",
+    "show_breakdown",
+    "show_priority_insights",
+    "prefer_compact_visual_summary",
+    "avoid_long_prose",
+    "recommended_followup_tools",
+    "recommended_sections"
+  ],
+  "type": "object"
+}

changedOutput schema / required

Previous value: -[
-  "site_id",
-  "period",
-  "previous_period",
-  "basis",
-  "kpis",
-  "trend",
-  "path_recommendation",
-  "ad_spend_data_status",
-  "connected_channels",
-  "ad_spend_channels_in_period",
-  "ad_spend_rows_in_period"
-]New value: +[
+  "site_id",
+  "period",
+  "previous_period",
+  "basis",
+  "kpis",
+  "trend",
+  "path_recommendation",
+  "ad_spend_data_status",
+  "connected_channels",
+  "ad_spend_channels_in_period",
+  "ad_spend_rows_in_period",
+  "presentation_hints"
+]

Changed4 schema fields changedSep 3, 2026

addedOutput schema / properties / kpis / properties / avg_duration_depth_basis

Added value: +{
+  "anyOf": [
+    {
+      "additionalProperties": false,
+      "properties": {
+        "change": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "previous": {
+          "type": [
+            "number",
+            "null"
+          ]
+        },
+        "value": {
+          "type": "number"
+        }
+      },
+      "required": [
+        "value",
+        "previous",
+        "change"
+      ],
+      "type": "object"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / kpis / properties / median_duration_depth_basis

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/properties/kpis/properties/avg_duration_depth_basis/anyOf/0"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

addedOutput schema / properties / kpis / properties / median_scroll_depth

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/properties/kpis/properties/avg_duration_depth_basis/anyOf/0"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

changedOutput schema / properties / kpis / required

Previous value: -[
-  "revenue",
-  "sessions",
-  "rps",
-  "aov",
-  "cvr",
-  "avg_duration",
-  "bounce_rate",
-  "scroll_depth",
-  "roas"
-]New value: +[
+  "revenue",
+  "sessions",
+  "rps",
+  "aov",
+  "cvr",
+  "avg_duration",
+  "bounce_rate",
+  "scroll_depth",
+  "avg_duration_depth_basis",
+  "median_duration_depth_basis",
+  "median_scroll_depth",
+  "roas"
+]

Changed2 schema fields changedAug 28, 2026

addedOutput schema / properties / kpis / properties / scroll_depth

Added value: +{
+  "anyOf": [
+    {
+      "$ref": "#/properties/kpis/properties/revenue"
+    },
+    {
+      "type": "null"
+    }
+  ]
+}

changedOutput schema / properties / kpis / required

Previous value: -[
-  "revenue",
-  "sessions",
-  "rps",
-  "aov",
-  "cvr",
-  "avg_duration",
-  "bounce_rate",
-  "roas"
-]New value: +[
+  "revenue",
+  "sessions",
+  "rps",
+  "aov",
+  "cvr",
+  "avg_duration",
+  "bounce_rate",
+  "scroll_depth",
+  "roas"
+]

Changed1 schema field changedJul 20, 2026

changedOutput schema / properties / kpis / properties / roas / anyOf

Previous value: -[
-  {
-    "$ref": "#/properties/kpis/properties/revenue"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": false,
+    "properties": {
+      "change": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "previous": {
+        "type": [
+          "number",
+          "null"
+        ]
+      },
+      "value": {
+        "type": "number"
+      }
+    },
+    "required": [
+      "value",
+      "previous",
+      "change"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed2 schema fields changedJul 20, 2026

removedOutput schema / properties / ad_spend_rows_last_7d
```
Removed value: -{
-  "type": "number"
-}
```

changedOutput schema / required

Previous value: -[
-  "site_id",
-  "period",
-  "previous_period",
-  "basis",
-  "kpis",
-  "trend",
-  "path_recommendation",
-  "ad_spend_data_status",
-  "connected_channels",
-  "ad_spend_channels_in_period",
-  "ad_spend_rows_in_period",
-  "ad_spend_rows_last_7d"
-]New value: +[
+  "site_id",
+  "period",
+  "previous_period",
+  "basis",
+  "kpis",
+  "trend",
+  "path_recommendation",
+  "ad_spend_data_status",
+  "connected_channels",
+  "ad_spend_channels_in_period",
+  "ad_spend_rows_in_period"
+]

Changed5 schema fields changedJun 25, 2026

addedInput schema / properties / country

Added value: +{
+  "maxLength": 2,
+  "minLength": 2,
+  "type": "string"
+}

addedInput schema / properties / device

Added value: +{
+  "enum": [
+    "mobile",
+    "desktop",
+    "tablet"
+  ],
+  "type": "string"
+}

addedOutput schema / properties / kpis / properties / avg_duration

Added value: +{
+  "$ref": "#/properties/kpis/properties/revenue"
+}

addedOutput schema / properties / kpis / properties / bounce_rate

Added value: +{
+  "$ref": "#/properties/kpis/properties/revenue"
+}

changedOutput schema / properties / kpis / required

Previous value: -[
-  "revenue",
-  "sessions",
-  "rps",
-  "aov",
-  "cvr",
-  "roas"
-]New value: +[
+  "revenue",
+  "sessions",
+  "rps",
+  "aov",
+  "cvr",
+  "avg_duration",
+  "bounce_rate",
+  "roas"
+]

Changed1 schema field changedJun 21, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "http://json-schema.org/draft-07/schema#",
+  "additionalProperties": false,
+  "properties": {
+    "ad_spend_channels_in_period": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "ad_spend_data_status": {
+      "enum": [
+        "connected",
+        "pending",
+        "none"
+      ],
+      "type": "string"
+    },
+    "ad_spend_rows_in_period": {
+      "type": "number"
+    },
+    "ad_spend_rows_last_7d": {
+      "type": "number"
+    },
+    "basis": {
+      "type": "string"
+    },
+    "connected_channels": {
+      "items": {
+        "type": "string"
+      },
+      "type": "array"
+    },
+    "kpis": {
+      "additionalProperties": false,
+      "properties": {
+        "aov": {
+          "$ref": "#/properties/kpis/properties/revenue"
+        },
+        "cvr": {
+          "$ref": "#/properties/kpis/properties/revenue"
+        },
+        "revenue": {
+          "additionalProperties": false,
+          "properties": {
+            "change": {
+              "type": "number"
+            },
+            "previous": {
+              "type": "number"
+            },
+            "value": {
+              "type": "number"
+            }
+          },
+          "required": [
+            "value",
+            "previous",
+            "change"
+          ],
+          "type": "object"
+        },
+        "roas": {
+          "anyOf": [
+            {
+              "$ref": "#/properties/kpis/properties/revenue"
+            },
+            {
+              "type": "null"
+            }
+          ]
+        },
+        "rps": {
+          "$ref": "#/properties/kpis/properties/revenue"
+        },
+        "sessions": {
+          "$ref": "#/properties/kpis/properties/revenue"
+        }
+      },
+      "required": [
+        "revenue",
+        "sessions",
+        "rps",
+        "aov",
+        "cvr",
+        "roas"
+      ],
+      "type": "object"
+    },
+    "path_recommendation": {
+      "enum": [
+        "A",
+        "B"
+      ],
+      "type": "string"
+    },
+    "period": {
+      "additionalProperties": false,
+      "properties": {
+        "days": {
+          "type": "number"
+        },
+        "end": {
+          "type": "string"
+        },
+        "start": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "start",
+        "end",
+        "days"
+      ],
+      "type": "object"
+    },
+    "previous_period": {
+      "additionalProperties": false,
+      "properties": {
+        "end": {
+          "type": "string"
+        },
+        "start": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "start",
+        "end"
+      ],
+      "type": "object"
+    },
+    "site_id": {
+      "type": "string"
+    },
+    "trend": {
+      "items": {
+        "additionalProperties": false,
+        "properties": {
+          "conversions": {
+            "type": "number"
+          },
+          "cvr": {
+            "type": "number"
+          },
+          "date": {
+            "type": "string"
+          },
+          "revenue": {
+            "type": "number"
+          },
+          "sessions": {
+            "type": "number"
+          }
+        },
+        "required": [
+          "date",
+          "revenue",
+          "sessions",
+          "conversions",
+          "cvr"
+        ],
+        "type": "object"
+      },
+      "type": "array"
+    }
+  },
+  "required": [
+    "site_id",
+    "period",
+    "previous_period",
+    "basis",
+    "kpis",
+    "trend",
+    "path_recommendation",
+    "ad_spend_data_status",
+    "connected_channels",
+    "ad_spend_channels_in_period",
+    "ad_spend_rows_in_period",
+    "ad_spend_rows_last_7d"
+  ],
+  "type": "object"
+}

AddedJun 3, 2026

TDQS

Score is being calculated.

All RevenueScope: revenue-first analytics for your EC site 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?