AI Agent Analytics

Get bounded product report

get_report

Read-onlyIdempotent

Return an evidence-backed report for product_id over the required half-open UTC window [start, end). Use this for bounded multi-day analysis; do not use it for one day, use get_daily_pulse, for metric rationale, use get_evidence, or for settlement-focused analysis, use get_revenue. start and end are required UTC YYYY-MM-DD dates: start is inclusive, end is exclusive, and the span cannot exceed 31 days. Requires analytics:read; insufficient-history windows return an explicit unavailable blocker rather than invented data, and the shared MCP limit is 300 calls per 60 seconds per caller before HTTP 429 with Retry-After.

Input Schema

TableJSON Schema

Name	Required	Description
`end`	Yes	Required UTC calendar end date as YYYY-MM-DD, exclusive. Must be after start and no more than 31 UTC days later.
`start`	Yes	Required UTC calendar start date as YYYY-MM-DD, inclusive.
`product_id`	Yes	Exact AI Agent Analytics product/property ID returned by list_products. Do not pass a product name, URL, or organization ID.

Output Schema

TableJSON Schema

Name	Required	Description
`report`	Yes
`schema`	Yes	Delegated response schema identifier.
`product`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

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 / report / additionalProperties
```
Added value: +{}
```

removedOutput schema / properties / report / description

Removed value: -"Bounded report with coverage state, six core metrics, observed and strict-external funnels, diagnostics, and integrity notes."

addedOutput schema / properties / report / properties

Added value: +{
+  "blocker": {
+    "description": "Reason the requested report is unavailable.",
+    "type": "string"
+  },
+  "coverage": {
+    "anyOf": [
+      {
+        "additionalProperties": {},
+        "properties": {
+          "first_seen_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          },
+          "last_seen_at": {
+            "type": [
+              "string",
+              "null"
+            ]
+          }
+        },
+        "required": [
+          "first_seen_at",
+          "last_seen_at"
+        ],
+        "type": "object"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "coverage_assurance": {
+    "description": "Evidence-coverage assurance label.",
+    "type": "string"
+  },
+  "diagnostic": {
+    "anyOf": [
+      {
+        "additionalProperties": {},
+        "properties": {
+          "evidence_level": {
+            "type": "string"
+          },
+          "from_count": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "from_stage": {
+            "type": "string"
+          },
+          "lost": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "to_count": {
+            "maximum": 9007199254740991,
+            "minimum": 0,
+            "type": "integer"
+          },
+          "to_stage": {
+            "type": "string"
+          }
+        },
+        "required": [
+          "evidence_level",
+          "from_stage",
+          "to_stage",
+          "from_count",
+          "to_count",
+          "lost"
+        ],
+        "type": "object"
+      },
+      {
+        "type": "null"
+      }
+    ]
+  },
+  "generated_at": {
+    "description": "UTC generation timestamp.",
+    "type": "string"
+  },
+  "integrity": {
+    "additionalProperties": {},
+    "properties": {
+      "actor_identity_evidence_present": {
+        "type": "boolean"
+      },
+      "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"
+      }
+    },
+    "required": [
+      "synthetic_events",
+      "unknown_external_events",
+      "unclassified_settled_commerce",
+      "strict_external_settlements",
+      "actor_identity_evidence_present",
+      "source_completeness_proven",
+      "note"
+    ],
+    "type": "object"
+  },
+  "measurement_type": {
+    "description": "observed_utc_day_window or unavailable.",
+    "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"
+      }
+    ]
+  },
+  "property_id": {
+    "description": "Product/property ID when report evidence is available.",
+    "type": "string"
+  },
+  "schema_version": {
+    "description": "Report schema version.",
+    "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"
+      }
+    ]
+  },
+  "window_end": {
+    "description": "Exclusive UTC report-window end.",
+    "type": "string"
+  },
+  "window_start": {
+    "description": "Inclusive UTC report-window start.",
+    "type": "string"
+  }
+}

addedOutput schema / properties / report / required

Added value: +[
+  "schema_version",
+  "measurement_type",
+  "coverage_assurance",
+  "window_start",
+  "window_end",
+  "generated_at",
+  "coverage",
+  "metrics",
+  "observed_funnel",
+  "strict_external_funnel",
+  "diagnostic"
+]

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

changedOutput schema / properties / schema / description

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

Changed7 schema fields changedSep 19, 2026

changedInput schema / properties / end / description

Previous value: -"Optional report end accepted by the canonical report API."New value: +"Required UTC calendar end date as YYYY-MM-DD, exclusive. Must be after start and no more than 31 UTC days later."

addedInput schema / properties / end / pattern
```
Added value: +"^\\d{4}-\\d{2}-\\d{2}$"
```

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."

changedInput schema / properties / start / description

Previous value: -"Optional report start accepted by the canonical report API."New value: +"Required UTC calendar start date as YYYY-MM-DD, inclusive."

addedInput schema / properties / start / pattern
```
Added value: +"^\\d{4}-\\d{2}-\\d{2}$"
```

changedInput schema / required

Previous value: -[
-  "product_id"
-]New value: +[
+  "product_id",
+  "start",
+  "end"
+]

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"
+    },
+    "report": {
+      "description": "Bounded report with coverage state, six core metrics, observed and strict-external funnels, diagnostics, and integrity notes."
+    },
+    "schema": {
+      "description": "Response schema identifier.",
+      "type": "string"
+    }
+  },
+  "required": [
+    "schema",
+    "product",
+    "report"
+  ],
+  "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 mark this as read-only and idempotent, and the description goes beyond them by disclosing authentication needs ('Requires analytics:read'), data integrity behavior ('insufficient-history windows return an explicit unavailable blocker rather than invented data'), and rate limiting ('shared MCP limit is 300 calls per 60 seconds per caller before HTTP 429 with Retry-After'). These are material operational behaviors not inferable from the annotations or schema.

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?

The description is three sentences with no filler. It front-loads the action and resource, then gives routing guidance, then packs constraints and caveats into the final sentence. Every clause contributes operational information an agent needs.

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?

The description covers what the tool does, when to use it, how to avoid misrouting to siblings, required parameters and their temporal semantics, authorization, availability behavior, and rate limits. Given the output schema exists and the tool's complexity, nothing essential for invoking it correctly is missing.

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

Parameters3/5

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

Schema description coverage is 100%, and the schema already documents start as inclusive, end as exclusive, and the 31-day span limit. The description adds a useful conceptual frame with 'half-open UTC window' and restates the span limit, but does not materially add meaning beyond the schema's parameter-level details. The product_id guidance in the schema is actually richer than in the description.

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?

The description clearly states a specific verb and resource: 'Return an evidence-backed report for product_id over the required half-open UTC window [start, end).' It also explicitly differentiates this tool from siblings by naming what it is not for, such as get_daily_pulse, get_evidence, and get_revenue, so an agent can select it unambiguously.

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

Usage Guidelines5/5

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

The description provides explicit when-to-use and when-not-to-use guidance: 'Use this for bounded multi-day analysis; do not use it for one day, use get_daily_pulse, for metric rationale, use get_evidence, or for settlement-focused analysis, use get_revenue.' This clearly routes the agent to the correct alternative based on analysis type.

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?