discover_topics
List topics in your notebook before editing, with optional search by query or tag to find relevant notes quickly.
Instructions
List available topics. Call this before read/write/edit/delete/append/rename/sweep.
Returns a JSON list of {id, title, tags, updated, size, snippet, outbound_links, expires, match_reason}, newest first. With a query, snippets are centered on the first body match. Expired topics are hidden by default; pass include_expired=true to reveal them, marked with "expired": true. Reports when results are truncated by limit or when expired topics were hidden.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "discover_topics"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| tag | No | Optional exact tag match | |
| limit | No | Maximum topics to return | |
| query | No | Optional case-insensitive AND search across id, title, tags, and body. Quoted "exact phrase" matches as a single term. | |
| include_expired | No | Include topics whose expiry has passed |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |