Search inventory items in a specific property. Filter by text query, category, or room.
| Parameter | Type | Required | Description |
|---|---|---|---|
property_id | string | Yes | UUID of the property to search in |
query | string | No | Text to match against name, brand, model, or notes |
category | string | No | Filter by category ID |
room | string | No | Filter by room ID |
limit | number | No | Maximum results (1-100, default: 50) |
{
"jsonrpc": "2.0",
"id": 1,
"method": "tools/call",
"params": {
"name": "search_items",
"arguments": {
"property_id": "550e8400-e29b-41d4-a716-446655440000",
"query": "lamp"
}
}
}
{
"jsonrpc": "2.0",
"id": 2,
"method": "tools/call",
"params": {
"name": "search_items",
"arguments": {
"property_id": "550e8400-e29b-41d4-a716-446655440000",
"query": "Samsung",
"room": "living-room-uuid",
"limit": 10
}
}
}
{
"jsonrpc": "2.0",
"id": 3,
"method": "tools/call",
"params": {
"name": "search_items",
"arguments": {
"property_id": "550e8400-e29b-41d4-a716-446655440000"
}
}
}
{
"jsonrpc": "2.0",
"id": 1,
"result": {
"content": [
{
"type": "text",
"text": "{\"items\":[{\"id\":\"item-uuid-1\",\"name\":\"Desk Lamp\",\"category\":null,\"room\":\"Office\",\"photo_url\":\"https://storage.example.com/photos/lamp.jpg\",\"purchase_date\":\"2023-01-15\",\"value\":\"49.99\"},{\"id\":\"item-uuid-2\",\"name\":\"Floor Lamp\",\"category\":null,\"room\":\"Living Room\",\"photo_url\":null,\"purchase_date\":null,\"value\":\"129.00\"}],\"count\":2,\"property_id\":\"550e8400-e29b-41d4-a716-446655440000\"}"
}
]
}
}
{
"items": [
{
"id": "item-uuid-1",
"name": "Desk Lamp",
"category": null,
"room": "Office",
"photo_url": "https://storage.example.com/photos/lamp.jpg",
"purchase_date": "2023-01-15",
"value": "49.99"
},
{
"id": "item-uuid-2",
"name": "Floor Lamp",
"category": null,
"room": "Living Room",
"photo_url": null,
"purchase_date": null,
"value": "129.00"
}
],
"count": 2,
"property_id": "550e8400-e29b-41d4-a716-446655440000"
}
| Field | Type | Description |
|---|---|---|
items | array | Array of matching items |
items[].id | string | UUID of the item |
items[].name | string | Item name |
items[].category | string | null | Category name (if assigned) |
items[].room | string | null | Room name where item is located |
items[].photo_url | string | null | URL to item photo |
items[].purchase_date | string | null | Date of purchase (ISO format) |
items[].value | string | null | Item value/price |
count | number | Total number of items returned |
property_id | string | The property that was searched |
The query parameter performs case-insensitive matching across:
Results are sorted by creation date (newest first) and exclude archived items.
{
"content": [
{
"type": "text",
"text": "{\"error\": \"Invalid property ID\"}"
}
],
"isError": true
}
{
"content": [
{
"type": "text",
"text": "{\"error\": \"Property not found or access denied\"}"
}
],
"isError": true
}
{
"content": [
{
"type": "text",
"text": "{\"error\": \"Failed to search items\"}"
}
],
"isError": true
}