search_nodes_by_label
List all nodes with a specific label, returning their IDs and properties. Supports pagination with limit and offset for browsing results.
Instructions
Find nodes that have a specific label.
Returns node IDs and their properties, paginated by limit/offset.
Use this tool when: you want to list or browse nodes of a certain type (e.g. all Person nodes, all Company nodes). Do NOT use this for: getting a single node by ID (use get_node), or complex filtered queries (use execute_gql).
Args: label: The label to filter by (e.g. "Person", "Company"). limit: Maximum number of results to return (default 100). offset: Number of results to skip for pagination (default 0).
Returns: JSON with a list of {node_id, properties} objects, total count, and a truncation note if applicable.
Examples: search_nodes_by_label("Person") search_nodes_by_label("Company", limit=10) search_nodes_by_label("Person", limit=50, offset=50) # page 2
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"label": "<label>"
},
"name": "search_nodes_by_label"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| label | Yes | ||
| limit | No | ||
| offset | No |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |