Search inventory
search_inventoryKeyword search of published, in-stock surplus listings. No sign-in required. query matches the name, description, brand, SKU, and category words, in any order. If the whole query is a category (electronics, clothes, home goods), it is treated as that category filter. Pass category as a catalogue category, such as electronics or home_goods, when you want to limit results. max_price is the maximum unit price in cents. condition is salvage, customer_returns, shelf_pulls, overstock, or new_or_refurbished. Name, brand, and SKU matches rank above description matches. For a sentence about what you want, use search_inventory_semantic.
Tool call template
This tool declares no required parameters. Add optional parameters from the input schema as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {},
"name": "search_inventory"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| q | No | Alias for query. | |
| limit | No | Maximum listings to return (default 20, max 100). | |
| query | No | Words to match, or a category name such as electronics or clothes. Not a sentence — use search_inventory_semantic for that. `q` is accepted as an alias. | |
| category | No | Limit to one catalogue category. One of: electronics, apparel, home_goods, beauty, sports, kitchenware, office_supplies, toys, food_beverage, tools, other. Prose such as "Electronics" or "clothes" is accepted and mapped to the stored value. | |
| condition | No | Condition of the goods: salvage (sold as-is), customer returns, shelf pulls, overstock, or new or refurbished. | |
| max_price | No | Maximum unit price in cents. 5000 means $50.00. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| total | Yes | Catalogue matches before the limit is applied. | |
| message | Yes | ||
| products | Yes |