ShotPulled

Preview a diagnosis

diagnose_preview

Read-onlyIdempotent

Sandbox-only diagnosis, writes nothing (no verdict, no recommendation-trail entry). Two modes: pass shot_id to dry-run a LOGGED shot (optionally overriding its sensory_tags, for the "what would this read as?" preview; the shot's own bean and its age at pulled_at are used), or pass the full metric set (bean_id, grinder_id, machine_id, grind_label, dose_g, yield_g, time_s, source) for a hypothetical shot. Identical output shape to diagnose_shot, including bean_context.

Input Schema

TableJSON Schema

Name	Required	Description
`dose_g`	No	Dose in grams
`source`	No	Grinder position source. Affects G1 warning (raw mode only)
`time_s`	No	Extraction time in seconds
`bean_id`	No	Coffee bean ID (must belong to this account)
`shot_id`	No	Preview a logged shot by ID (dry-run; ignores the metric params below)
`yield_g`	No	Yield in grams
`grinder_id`	No	Grinder ID (must belong to this account)
`machine_id`	No	Machine ID (must belong to this account)
`grind_label`	No	Grinder setting label, e.g. "1.1.3"
`sensory_tags`	No	Sensory observations, e.g. ["sour","bitter"]. With shot_id: replaces the stored tags for this preview (omit to use stored; [] = none).

Output Schema

TableJSON Schema

Name	Required	Description	Default
`facts`	Yes
`category`	Yes
`warnings`	Yes
`hypotheses`	Yes
`kb_version`	Yes
`bean_context`	Yes
`warning_codes`	Yes
`one_variable_only`	Yes

Schema Changelog

Changes observed during successful MCP inspections.

Changed3 schema fields changedOct 22, 2026

changedInput schema / properties / source / description

Previous value: -"Grinder position source — affects G1 warning (raw mode only)"New value: +"Grinder position source. Affects G1 warning (raw mode only)"

addedOutput schema / properties / warning_codes

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

changedOutput schema / required

Previous value: -[
-  "category",
-  "facts",
-  "hypotheses",
-  "warnings",
-  "one_variable_only",
-  "kb_version",
-  "bean_context"
-]New value: +[
+  "category",
+  "facts",
+  "hypotheses",
+  "warnings",
+  "one_variable_only",
+  "kb_version",
+  "warning_codes",
+  "bean_context"
+]

Changed2 schema fields changedSep 12, 2026

addedOutput schema / properties / bean_context / properties / bag_id
```
Added value: +{
+  "type": "integer"
+}
```

changedOutput schema / properties / bean_context / required

Previous value: -[
-  "bean_id",
-  "bean_name",
-  "roast_level",
-  "effective_age_days",
-  "dial_category"
-]New value: +[
+  "bean_id",
+  "bag_id",
+  "bean_name",
+  "roast_level",
+  "effective_age_days",
+  "dial_category"
+]

First observedSep 6, 2026

TDQS

Score is being calculated.

All ShotPulled 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?