inventory__list_hosts
Read-only
Retrieve a filtered, paginated list of hosts. Apply filters by hostname, tags, staleness, or provider. 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 |
|---|---|---|---|
| hostname_or_id | No | Filter by display_name, fqdn, or id (case-insensitive). | |
| display_name | No | Filter by display name (case-insensitive). | |
| fqdn | No | Filter by FQDN (case-insensitive). | |
| tags | No | Filter by tags (e.g., 'ns1/key1=val1,ns2/key2=val2'). | |
| staleness | No | Filter by staleness status (one of 'fresh', 'stale', 'stale_warning', 'unknown'). | |
| registered_with | No | Filter by reporter that registered the host. | |
| provider_type | No | Filter by provider type (e.g., 'aws', 'azure', 'gcp'). | |
| updated_start | No | Filter hosts updated after this timestamp (RFC3339). | |
| updated_end | No | Filter hosts updated before this timestamp (RFC3339). | |
| 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 | |
| page | No | Page number to return. | |
| order_by | No | Field to sort by ('display_name', 'updated', 'created'). | |
| order_how | No | Sort direction ('ASC' or 'DESC'). | ASC |
Output Schema
TableJSON Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |