Scout Tools

Scout exposes three tools over MCP stdio. find is the front door; the other two are operational.

Use the exact tool names in agent prompts when you want the MCP client to search the workspace or check index health.

Search

find
Primary search over the workspace: strict modes (literal, regex, word) are exhaustive with deterministic order; fuzzy is ranked top-N with frecency. target: auto routes by query shape and every response echoes the resolved route.

Status and Index Lifecycle

server_status
Reports index, watcher, and tier health; detected sibling compiler servers (Glider and TGlider); store size; and license and telemetry state.
sync
Flushes pending watcher changes into the index; full: true forces a complete re-scan. Rarely needed because every query self-flushes.

Notes

  • A zero-hit strict search returns an honest empty result; Scout suggests a fuzzy retry in hints but never silently falls back.
  • structural runs syntax-aware ast-grep patterns and symbols returns a declaration outline (name, kind, container); both answer natively for the nine linked grammars and degrade to a lexical search elsewhere, saying so in meta.degradedCompatibility lists the languages and the symbol kinds each one produces; semantic fuses embedding search with a lexical ranking over the same chunks. route.tier says hybrid when both legs shaped the answer and semantic when only the embeddings did. Its score orders one result set and is not a similarity. The tier is on by default — Scout downloads and verifies the embedding model once per user on its first start, degrading to a lexical fuzzy search with meta.degraded set until the tier is ready. Pass --no-semantic to turn it off.
  • Scout never mutates workspace source; its only writes are its own index state.
↑/↓ NavigateEnter OpenSpace Expand