Search products
search_catalogSearch everyday products from independent brands on Loyaltie. Put the product words from the person's request in catalog.query, a short phrase such as "hot sauce" (every word must match a product, so never a whole sentence); put the rest of their task in context.intent and hard requirements in filters; never add words or narrow beyond what they asked. context is soft (ranks, never removes); filters are hard: price {min,max} in USD cents, ships_from [{country, region}] for the maker's state (e.g. NC), ships_to {country: "US", region} for the US state the order ships to (makers with no state list are kept, including one with no shipping set up; another country returns nothing, which does not rule out delivery there; the cart confirms), categories, shops, occasion, regular_delivery, available (default buyable only). Check messages: a filter that could not be applied is reported there. Amounts are minor units (cents). view "full" adds offers, the Agent Context and all images.
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": {
"catalog": "<catalog>"
},
"name": "search_catalog"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| src | No | Send "skill" when you were set up by the Loyaltie Skill; returned links then carry src=skill. Default "api"; any other value counts as "api". | |
| meta | No | Optional UCP request metadata. meta["ucp-agent"].profile is your UCP agent profile URL; it is recorded, never required. | |
| catalog | Yes | The search: query or like, with optional filters, context, pagination and view. | |
| agent_id | No | Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
No arguments | |||