list_actions
What to do, with hand-offs.
The order page's actions for one check, in the page's order: the one thing, content kits, the labelled websites AI cited, and What to do. Each item has its id, label, phrases and the same Hand to your agent text the page copies. Without check_id: the latest scheduled check.
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: id, action, why, where, evidence, effort. |
kits | Content kits: id, kind, title, why, evidence, tag, phrases and hand_to_your_agent. |
sources | The labelled websites AI cited: id, site, pill, cited, phrases, line and hand_to_your_agent. |
what_to_do | The rest of the list, each with its hand_to_your_agent text. |
hand_to_your_agent | The same text the order page's Hand to your agent button copies. |
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. |
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": "list_actions",
"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": {
"id": "service_area",
"action": "…",
"why": "…",
"where": "…",
"evidence": "Seen in our data",
"effort": "An hour"
},
"kits": [],
"sources": [],
"what_to_do": [
{
"id": "service_area",
"action": "…",
"why": "…",
"where": "…",
"evidence": "Seen in our data",
"effort": "An hour",
"phrases": [
"emergency plumber boise"
],
"hand_to_your_agent": "…"
}
],
"note": "…"
}