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. For a finish event, subscribe to aiseo://scan/{projectSlug} (see Connect MCP).

Why you need it

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:

• Wait for an in-flight scan without inventing data.
• Confirm a project is idle before writing a citation mix.
• Distinguish no_data (no prompts yet) from a scan that is still running.

Capabilities

• Report state as running or done.
• Count in-flight Trigger jobs tagged project:{slug}.
• Count tracked vs scanned prompts (lastCheckedAt set).
• Return 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.

Parameters

Input

{
  "projectSlug": "acme"
}

Output

{
  "dataStatus": "ok",
  "lastCheckedAt": "2026-08-26T12:04:00.000Z",
  "project": {
    "name": "Acme",
    "slug": "acme"
  },
  "promptCount": 40,
  "runningTaskCount": 0,
  "scannedPromptCount": 40,
  "state": "done",
  "usage": "Scan is idle. Call `aiseo_list_prompts`…"
}

no_data is not a 401. Do not invent ranks. See Connect MCP.

Example prompt

Call aiseo_get_scan for this project. If state is running, wait for the scan-complete notification. When done, call aiseo_list_prompts and aiseo_list_sources. Do not invent ranks.

Next

• aiseo_list_prompts after the scan is done
• aiseo_list_sources for citation mix
• Connect MCP for resources/subscribe