List Assets
netbox_list_assetsBrowse or search hardware inventory assets in NetBox with pagination and filters for name, serial, status, kind, and more.
Instructions
List hardware inventory assets (netbox-inventory plugin) from NetBox.
Supports pagination and filtering. Common patterns:
Discovery: call with no filters to browse the first assets.
Lookup by id: use netbox_get_asset instead when you already have an id.
Narrow scan: combine 'q' (fuzzy text) with resource-specific filters below.
Pagination:
'limit' (max 1000, default 50) and 'offset'. Response includes 'has_more' and 'next_offset'.
Large list responses auto-truncate to keep under the character limit; keep calling with next_offset to continue.
Resource-specific filters:
name: Exact asset name.
name__ic: Asset name contains (case-insensitive).
serial: Exact serial number.
asset_tag: Exact asset tag.
status: Asset lifecycle status. Defaults in netbox-inventory are 'stored', 'used', 'retired' (your instance may define custom statuses).
kind: Hardware kind: 'device', 'module', 'inventoryitem', or 'rack'.
manufacturer_id: Filter by manufacturer id.
tenant_id: Filter by using-tenant id.
owning_tenant_id: Filter by owning-tenant (owner) id.
role_id: Filter by asset role id.
supplier_id: Filter by supplier id.
purchase_id: Filter by purchase id.
delivery_id: Filter by delivery id.
storage_location_id: Filter by storage location (dcim location) id.
inventoryitem_group_id: Filter by inventory item group id.
inventoryitem_type_id: Filter by inventory item type id.
device_id: Asset assigned to this device id.
module_id: Asset assigned to this module id.
rack_id: Asset assigned to this rack id.
Universal filters:
q (string) Fuzzy text search across searchable fields.
tag (string[]) AND-filter by tag slugs.
created_after (date) ISO-8601 lower bound on 'created'.
created_before (date) ISO-8601 upper bound on 'created'.
Returns: Markdown summary (default) or JSON with shape: { total, count, offset, limit, items: [...], has_more, next_offset? }
Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Fuzzy full-text search across the object's searchable fields (name, description, etc.). | |
| tag | No | Filter to objects that have ALL of these tag slugs. Repeat for multiple tags (AND semantics in NetBox). | |
| kind | No | Hardware kind: 'device', 'module', 'inventoryitem', or 'rack'. | |
| name | No | Exact asset name. | |
| limit | No | Maximum number of items to return per page (1-1000, default 50). | |
| offset | No | Number of items to skip for pagination. Use next_offset from a previous response. | |
| serial | No | Exact serial number. | |
| status | No | Asset lifecycle status. Defaults in netbox-inventory are 'stored', 'used', 'retired' (your instance may define custom statuses). | |
| rack_id | No | Asset assigned to this rack id. | |
| role_id | No | Filter by asset role id. | |
| name__ic | No | Asset name contains (case-insensitive). | |
| asset_tag | No | Exact asset tag. | |
| device_id | No | Asset assigned to this device id. | |
| module_id | No | Asset assigned to this module id. | |
| tenant_id | No | Filter by using-tenant id. | |
| delivery_id | No | Filter by delivery id. | |
| purchase_id | No | Filter by purchase id. | |
| supplier_id | No | Filter by supplier id. | |
| created_after | No | ISO-8601 date; only return objects created on or after this date (e.g. 2024-01-01). | |
| created_before | No | ISO-8601 date; only return objects created on or before this date. | |
| manufacturer_id | No | Filter by manufacturer id. | |
| response_format | No | Output format: 'markdown' (default, human-readable) or 'json' (full structured payload). Use 'json' when chaining follow-up tool calls. | markdown |
| owning_tenant_id | No | Filter by owning-tenant (owner) id. | |
| storage_location_id | No | Filter by storage location (dcim location) id. | |
| inventoryitem_type_id | No | Filter by inventory item type id. | |
| inventoryitem_group_id | No | Filter by inventory item group id. |