search_plants
Filter the plant catalog by botanical attributes like soil, sunlight, height, bloom period, and hardiness, then return lean plant records. Use get_plant_attributes to find valid filter values.
Instructions
Filter the plant catalog by botanical attributes. Returns lean records ({productId, code, botanicalName, commonName}). Call get_plant_attributes first to discover valid filter values for the current locale. Multi-value filters use OR semantics (any value matches); different filters are AND-combined. Range filters use overlap semantics (a plant's range must intersect the requested range). Capped at limit (default 25, max 100); response includes total + truncated flag. Use get_plant_info for full per-plant details after picking a candidate. Falls back to a loud error if the index is unavailable on the CDN — agents should retry name-based queries via search_products in that case.
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_plants"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| soil | No | OR-match against the plant's soil array. Use values from get_plant_attributes.soil. | |
| limit | No | Max matches returned (default 25, clamped to [1, 100]). The total count of all matches is always returned, so you can detect truncation. | |
| query | No | Optional substring match (case-insensitive) on botanicalName OR commonName. No diacritic stripping — pass terms as they appear in the locale (e.g. 'Jeżówka', not 'jezowka'). Exact matches are ranked first. | |
| height | No | Overlap match: the plant's height range must intersect [min, max] (inclusive). Values are in METERS regardless of set_units (this is plant size, not editor coordinates). | |
| spread | No | Overlap match in METERS, same semantics as height. | |
| sunlight | No | OR-match against the plant's sunlight array. Use values from get_plant_attributes.sunlight. | |
| hardiness | No | Overlap match against the plant's USDA hardiness zone range. | |
| bloomPeriod | No | OR-match against the plant's bloomPeriod array. Roman months I–XII; use get_plant_attributes.bloomPeriod. | |
| flowerColor | No | OR-match against the plant's flowerColor array. Use values from get_plant_attributes.flowerColor. | |
| foliageType | No | Exact match against the plant's foliageType. Use a value from get_plant_attributes.foliageType. | |
| divisionNeeded | No | Exact match. | |
| pruningTolerant | No | Exact match. | |
| maintenanceLevel | No | OR-match against the plant's maintenanceLevel. Use values from get_plant_attributes.maintenanceLevel. | |
| hasOrnamentalBark | No | Exact match. | |
| hasOrnamentalFruit | No | Exact match. |