get_nodes
Get a paginated list of nodes/routers from a graph.
Description: Returns structured node data including hostname, system ID, network count, areas, IS-IS flag, and node_attributes (role flags). Supports pre-filtering by protocol, watcher origin, area, and node role flag before returning results. Note: 'network count' is the number of prefixes/networks on a node, NOT its neighbor/adjacency count. To count neighbors per router, use get_edges and count edges per src_node; do not derive neighbor counts from this tool. protocol="bgp" answers "which leaves carry VNI/VRF X" (vni/vrf/rt) and "which routers are BGP speakers" -- rows then carry can_build_path instead of the IGP node fields above.
Input fields: graph_time (str): The graph time identifier, or the name of your OSPF/IS-IS watcher (Enterprise) to read its newest snapshot with events up to now; the answer then names that snapshot in graph_time protocol (str, optional): Filter: only return if graph matches protocol (ospf, ospfv3, isis, yaml, bgp) watcher (bool, optional): Filter: true for watcher-uploaded graphs, false for manually parsed area (str, optional): Filter: only return if graph contains this area (e.g. "0", "0.0.0.1", "49.0001") abr (bool, optional): OSPF role filter — true returns only Area Border Routers (false: only non-ABRs) asbr (bool, optional): OSPF role filter — true returns only AS Boundary Routers (false: only non-ASBRs) overload (bool, optional): IS-IS filter — true returns only routers with the overload (OL) bit set attached (bool, optional): IS-IS filter — true returns only routers with the attached (ATT) bit set maxmetric (bool, optional): OSPF filter — true returns only routers in max-metric (RFC 3137 stub router) state vni (int, optional): protocol="bgp" only -- keep the routers that are a VTEP for this L2VNI vrf (str, optional): protocol="bgp" only -- keep the routers that are a VTEP for this VRF's L3VNI rt (str, optional): protocol="bgp" only -- keep the routers whose resolved RIB view carries this route target page (int): Page number, 1-indexed (default: 1) per_page (int): Items per page (default: 50) at (str, optional): ISO 8601 moment; state with watcher events applied up to it
Output fields: dict with keys: items: list of nodes with node_id (canonical graph name), display_name (human-readable text), hostname, systemid, networks_count, areas, is_isis, node_attributes (role flags: {"abr":1,"asbr":0,"maxmetric":0} for OSPF, {"overload":1,"attached":0} for IS-IS) pagination: page, per_page, total, total_pages
Equivalent to GET /graph/{graph_time}/nodes.
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": {
"graph_time": "<graph_time>"
},
"name": "get_nodes"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| at | No | ||
| rt | No | ||
| abr | No | ||
| vni | No | ||
| vrf | No | ||
| area | No | ||
| asbr | No | ||
| page | No | ||
| watcher | No | ||
| attached | No | ||
| overload | No | ||
| per_page | No | ||
| protocol | No | ||
| maxmetric | No | ||
| graph_time | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||