server_status

[debug]

Reports the active root, index state, watcher health, search tiers, and detected sibling tools.

Parameters

Examples

Replace sample paths and symbol keys with values from your workspace.

Check Scout readiness and sibling detection

{}

{
  "jsonrpc": "2.0",
  "id": 1,
  "method": "tools/call",
  "params": {
    "name": "server_status",
    "arguments": {}
  }
}

Response Notes

Status requests count as client activity for --idle-timeout-secs. This optional process timeout defaults to 0 (disabled), survives load/unload, and never expires during an active request. Semantic eviction uses its own 30-minute default and counts only semantic queries. Parent exit also stops Scout. Restart Scout after process shutdown.

Returns workspace root, indexed file count, index revision, watcher state, and per-tier availability. It also returns detected siblings, store size, worker allowance, membership scope rules, and license and telemetry state. indexRevision counts applied changes, not files, so it is 0 on a workspace nothing has edited since startup - indexedFiles is what tells you the index is populated. membership explains the scope behind indexedFiles: the hidden-file policy and the number of configured ignore globs. It also reports whether scout folds case when it matches gitignore rules, and where that answer came from. workers.reservedForInteractive is how many workers a query is guaranteed while the embedding build runs. On a host with one or two workers that reserve cannot be held, and a query there falls back to running single-threaded.

Unreleased multi-root support: roots lists stable root IDs, effective settings, semantic source, ownership exclusions, and per-root health. Semantic sources are runtime, startup, root-config, and default. policy describes process settings. With several roots, the first startup root supplies configuration for that policy. Worker allocation limits Scout-managed work. Search and embedding backends can use additional threads.