inventory__list_hosts
Read-only
Retrieve a paginated list of hosts from inventory with filtering by name, tags, staleness, provider, and more, and sort results by display name, update, or creation time.
Instructions
List hosts with filtering and sorting options. CRITICAL: For the 'per_page' parameter, you MUST use a value of 10 on the first call to avoid performance degradation and context overflow. Only use a larger value if the user explicitly requests to see more systems at once.
Input Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| fqdn | No | Filter by FQDN (case-insensitive). | |
| page | No | Page number to return. | |
| tags | No | Filter by tags (e.g., 'ns1/key1=val1,ns2/key2=val2'). | |
| order_by | No | Field to sort by ('display_name', 'updated', 'created'). | |
| per_page | No | Number of hosts to return per page **ALWAYS use the default value of 10 for the first call.** This default is carefully chosen for performance and context management. Only increase this value if the user explicitly asks to see more systems at once | |
| order_how | No | Sort direction ('ASC' or 'DESC'). | ASC |
| staleness | No | Filter by staleness status (one of 'fresh', 'stale', 'stale_warning', 'unknown'). | |
| updated_end | No | Filter hosts updated before this timestamp (RFC3339). | |
| display_name | No | Filter by display name (case-insensitive). | |
| provider_type | No | Filter by provider type (e.g., 'aws', 'azure', 'gcp'). | |
| updated_start | No | Filter hosts updated after this timestamp (RFC3339). | |
| hostname_or_id | No | Filter by display_name, fqdn, or id (case-insensitive). | |
| registered_with | No | Filter by reporter that registered the host. |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |