Search the tool catalogue
discover_tool_searchSearch the Nexus tool catalogue by keyword to find matching tools before calling them. Ranks name and description matches so you can locate the right smart-home tool quickly.
Instructions
Fuzzy search the Nexus tool catalogue by name and description.
Scores every mounted tool's name + description against query with a
BM25-lite ranking (term frequency/inverse document frequency plus a
small boost when a query word appears in the tool name itself) and
returns the top top_k matches.
Use when: finding the right tool name before calling it, instead of
keeping the whole tool surface in working memory.
Not for: a single tool's full documentation once you have its name —
use discover_get_tool_doc.
Returns: list of {"name", "namespace", "summary", "score", "access"}
dicts, highest score first; empty list if nothing scores above zero.
access is "read", "write" or "destructive" (ADR-0002/0003
annotation class).
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| query | Yes | Free-text search query, e.g. 'turn on light' or 'backup'. | |
| top_k | No | Maximum number of ranked hits to return, e.g. 10. | |
| namespace | No | Restrict results to one namespace, e.g. 'card_builder'. Omit to search every namespace. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |