AI Agent Analytics

Get Daily Pulse

get_daily_pulse

Read-onlyIdempotent

Return the customer's latest precomputed 24-hour Daily Pulse snapshot. Use this for the same bounded once-daily view shown in the customer dashboard. It does not run a historical event scan when called and takes no parameters because the organization comes from the authorization. Requires analytics:read; if the first 6 PM local snapshot has not been built yet, state is preparing.

Input Schema

TableJSON Schema

Name	Required	Description	Default
No arguments

Output Schema

TableJSON Schema

Name	Required	Description
`state`	Yes	Whether a precomputed Daily Pulse snapshot is available.
`schema`	Yes	Delegated Daily Pulse response schema.
`source`	Yes
`snapshot`	Yes
`organization`	Yes
`history_scan_on_read`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed14 schema fields changedOct 3, 2026

addedInput schema / additionalProperties
```
Added value: +false
```

addedInput schema / description

Added value: +"This tool takes no parameters."

removedInput schema / properties / day

Removed value: -{
-  "description": "Product-local calendar day as YYYY-MM-DD. Omit to read the current product-local day, with live-pulse fallback when the finalized daily pulse is not ready.",
-  "pattern": "^\\d{4}-\\d{2}-\\d{2}$",
-  "type": "string"
-}

removedInput schema / properties / product_id

Removed value: -{
-  "description": "Exact AI Agent Analytics product/property ID returned by list_products. Do not pass a product name, URL, or organization ID.",
-  "pattern": "^[A-Za-z0-9._:-]{1,160}$",
-  "type": "string"
-}

removedInput schema / required
```
Removed value: -[
-  "product_id"
-]
```

addedOutput schema / properties / history_scan_on_read

Added value: +{
+  "const": false,
+  "type": "boolean"
+}

addedOutput schema / properties / organization

Added value: +{
+  "additionalProperties": {},
+  "properties": {
+    "id": {
+      "type": "string"
+    },
+    "name": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "id",
+    "name"
+  ],
+  "type": "object"
+}

removedOutput schema / properties / product

Removed value: -{
-  "additionalProperties": {},
-  "properties": {
-    "id": {
-      "description": "Tenant-checked product/property ID.",
-      "type": "string"
-    },
-    "name": {
-      "description": "Product name.",
-      "type": "string"
-    },
-    "time_zone": {
-      "description": "IANA time zone used for product-local interpretation.",
-      "type": "string"
-    }
-  },
-  "required": [
-    "id",
-    "name",
-    "time_zone"
-  ],
-  "type": "object"
-}

removedOutput schema / properties / pulse

