Status and result tools

MCP action tools that create persisted runs return a run_id.

Use status tools to poll work and fetch results.

Status Tools

Tool	Use it for
get_sleepwalker_visibility_run_status	Poll direct AI Visibility runs.
list_sleepwalker_visibility_runs	List direct AI Visibility runs.
get_sleepwalker_content_run_status	Poll direct Content Intelligence runs.
list_sleepwalker_content_runs	List direct Content Intelligence runs.
get_sleepwalker_run_result	Fetch saved Console run details.
get_sleepwalker_prompt_response	Fetch one AI Visibility prompt response chunk.

Required scope:

runs:read

Polling Pattern

create run
  -> store run_id
  -> poll status every 10 to 30 seconds
  -> stop when terminal
  -> fetch heavier result detail only if needed

Common Statuses

Status	Meaning
queued	Accepted and waiting to start.
running	Work has started.
completed	Work finished and result data is available.
failed	Work could not complete.
cancelled	Work was not run or was stopped.
partially_queued	Some requested probes were queued and some were skipped.

See Enums for shared status values.

Include Flags

Status tools return compact data by default.

Tool	Flag	Use when
get_sleepwalker_visibility_run_status	include_probes	You need per-probe status rows.
get_sleepwalker_visibility_run_status	include_results	You need available probe result data.
get_sleepwalker_content_run_status	include_result	You need the full Content Intelligence result.

Use include flags deliberately. Large payloads are harder for MCP clients to handle.

Prompt Response Drilldown

For AI Visibility runs, fetch individual prompt responses with:

get_sleepwalker_prompt_response

Inputs:

Input	Type	Notes
run_id	string	Required run ID.
result_index	integer	Fetch by flattened result index.
platform	string	Fetch by platform.
prompt_index	integer	Fetch by prompt position.
max_chars	integer	1 to 25,000.
offset	integer	Continue long text from an offset.

Example Prompts

Poll this Sleepwalker run until it completes, then summarize the result.

Fetch the first prompt response with citations for this visibility run.