Skip to content

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

NameTypeRequiredValues and limits
order_idstringYes
check_idstringNo

What it answers

Every answer has status and, where useful, message in plain words.

FieldMeaning
checkThe check read: check_id and date.
one_thingThe one thing to change, with its effort and evidence label.
what_movedsince (the check compared with), lines (each move beyond normal variation, with its counts; one line when nothing moved) and more.
change_testsEmpty until change tests exist.

Errors

statusWhat it means
invalid_inputorder_id isn't an order id. Take one from get_dashboard.
not_foundNo order with that id on this account.
not_availableThat check isn't a scheduled one; read it with get_matrix.
forbiddenThe 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 errorAn 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.

The call
{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "get_check_summary",
    "arguments": {
      "order_id": "00000000-0000-4000-8000-000000000002"
    }
  }
}
The answer (structured content)
{
  "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": []
}