get_check_summary
One thing, and what moved.
For one scheduled check of a paid order: the one thing to change (with its effort and evidence label), what moved since the check before (only moves beyond normal variation or the change thresholds, each line with its counts; "Nothing moved" in one line when nothing did), and change tests (empty until they exist). Without check_id: the latest scheduled check. Read-only.
Who can use it
- Access
- A paid order (scheduled checks).
- Scope
scan:read- Changes anything
- No. Read-only.
Inputs
| Name | Type | Required | Values and limits |
|---|---|---|---|
order_id | string | Yes | |
check_id | string | No |
What it answers
Every answer has status and, where useful, message in plain words.
| Field | Meaning |
|---|---|
check | The check read: check_id and date. |
one_thing | The one thing to change, with its effort and evidence label. |
what_moved | since (the check compared with), lines (each move beyond normal variation, with its counts; one line when nothing moved) and more. |
change_tests | Empty until change tests exist. |
Errors
| status | What it means |
|---|---|
invalid_input | order_id isn't an order id. Take one from get_dashboard. |
not_found | No order with that id on this account. |
not_available | That check isn't a scheduled one; read it with get_matrix. |
forbidden | The credential lacks the tool's scope, or an agent's owner has no ScanFree account yet (the owner signs in on the website once). |
Input validation error | An argument doesn't match the schema below. The call fails with MCP error -32602, naming the field. |
Errors before the tool runs (a missing key, too many requests) are on the MCP page.
Example
Example shape; values are illustrative.
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "get_check_summary",
"arguments": {
"order_id": "00000000-0000-4000-8000-000000000002"
}
}
}{
"status": "ok",
"order_id": "00000000-0000-4000-8000-000000000002",
"check": {
"check_id": "00000000-0000-4000-8000-000000000003",
"date": "2026-11-18"
},
"one_thing": {
"action": "…",
"effort": "An hour",
"evidence": "Seen in our data"
},
"what_moved": {
"since": "2026-10-18",
"lines": [
"Nothing moved beyond normal variation since 2026-10-18."
],
"more": 0
},
"change_tests": []
}