search_inventory
Find matching workloads in a Cisco Secure Workload cluster inventory by filtering on IP, hostname, OS, or annotations; returns counts and matching records.
Instructions
Search cluster inventory for workloads matching a field/value filter.
Args: value: The value to match (e.g. an IP, hostname fragment, OS string). field: The inventory dimension to filter on (default "ip"). Common fields: "ip", "hostname", "os", "user_annotations". match: CSW filter operator — "eq" (exact), "contains", "subnet", etc. Defaults to "eq". limit: Max results to return (1–1000).
Runs a read-only POST /openapi/v1/inventory/search. Returns a count and
the matching inventory records.
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": {
"value": "<value>"
},
"name": "search_inventory"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| field | No | ip | |
| limit | No | ||
| match | No | eq | |
| value | Yes |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| result | Yes |