lb_list_nodes

Lists nodes with optional filters. Unlike lb_search (which requires a query string), this tool can page through all nodes for a PARA item, all nodes in a status, all nodes matching a tag set, or simply recent nodes.

Parameters

| Parameter | Type | Required | Description | |-----------|------|----------|-------------| | query | string | No | Optional text query. When omitted, returns filtered/paginated results without ranking | | para_item_id | string | No | Filter to nodes tagged with this PARA item | | para_category | string | No | Filter to nodes whose primary PARA item has this category (projects, areas, resources) | | status | "raw" | "validated" | No | Filter by node status | | tags | string[] | No | Filter to nodes containing all of these tags | | orphan | boolean | No | If true, only return nodes with no incoming or outgoing links | | page | number | No | 1-indexed page number. Default 1, minimum 1 | | per_page | number | No | Page size. Default 20, minimum 1, maximum 100 |

Response

{
  "data": [ /* NodeResponse[] */ ],
  "total": 0,
  "page": 1,
  "per_page": 20
}

Usage notes

• Use lb_search when you need ranking by relevance. Use lb_list_nodes for filter-only browsing.
• per_page max is 100 (vs 50 for lb_list_captures) because node rows are lighter — no body payload or blob references.
• Pagination is stable across pages as long as the filter predicates stay the same and no inserts/deletes occur mid-browse.