get_scan
Poll an ongoing website scan and retrieve structured results once complete, including findings, checks, and technology detections.
Instructions
Poll a scan and, once complete, return its structured results. Read-only. Returns { scan, findings, checkResults, techDetections, access, agentSummary }. scan.status moves through pending → running → retrying → done → failed; keep polling (every few seconds) until done or failed. On failed, a failure object explains the cause and next_action. access.level is none | teaser | full: teaser findings are diagnostic only (evidence, check keys, and fix text are redacted). To get full data, pass a report token via the token argument. If access.campaign is present the report is FREE right now — call unlock_report with an email to obtain that token instead of sending the user to checkout.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"scanId": "<scanId>"
},
"name": "get_scan"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| token | No | Optional report token (from unlock_report or a paid unlock) that upgrades a teaser response to full findings. | |
| scanId | Yes | The scan ID returned by start_scan. |