Removed value: -{
-  "additionalProperties": {},
-  "properties": {
-    "biggest_opportunity": {
-      "description": "Largest observed opportunity or next useful observation.",
-      "type": "string"
-    },
-    "confidence": {
-      "description": "Evidence confidence label.",
-      "type": "string"
-    },
-    "day": {
-      "description": "Product-local YYYY-MM-DD day represented by this pulse.",
-      "type": [
-        "string",
-        "null"
-      ]
-    },
-    "generated_at": {
-      "description": "UTC timestamp when the pulse was generated.",
-      "type": "string"
-    },
-    "integrity": {
-      "additionalProperties": {},
-      "description": "Evidence-quality and exclusion details.",
-      "properties": {
-        "note": {
-          "type": "string"
-        },
-        "source_completeness_proven": {
-          "type": "boolean"
-        },
-        "strict_external_settlements": {
-          "maximum": 9007199254740991,
-          "minimum": 0,
-          "type": "integer"
-        },
-        "synthetic_events": {
-          "maximum": 9007199254740991,
-          "minimum": 0,
-          "type": "integer"
-        },
-        "unclassified_settled_commerce": {
-          "maximum": 9007199254740991,
-          "minimum": 0,
-          "type": "integer"
-        },
-        "unknown_external_events": {
-          "maximum": 9007199254740991,
-          "minimum": 0,
-          "type": "integer"
-        }
-      },
-      "type": "object"
-    },
-    "live_window_end": {
-      "description": "End of the partial live window when state is live_partial.",
-      "type": "string"
-    },
-    "live_window_start": {
-      "description": "Start of the partial live window when state is live_partial.",
-      "type": "string"
-    },
-    "metrics": {
-      "anyOf": [
-        {
-          "additionalProperties": {},
-          "properties": {
-            "agent_revenue": {
-              "additionalProperties": {
-                "type": "string"
-              },
-              "description": "Settled minor-unit amounts keyed by an exact currency/asset/network identity; unlike money is never combined.",
-              "propertyNames": {
-                "type": "string"
-              },
-              "type": "object"
-            },
-            "conversion": {
-              "additionalProperties": {},
-              "properties": {
-                "converted_agents": {
-                  "maximum": 9007199254740991,
-                  "minimum": 0,
-                  "type": "integer"
-                },
-                "intent_agents": {
-                  "maximum": 9007199254740991,
-                  "minimum": 0,
-                  "type": "integer"
-                },
-                "rate": {
-                  "anyOf": [
-                    {
-                      "maximum": 1,
-                      "minimum": 0,
-                      "type": "number"
-                    },
-                    {
-                      "type": "null"
-                    }
-                  ]
-                }
-              },
-              "required": [
-                "converted_agents",
-                "intent_agents",
-                "rate"
-              ],
-              "type": "object"
-            },
-            "paid_intent": {
-              "description": "Countable-external actors with paid-intent evidence.",
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "real_agents": {
-              "description": "Countable-external pseudonymous actors.",
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "repeat_agents": {
-              "description": "Same pseudonymous actor observed on at least two distinct observed days.",
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "repeat_purchasers": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "repeated_invocation_agents": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "returning_agents": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "successful_delivery": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            }
-          },
-          "required": [
-            "real_agents",
-            "paid_intent",
-            "conversion",
-            "agent_revenue",
-            "successful_delivery",
-            "repeat_agents"
-          ],
-          "type": "object"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "observed_funnel": {
-      "anyOf": [
-        {
-          "additionalProperties": {},
-          "description": "Observed event counts by canonical commerce-funnel stage.",
-          "properties": {
-            "discovery": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "eligibility_accepted": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "eligibility_rejected": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "evaluation": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "free_or_preflight_invocations": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "paid_deliveries": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "paid_operation_invocations": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "payment_attempts": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "payment_challenges": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "settlements": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            }
-          },
-          "required": [
-            "discovery",
-            "evaluation",
-            "free_or_preflight_invocations",
-            "paid_operation_invocations",
-            "eligibility_accepted",
-            "eligibility_rejected",
-            "payment_challenges",
-            "payment_attempts",
-            "settlements",
-            "paid_deliveries"
-          ],
-          "type": "object"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "schema_version": {
-      "description": "Daily Pulse schema version.",
-      "type": "string"
-    },
-    "state": {
-      "description": "Pulse state such as ready, live_partial, or unavailable.",
-      "type": "string"
-    },
-    "strict_external_funnel": {
-      "anyOf": [
-        {
-          "additionalProperties": {},
-          "description": "Observed event counts by canonical commerce-funnel stage.",
-          "properties": {
-            "discovery": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "eligibility_accepted": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "eligibility_rejected": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "evaluation": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "free_or_preflight_invocations": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "paid_deliveries": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "paid_operation_invocations": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "payment_attempts": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "payment_challenges": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            },
-            "settlements": {
-              "maximum": 9007199254740991,
-              "minimum": 0,
-              "type": "integer"
-            }
-          },
-          "required": [
-            "discovery",
-            "evaluation",
-            "free_or_preflight_invocations",
-            "paid_operation_invocations",
-            "eligibility_accepted",
-            "eligibility_rejected",
-            "payment_challenges",
-            "payment_attempts",
-            "settlements",
-            "paid_deliveries"
-          ],
-          "type": "object"
-        },
-        {
-          "type": "null"
-        }
-      ]
-    },
-    "time_zone": {
-      "description": "IANA time zone used for the product-local day.",
-      "type": "string"
-    },
-    "what_happened": {
-      "description": "Evidence-grounded activity summary.",
-      "type": "string"
-    }
-  },
-  "required": [
-    "schema_version",
-    "day",
-    "generated_at",
-    "state",
-    "time_zone"
-  ],
-  "type": "object"
-}

changedOutput schema / properties / schema / description

Previous value: -"Delegated response schema identifier."New value: +"Delegated Daily Pulse response schema."

addedOutput schema / properties / snapshot

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

addedOutput schema / properties / source

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

addedOutput schema / properties / state

Added value: +{
+  "description": "Whether a precomputed Daily Pulse snapshot is available.",
+  "enum": [
+    "ready",
+    "preparing"
+  ],
+  "type": "string"
+}

changedOutput schema / required

Previous value: -[
-  "schema",
-  "product",
-  "pulse"
-]New value: +[
+  "schema",
+  "state",
+  "source",
+  "history_scan_on_read",
+  "organization",
+  "snapshot"
+]

Changed1 schema field changedSep 22, 2026

changedOutput schema / properties / pulse / properties / metrics / anyOf

Previous value: -[
-  {
-    "additionalProperties": {},
-    "properties": {
-      "agent_revenue": {
-        "additionalProperties": {
-          "type": "string"
-        },
-        "description": "Settled minor-unit amounts keyed by an exact currency/asset/network identity; unlike money is never combined.",
-        "propertyNames": {
-          "type": "string"
-        },
-        "type": "object"
-      },
-      "conversion": {
-        "additionalProperties": {},
-        "properties": {
-          "converted_agents": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "intent_agents": {
-            "maximum": 9007199254740991,
-            "minimum": 0,
-            "type": "integer"
-          },
-          "rate": {
-            "anyOf": [
-              {
-                "maximum": 1,
-                "minimum": 0,
-                "type": "number"
-              },
-              {
-                "type": "null"
-              }
-            ]
-          }
-        },
-        "required": [
-          "converted_agents",
-          "intent_agents",
-          "rate"
-        ],
-        "type": "object"
-      },
-      "paid_intent": {
-        "description": "Countable-external actors with paid-intent evidence.",
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "real_agents": {
-        "description": "Countable-external pseudonymous actors.",
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "repeat_agents": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      },
-      "successful_delivery": {
-        "maximum": 9007199254740991,
-        "minimum": 0,
-        "type": "integer"
-      }
-    },
-    "required": [
-      "real_agents",
-      "paid_intent",
-      "conversion",
-      "agent_revenue",
-      "successful_delivery",
-      "repeat_agents"
-    ],
-    "type": "object"
-  },
-  {
-    "type": "null"
-  }
-]New value: +[
+  {
+    "additionalProperties": {},
+    "properties": {
+      "agent_revenue": {
+        "additionalProperties": {
+          "type": "string"
+        },
+        "description": "Settled minor-unit amounts keyed by an exact currency/asset/network identity; unlike money is never combined.",
+        "propertyNames": {
+          "type": "string"
+        },
+        "type": "object"
+      },
+      "conversion": {
+        "additionalProperties": {},
+        "properties": {
+          "converted_agents": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "intent_agents": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "rate": {
+            "anyOf": [
+              {
+                "maximum": 1,
+                "minimum": 0,
+                "type": "number"
+              },
+              {
+                "type": "null"
+              }
+            ]
+          }
+        },
+        "required": [
+          "converted_agents",
+          "intent_agents",
+          "rate"
+        ],
+        "type": "object"
+      },
+      "paid_intent": {
+        "description": "Countable-external actors with paid-intent evidence.",
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "real_agents": {
+        "description": "Countable-external pseudonymous actors.",
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "repeat_agents": {
+        "description": "Same pseudonymous actor observed on at least two distinct observed days.",
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "repeat_purchasers": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "repeated_invocation_agents": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "returning_agents": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "successful_delivery": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      }
+    },
+    "required": [
+      "real_agents",
+      "paid_intent",
+      "conversion",
+      "agent_revenue",
+      "successful_delivery",
+      "repeat_agents"
+    ],
+    "type": "object"
+  },
+  {
+    "type": "null"
+  }
+]

Changed8 schema fields changedSep 19, 2026

changedOutput schema / properties / product / properties / id / description

Previous value: -"Product/property ID."New value: +"Tenant-checked product/property ID."

changedOutput schema / properties / product / properties / time_zone / description

Previous value: -"IANA time zone used for product-local daily interpretation."New value: +"IANA time zone used for product-local interpretation."

addedOutput schema / properties / pulse / additionalProperties
```
Added value: +{}
```

removedOutput schema / properties / pulse / description

Removed value: -"Daily Pulse payload containing the six core metrics plus evidence-integrity state."

addedOutput schema / properties / pulse / properties

Added value: +{
+  "biggest_opportunity": {
+    "description": "Largest observed opportunity or next useful observation.",
+    "type": "string"
+  },
+  "confidence": {
+    "description": "Evidence confidence label.",
+    "type": "string"
+  },
+  "day": {
+    "description": "Product-local YYYY-MM-DD day represented by this pulse.",
+    "type": [
+      "string",
+      "null"
+    ]
+  },
+  "generated_at": {
+    "description": "UTC timestamp when the pulse was generated.",
+    "type": "string"
+  },
+  "integrity": {
+    "additionalProperties": {},
+    "description": "Evidence-quality and exclusion details.",
+    "properties": {
+      "note": {
+        "type": "string"
+      },
+      "source_completeness_proven": {
+        "type": "boolean"
+      },
+      "strict_external_settlements": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "synthetic_events": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "unclassified_settled_commerce": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      },
+      "unknown_external_events": {
+        "maximum": 9007199254740991,
+        "minimum": 0,
+        "type": "integer"
+      }
+    },
+    "type": "object"
+  },
+  "live_window_end": {
+    "description": "End of the partial live window when state is live_partial.",
+    "type": "string"
+  },
+  "live_window_start": {
+    "description": "Start of the partial live window when state is live_partial.",
+    "type": "string"
+  },
+  "metrics": {
+    "anyOf": [
+      {
+        "additionalProperties": {},
+        "properties": {
+          "agent_revenue": {
+            "additionalProperties": {
+              "type": "string"
+            },
+            "description": "Settled minor-unit amounts keyed by an exact currency/asset/network identity; unlike money is never combined.",
+            "propertyNames": {
+              "type": "string"
+            },
+            "type": "object"
+          },
+          "conversion": {
+            "additionalProperties": {},
+            "properties": {
+              "converted_agents": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
+              },
+              "intent_agents": {
+                "maximum": 9007199254740991,
+                "minimum": 0,
+                "type": "integer"
+              },
+              "rate": {
+                "anyOf": [
+                  {
+                    "maximum": 1,
+                    "minimum": 0,
+                    "type": "number"
+                  },
+                  {
+                    "type": "null"
+                  }
+                ]
+              }
+            },
+            "required": [
+              "converted_agents",
+              "intent_agents",
+              "rate"
+            ],
+            "type": "object"
+          },
+          "paid_intent": {
+            "description": "Countable-external actors with paid-intent evidence.",
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "real_agents": {
+            "description": "Countable-external pseudonymous actors.",
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "repeat_agents": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "successful_delivery": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "real_agents",
+          "paid_intent",
+          "conversion",
+          "agent_revenue",
+          "successful_delivery",
+          "repeat_agents"
+        ],
+        "type": "object"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "observed_funnel": {
+    "anyOf": [
+      {
+        "additionalProperties": {},
+        "description": "Observed event counts by canonical commerce-funnel stage.",
+        "properties": {
+          "discovery": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "eligibility_accepted": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "eligibility_rejected": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "evaluation": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "free_or_preflight_invocations": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "paid_deliveries": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "paid_operation_invocations": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "payment_attempts": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "payment_challenges": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "settlements": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "discovery",
+          "evaluation",
+          "free_or_preflight_invocations",
+          "paid_operation_invocations",
+          "eligibility_accepted",
+          "eligibility_rejected",
+          "payment_challenges",
+          "payment_attempts",
+          "settlements",
+          "paid_deliveries"
+        ],
+        "type": "object"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "schema_version": {
+    "description": "Daily Pulse schema version.",
+    "type": "string"
+  },
+  "state": {
+    "description": "Pulse state such as ready, live_partial, or unavailable.",
+    "type": "string"
+  },
+  "strict_external_funnel": {
+    "anyOf": [
+      {
+        "additionalProperties": {},
+        "description": "Observed event counts by canonical commerce-funnel stage.",
+        "properties": {
+          "discovery": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "eligibility_accepted": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "eligibility_rejected": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "evaluation": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "free_or_preflight_invocations": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "paid_deliveries": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "paid_operation_invocations": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "payment_attempts": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "payment_challenges": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "settlements": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          }
+        },
+        "required": [
+          "discovery",
+          "evaluation",
+          "free_or_preflight_invocations",
+          "paid_operation_invocations",
+          "eligibility_accepted",
+          "eligibility_rejected",
+          "payment_challenges",
+          "payment_attempts",
+          "settlements",
+          "paid_deliveries"
+        ],
+        "type": "object"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "time_zone": {
+    "description": "IANA time zone used for the product-local day.",
+    "type": "string"
+  },
+  "what_happened": {
+    "description": "Evidence-grounded activity summary.",
+    "type": "string"
+  }
+}

addedOutput schema / properties / pulse / required

Added value: +[
+  "schema_version",
+  "day",
+  "generated_at",
+  "state",
+  "time_zone"
+]

addedOutput schema / properties / pulse / type
```
Added value: +"object"
```

changedOutput schema / properties / schema / description

Previous value: -"Response schema identifier."New value: +"Delegated response schema identifier."

Changed3 schema fields changedSep 19, 2026

changedInput schema / properties / day / description

Previous value: -"Optional YYYY-MM-DD day in the product's configured time zone."New value: +"Product-local calendar day as YYYY-MM-DD. Omit to read the current product-local day, with live-pulse fallback when the finalized daily pulse is not ready."

changedInput schema / properties / product_id / description

Previous value: -"AI Agent Analytics product/property ID from list_products."New value: +"Exact AI Agent Analytics product/property ID returned by list_products. Do not pass a product name, URL, or organization ID."

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "$schema": "https://json-schema.org/draft/2020-12/schema",
+  "additionalProperties": {},
+  "properties": {
+    "product": {
+      "additionalProperties": {},
+      "properties": {
+        "id": {
+          "description": "Product/property ID.",
+          "type": "string"
+        },
+        "name": {
+          "description": "Product name.",
+          "type": "string"
+        },
+        "time_zone": {
+          "description": "IANA time zone used for product-local daily interpretation.",
+          "type": "string"
+        }
+      },
+      "required": [
+        "id",
+        "name",
+        "time_zone"
+      ],
+      "type": "object"
+    },
+    "pulse": {
+      "description": "Daily Pulse payload containing the six core metrics plus evidence-integrity state."
+    },
+    "schema": {
+      "description": "Response schema identifier.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "schema",
+    "product",
+    "pulse"
+  ],
+  "type": "object"
+}

First observedSep 19, 2026

TDQS

A4.7/5.0

Behavior5/5

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

Annotations already cover read-only, idempotent, non-destructive, closed-world semantics, and the description still adds material behavior: it requires the analytics:read scope, it deliberately performs no historical event scan, and it returns state 'preparing' before the first 6 PM local snapshot exists. Those are exactly the runtime traits an agent cannot infer from the schema or annotations.

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

Conciseness5/5

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

Four tight sentences, front-loaded with what is returned, then usage, then the no-scan/no-param rationale, then the auth and timing caveats. No sentence is redundant with the schema or annotations.

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

Completeness5/5

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

An output schema exists, so return shape need not be described. Combined with annotations and a parameterless schema, the description supplies everything else an agent needs: the precomputed once-daily nature, the missing historical scan, the required scope, and the not-yet-built 'preparing' state.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

Zero parameters gives a baseline of 4, and the schema already says 'This tool takes no parameters.' The description adds real meaning beyond that by explaining why there are none and where scoping comes from instead ('the organization comes from the authorization'), which tells the agent it cannot target another org.

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

Purpose5/5

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

States a specific verb and resource ('Return the customer's latest precomputed 24-hour Daily Pulse snapshot') and clarifies the concept for an agent that may not know the domain term by anchoring it to 'the same bounded once-daily view shown in the customer dashboard.' Siblings (list_products, scan_agent_commerce_readiness) are clearly a different domain, so no sibling disambiguation is needed.

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

Usage Guidelines4/5

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

Gives a clear use condition ('Use this for the same bounded once-daily view shown in the customer dashboard') and a negative scoping statement ('does not run a historical event scan when called'), which implicitly steers the agent elsewhere for historical/event-level analysis. It never names the alternative tool for that case, so it stops short of a 5.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

All AI Agent Analytics 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?