Skip to content

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

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: id, action, why, where, evidence, effort.
kitsContent kits: id, kind, title, why, evidence, tag, phrases and hand_to_your_agent.
sourcesThe labelled websites AI cited: id, site, pill, cited, phrases, line and hand_to_your_agent.
what_to_doThe rest of the list, each with its hand_to_your_agent text.
hand_to_your_agentThe same text the order page's Hand to your agent button copies.

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.
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": "list_actions",
    "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": {
    "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": "…"
}