get_nodes
List nodes of a specific kind with optional attribute or relationship filters. Control pagination with offset and limit.
Instructions
List nodes of a specific kind — the default read path for typed queries with optional filtering and pagination.
Prefer this over query_graphql when you just need objects of one kind:
results come back as display labels (fast, token-cheap) or full attribute
dicts (include_attributes=True).
To discover available kinds, read the infrahub://schema resource.
If your client does not support MCP resources, call the get_schema tool instead.
To discover available filters for a kind, read infrahub://schema/{kind}
or call get_schema(kind='...').
Filter keys follow the schema's filter map. Attribute filters use
<attr>__value (e.g. {"name__value": "atl1"}) and relationship
filters chain via <rel>__<attr>__value (e.g.
{"site__name__value": "atl1"}). See infrahub://schema/{kind} for
the full list of valid keys.
Use offset and limit to page through large result sets. The response
always includes total_count and has_more so you know when to stop.
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| kind | Yes | Kind of the objects to retrieve. Check infrahub://schema for valid kinds. | |
| branch | No | Branch to query. Defaults to the default branch. | |
| filters | No | Attribute/relationship filters. Keys follow the schema's filter map (e.g. {"name__value": "atl1"} or {"site__name__value": "atl1"}). See infrahub://schema/{kind} for the full filter map. | |
| partial_match | No | Use partial (substring) matching for string filters. | |
| include_attributes | No | When True, return full attribute values in TOON tabular format instead of just display labels. More expensive — omit when you only need names/counts. | |
| limit | No | Maximum nodes to return. Default 50. Pass -1 for all results (caution: may be expensive). | |
| offset | No | Number of results to skip for pagination. Use with limit to page through results. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||