Read whether a project's scan is still running or already idle.
aiseo_get_scan
Read whether a project's scan is still running or already idle.
Use this for scan state. Ranks live on aiseo_list_prompts. done means no in-flight jobs, not that every prompt has results.
After Instagram (or any) scan starts, prompts stay empty until the job finishes. Polling aiseo_list_prompts and guessing ranks is the wrong signal.
Use it when you need to:
no_data (no prompts yet) from a scan that is still running.There is no subscribe tool and no aiseo://scan resource. Call this tool again if state is running.
state as running or done.project:{slug}.lastCheckedAt set).lastCheckedAt for the newest scanned prompt.Kickoff results from adding prompts (started, not_entitled, failed) stay on aiseo_add_prompts. This tool is runtime state only.
| Name | Type | Required | Description |
|---|---|---|---|
projectSlug | string | Yes | From aiseo_list_projects |
{
"projectSlug": "acme"
}
{
"dataStatus": "ok",
"lastCheckedAt": "2026-08-26T12:04:00.000Z",
"project": {
"name": "Acme",
"slug": "acme"
},
"promptCount": 40,
"runningTaskCount": 0,
"scannedPromptCount": 40,
"state": "done",
"usage": "Scan jobs are idle. done means no in-flight jobs…"
}
| Field | Meaning |
|---|---|
state | running if tagged jobs are still in flight, else done |
runningTaskCount | Active Trigger.dev runs for project:{slug} |
promptCount | Active tracked prompts |
scannedPromptCount | Prompts with lastCheckedAt |
lastCheckedAt | Newest scan time, or null |
dataStatus | ok or no_data (no prompts yet) |
done is idle jobs. It does not mean every prompt has results. Compare scannedPromptCount to promptCount.
no_data is not a 401. Do not invent ranks. See Connect MCP.
Call
aiseo_get_scanfor this project. Ifstateisrunning, call it again later. Whendone, callaiseo_list_promptsandaiseo_list_sources. Do not invent ranks.