Utility Matrix

Apdex Score Calculator

apdex-score-calculator

Read-onlyIdempotent

Use this when a user asks about their Apdex score or wants to measure user satisfaction with response times. Takes satisfied, tolerating, and total request counts; satisfied plus tolerating may not exceed total. Returns the Apdex score (0–1) and its rating on the published five-band scale: excellent, good, fair, poor or unacceptable.

Input Schema

TableJSON Schema

Name	Required	Description
`total`	Yes	All requests in the sample, including frustrated ones (slower than 4T or failed).
`satisfied`	Yes	Requests answered within the target threshold T.
`tolerating`	Yes	Requests answered between T and 4T.

Output Schema

TableJSON Schema

Name	Required	Description	Default
`rating`	Yes
`next_step`	Yes
`apdex_score`	Yes
`rating_band`	Yes
`next_step_url`	Yes
`satisfied_pct`	Yes
`total_samples`	Yes
`why_follow_up`	Yes
`frustrated_pct`	Yes
`interpretation`	Yes
`tolerating_pct`	Yes
`affiliate_context`	No
`computation_basis`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed11 schema fields changedOct 11, 2026

changedInput schema / properties / satisfied / description

Previous value: -"satisfied used by this deterministic tool."New value: +"Requests answered within the target threshold T."

changedInput schema / properties / satisfied / examples
```
Previous value: -[
-  1
-]New value: +[
+  850
+]
```

changedInput schema / properties / tolerating / description

Previous value: -"tolerating used by this deterministic tool."New value: +"Requests answered between T and 4T."

changedInput schema / properties / tolerating / examples
```
Previous value: -[
-  1
-]New value: +[
+  100
+]
```

changedInput schema / properties / total / description

Previous value: -"Total number of requests observed in the measurement window."New value: +"All requests in the sample, including frustrated ones (slower than 4T or failed)."

changedInput schema / properties / total / examples

Previous value: -[
-  1
-]New value: +[
+  1000
+]

addedOutput schema / properties / frustrated_pct
```
Added value: +{
+  "type": "number"
+}
```
addedOutput schema / properties / rating_band
```
Added value: +{
+  "type": "string"
+}
```
addedOutput schema / properties / tolerating_pct
```
Added value: +{
+  "type": "number"
+}
```
addedOutput schema / properties / total_samples
```
Added value: +{
+  "type": "number"
+}
```

changedOutput schema / required

Previous value: -[
-  "apdex_score",
-  "computation_basis",
-  "interpretation",
-  "next_step",
-  "next_step_url",
-  "rating",
-  "satisfied_pct",
-  "why_follow_up"
-]New value: +[
+  "apdex_score",
+  "computation_basis",
+  "frustrated_pct",
+  "interpretation",
+  "next_step",
+  "next_step_url",
+  "rating",
+  "rating_band",
+  "satisfied_pct",
+  "tolerating_pct",
+  "total_samples",
+  "why_follow_up"
+]

Changed8 schema fields changedSep 28, 2026

addedInput schema / properties / satisfied / description

Added value: +"satisfied used by this deterministic tool."

addedInput schema / properties / satisfied / examples
```
Added value: +[
+  1
+]
```

addedInput schema / properties / tolerating / description

Added value: +"tolerating used by this deterministic tool."

addedInput schema / properties / tolerating / examples
```
Added value: +[
+  1
+]
```

addedInput schema / properties / total / description

Added value: +"Total number of requests observed in the measurement window."

addedInput schema / properties / total / examples
```
Added value: +[
+  1
+]
```
addedOutput schema / properties / computation_basis
```
Added value: +{
+  "type": "string"
+}
```

changedOutput schema / required

Previous value: -[
-  "apdex_score",
-  "interpretation",
-  "next_step",
-  "next_step_url",
-  "rating",
-  "satisfied_pct",
-  "why_follow_up"
-]New value: +[
+  "apdex_score",
+  "computation_basis",
+  "interpretation",
+  "next_step",
+  "next_step_url",
+  "rating",
+  "satisfied_pct",
+  "why_follow_up"
+]

Changed1 schema field changedJul 15, 2026

changedOutput schema / (root)

Previous value: -nullNew value: +{
+  "additionalProperties": false,
+  "properties": {
+    "affiliate_context": {
+      "additionalProperties": false,
+      "properties": {
+        "affiliate": {
+          "type": "string"
+        },
+        "cta_label": {
+          "type": "string"
+        },
+        "disclosure": {
+          "type": "string"
+        },
+        "framing": {
+          "type": "string"
+        },
+        "posture": {
+          "enum": [
+            "secondary"
+          ],
+          "type": "string"
+        },
+        "slot_id": {
+          "type": "string"
+        },
+        "url": {
+          "type": "string"
+        },
+        "variant": {
+          "type": "string"
+        }
+      },
+      "required": [
+        "affiliate",
+        "cta_label",
+        "disclosure",
+        "framing",
+        "posture",
+        "slot_id",
+        "url",
+        "variant"
+      ],
+      "type": "object"
+    },
+    "apdex_score": {
+      "type": "number"
+    },
+    "interpretation": {
+      "type": "string"
+    },
+    "next_step": {
+      "type": "string"
+    },
+    "next_step_url": {
+      "type": "string"
+    },
+    "rating": {
+      "type": "string"
+    },
+    "satisfied_pct": {
+      "type": "number"
+    },
+    "why_follow_up": {
+      "type": "string"
+    }
+  },
+  "required": [
+    "apdex_score",
+    "interpretation",
+    "next_step",
+    "next_step_url",
+    "rating",
+    "satisfied_pct",
+    "why_follow_up"
+  ],
+  "type": "object"
+}

Changed1 schema field changedJul 13, 2026
- addedInput schema / additionalProperties
```
Added value: +false
```
First observedJun 29, 2026

TDQS

Score is being calculated.

All Utility Matrix tools Inspect

Try in Browser

Shareable, User-Owned Context BackendPeople, applications, and agents read, write, and coordinate together in one context lake. Reach it over MCP, a CLI, a Python SDK, or REST.fulcradynamics.comAd

Glama MCP Gateway

Add one secure layer between your agents and this server.

Resources

Need Help?