Search

search

Multi-mode search across entity names, doc comments, and graph nodes.

Absorbs: find_entity (via mode=“exact”).

Parameter	Type	Required	Description
`query`	string	Yes	Search term (case-insensitive).
`mode`	string	No	`keyword` (default): substring match. `fulltext`: FTS5 BM25 ranking. `semantic`: HyDE vector search. `exact`: name lookup returning node refs (ID, type, file, line).
`limit`	number	No	Maximum results (default 20, max 50). Used for fulltext/semantic.
`hyde`	boolean	No	HyDE hypothesis generation (default true). Only applies when mode=`semantic`.
`format`	string	No	Output format for mode=`exact`: `compact` (default) or `json`.

Substring match across entity names.

{
  "tool": "search",
  "arguments": {
    "query": "AuthService"
  }
}

FTS5 BM25-ranked search across names and documentation.

{
  "tool": "search",
  "arguments": {
    "query": "authentication handler",
    "mode": "fulltext",
    "limit": 10
  }
}

Vector similarity search with optional HyDE hypothesis generation.

{
  "tool": "search",
  "arguments": {
    "query": "function that validates JWT tokens",
    "mode": "semantic",
    "limit": 5
  }
}

Name lookup returning node references. Use to resolve entity names before calling get_context.

{
  "tool": "search",
  "arguments": {
    "query": "CarveEgoGraph",
    "mode": "exact"
  }
}