Title87/100
Not provided
The title clearly communicates the tool’s action and subject. Keep it concise.
Description78/100
Search products from small independent makers 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.
The description explains the capability, when to use it, and what to expect.
Inputs57/100
22 of 35 inputs have descriptions. Add descriptions to the missing inputs, including where to obtain IDs and how to supply values.
catalog › query
The product the person asked for, in their own words, 1 to 500 characters (e.g. "hot sauce"). Every word except a, an, the, for and the like must appear in a product's title, one-liner, category, maker city and state, or maker store link, and only the first 8 words count, so leave out filler such as "for my dad who loves". The maker's name is not searched: put a maker in filters.shops. Add no preferences; put hard requirements in filters and the person's task in context.intent.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
catalog › like
Not offered yet; send query.
Explain the meaning of this value, not just its name.
catalog › context › address_country
ISO 3166-1 alpha-2, e.g. US.
Clear enough to supply this argument.
catalog › context › address_region
State, e.g. NC. Makers in this state rank higher.
Clear enough to supply this argument.
catalog › context › postal_code
Not provided
Missing description. Explain what this value means and how to supply it.
catalog › context › currency
ISO 4217. Prices are not converted; a currency other than USD is reported in messages.
Clear enough to supply this argument.
catalog › context › language
BCP 47. Accepted, no effect. Our messages are English; maker text is shown as written.
Clear enough to supply this argument.
catalog › context › intent
Tell us the person's task in a few words; it improves results and is never shared. Its words rank results, e.g. "gift under $50"; it never removes a product.
Clear enough to supply this argument.
catalog › filters › price › min
Not provided
Missing description. Explain what this value means and how to supply it.
catalog › filters › price › max
Not provided
Missing description. Explain what this value means and how to supply it.
catalog › filters › available
true/omitted: buyable only; false: also unavailable.
Clear enough to supply this argument.
catalog › filters › ships_from › anyOf › 0 › items › country
Default US.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
catalog › filters › ships_from › anyOf › 0 › items › region
The maker's state: USPS code (NC) or name.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
catalog › filters › ships_from › anyOf › 1 › country
Default US.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
catalog › filters › ships_from › anyOf › 1 › region
The maker's state: USPS code (NC) or name.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
catalog › filters › ships_to › country
Not provided
Missing description. Explain what this value means and how to supply it.
catalog › filters › ships_to › region
Not provided
Missing description. Explain what this value means and how to supply it.
catalog › filters › ships_to › postal_code
Not provided
Missing description. Explain what this value means and how to supply it.
catalog › filters › categories
OR. Category path slugs, e.g. drink/coffee; a path matches its subcategories.
Clear enough to supply this argument.
catalog › filters › shops
OR. Maker ids (seller.id), store links (metadata.maker.link, e.g. mountain-mule; not the seller.url) or seller.domain (matches every maker). A value that names no listed maker adds nothing; if no value matches, nothing is returned.
Clear enough to supply this argument.
catalog › filters › regular_delivery
true: only products with a regular-delivery plan of their own or in a bundle on one.
Clear enough to supply this argument.
catalog › filters › occasion
Not provided
Missing description. Explain what this value means and how to supply it.
catalog › filters › attributes
Not provided
Missing description. Explain what this value means and how to supply it.
catalog › filters › condition
Every product is new.
Remove validation rules already expressed in this field’s schema; describe its meaning and usage instead.
catalog › filters › price_tier
Not provided
Missing description. Explain what this value means and how to supply it.
catalog › filters › rating
Not provided
Missing description. Explain what this value means and how to supply it.
catalog › pagination › cursor
Pass unchanged with the same query, filters and context.
Clear enough to supply this argument.
catalog › pagination › limit
Not provided
Missing description. Explain what this value means and how to supply it.
catalog › view
"full" adds offers, the Agent Context, all images and the cart link template.
Clear enough to supply this argument.
catalog › catalog_id
Not provided
Missing description. Explain what this value means and how to supply it.
catalog › signals
UCP signals. Accepted and ignored.
Clear enough to supply this argument.
catalog › attribution
UCP attribution: URL-style campaign and click parameters, string values. Recorded for reporting; never changes the response.
Clear enough to supply this argument.
meta › ucp-agent › profile
Not provided
Missing description. Explain what this value means and how to supply it.
agent_id
Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped.
Clear enough to supply this argument.
src
Send "skill" when you were set up by the Loyaltie Skill; returned links then carry src=skill. Default "api".
Clear enough to supply this argument.
Annotations100/100
All four behavior hints are declared.
{
"readOnlyHint": true,
"openWorldHint": false,
"idempotentHint": true,
"destructiveHint": false
}Output schema81/100
The output schema explains the structured result.
View output schema
{
"type": "object",
"anyOf": [
{
"type": "object",
"required": [
"ucp",
"products",
"pagination",
"messages",
"next"
],
"properties": {
"ucp": {
"type": "object",
"required": [
"version"
],
"properties": {
"status": {
"const": "success"
},
"version": {
"const": "2026-04-08"
}
},
"additionalProperties": false
},
"next": {
"type": "array",
"items": {
"type": "string",
"maxLength": 400,
"minLength": 1
},
"maxItems": 4,
"minItems": 1
},
"messages": {
"type": "array",
"items": {
"$ref": "#/definitions/message"
}
},
"products": {
"type": "array",
"items": {
"$ref": "#/definitions/product"
}
},
"pagination": {
"type": "object",
"anyOf": [
{
"properties": {
"has_next_page": {
"const": false
}
}
},
{
"required": [
"cursor"
]
}
],
"required": [
"has_next_page",
"total_count"
],
"properties": {
"cursor": {
"type": "string",
"minLength": 1
},
"total_count": {
"type": "integer",
"minimum": 0
},
"has_next_page": {
"type": "boolean"
}
},
"additionalProperties": false
}
},
"additionalProperties": false
},
{
"$ref": "#/definitions/error_document"
}
],
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"ucp",
"messages",
"next"
],
"definitions": {
"media": {
"type": "object",
"required": [
"type",
"url",
"alt_text"
],
"properties": {
"url": {
"type": "string",
"pattern": "^https://"
},
"type": {
"const": "image"
},
"alt_text": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"money": {
"type": "object",
"required": [
"amount",
"currency"
],
"properties": {
"amount": {
"type": "integer",
"minimum": 0
},
"currency": {
"type": "string",
"pattern": "^[A-Z]{3}$"
}
},
"additionalProperties": false
},
"offer": {
"type": "object",
"required": [
"type",
"label",
"terms"
],
"properties": {
"type": {
"enum": [
"plan",
"loyaltie_plus",
"member_offer"
]
},
"label": {
"type": "string"
},
"price": {
"$ref": "#/definitions/money"
},
"terms": {
"type": "string"
}
},
"additionalProperties": false
},
"rating": {
"type": "object",
"required": [
"value",
"scale_min",
"scale_max",
"count"
],
"properties": {
"count": {
"type": "integer",
"minimum": 1
},
"value": {
"type": "number",
"maximum": 5,
"minimum": 0
},
"scale_max": {
"const": 5
},
"scale_min": {
"const": 1
}
},
"additionalProperties": false
},
"seller": {
"type": "object",
"required": [
"id",
"name",
"url",
"domain"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"url": {
"type": "string",
"pattern": "^https://[^?#]+\\?(.*&)?src=(api|skill|ucp)(&.*)?$"
},
"name": {
"type": "string",
"minLength": 1
},
"domain": {
"type": "string",
"pattern": "^[a-z0-9.-]+$"
}
},
"additionalProperties": false
},
"message": {
"type": "object",
"anyOf": [
{
"not": {
"required": [
"presentation"
]
},
"required": [
"severity"
],
"properties": {
"type": {
"const": "error"
}
}
},
{
"not": {
"required": [
"severity"
]
},
"properties": {
"type": {
"const": "warning"
}
}
},
{
"allOf": [
{
"not": {
"required": [
"severity"
]
}
},
{
"not": {
"required": [
"presentation"
]
}
}
],
"properties": {
"type": {
"const": "info"
}
}
}
],
"required": [
"type",
"code",
"content"
],
"properties": {
"code": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]*$"
},
"data": {
"type": "object"
},
"path": {
"type": "string",
"pattern": "^\\$"
},
"type": {
"enum": [
"info",
"warning",
"error"
]
},
"content": {
"type": "string",
"minLength": 1
},
"severity": {
"enum": [
"recoverable",
"requires_buyer_input",
"requires_buyer_review",
"unrecoverable"
]
},
"presentation": {
"enum": [
"notice",
"disclosure"
]
}
},
"additionalProperties": false
},
"product": {
"type": "object",
"required": [
"id",
"title",
"description",
"url",
"price_range",
"media",
"variants",
"metadata"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"url": {
"type": "string",
"pattern": "^https://[^?#]+\\?(.*&)?src=(api|skill|ucp)(&.*)?$"
},
"media": {
"type": "array",
"items": {
"$ref": "#/definitions/media"
}
},
"title": {
"type": "string",
"minLength": 1
},
"rating": {
"$ref": "#/definitions/rating"
},
"options": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"values"
],
"properties": {
"name": {
"type": "string"
},
"values": {
"type": "array",
"items": {
"type": "object",
"required": [
"label"
],
"properties": {
"label": {
"type": "string"
}
}
},
"minItems": 1
}
},
"additionalProperties": false
}
},
"metadata": {
"$ref": "#/definitions/metadata"
},
"selected": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"label"
],
"properties": {
"name": {
"type": "string"
},
"label": {
"type": "string"
}
}
}
},
"variants": {
"type": "array",
"items": {
"$ref": "#/definitions/variant"
},
"minItems": 1
},
"categories": {
"type": "array",
"items": {
"type": "object",
"required": [
"value",
"taxonomy"
],
"properties": {
"value": {
"type": "string",
"pattern": "^[a-z0-9-]+(/[a-z0-9-]+)*$"
},
"taxonomy": {
"const": "merchant"
}
},
"additionalProperties": false
}
},
"description": {
"$ref": "#/definitions/description"
},
"price_range": {
"$ref": "#/definitions/price_range"
},
"list_price_range": {
"$ref": "#/definitions/price_range"
}
},
"additionalProperties": false
},
"variant": {
"type": "object",
"required": [
"id",
"title",
"description",
"url",
"price",
"availability",
"options",
"media",
"seller",
"checkout_url",
"condition"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"url": {
"type": "string",
"pattern": "^https://[^?#]+\\?(.*&)?src=(api|skill|ucp)(&.*)?$"
},
"media": {
"type": "array",
"items": {
"$ref": "#/definitions/media"
},
"maxItems": 1
},
"price": {
"$ref": "#/definitions/money"
},
"title": {
"type": "string",
"minLength": 1
},
"inputs": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"match"
],
"properties": {
"id": {
"type": "string"
},
"match": {
"enum": [
"exact",
"featured"
]
}
},
"additionalProperties": false
},
"minItems": 1
},
"rating": {
"$ref": "#/definitions/rating"
},
"seller": {
"$ref": "#/definitions/seller"
},
"options": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"label"
],
"properties": {
"name": {
"type": "string"
},
"label": {
"type": "string"
}
},
"additionalProperties": false
}
},
"condition": {
"type": "array",
"items": {
"const": "new"
}
},
"list_price": {
"$ref": "#/definitions/money"
},
"description": {
"$ref": "#/definitions/description"
},
"availability": {
"type": "object",
"required": [
"available"
],
"properties": {
"available": {
"type": "boolean"
}
},
"additionalProperties": false
},
"checkout_url": {
"type": "string",
"pattern": "^https://[^/]+/cart\\?products=[0-9a-f-]{36}:1&src=(api|skill|ucp)(&agent=[^&]+)?$"
}
},
"additionalProperties": false
},
"metadata": {
"type": "object",
"required": [
"maker",
"regular_delivery",
"context_status"
],
"properties": {
"etag": {
"type": "string"
},
"maker": {
"type": "object",
"required": [
"id",
"name",
"link"
],
"properties": {
"id": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"loc": {
"type": "string"
},
"link": {
"type": "string",
"pattern": "^[a-z0-9][a-z0-9_-]*$"
},
"name": {
"type": "string"
}
},
"additionalProperties": false
},
"offers": {
"type": "array",
"items": {
"$ref": "#/definitions/offer"
}
},
"context": {
"type": [
"object",
"null"
]
},
"context_md": {
"type": "string",
"pattern": "^https://[^?#]+\\?(.*&)?src=(api|skill|ucp)(&.*)?$"
},
"ships_from": {
"type": "object",
"required": [
"country"
],
"properties": {
"city": {
"type": "string"
},
"state": {
"type": "string"
},
"country": {
"const": "US"
}
},
"additionalProperties": false
},
"context_status": {
"enum": [
"live",
"pending"
]
},
"regular_delivery": {
"type": "boolean"
},
"ships_within_days": {
"type": "array",
"items": {
"type": "integer",
"minimum": 0
},
"maxItems": 2,
"minItems": 2,
"description": "Days until the maker usually ships (dispatch time from the store's shipping option), not a delivery date; absent when the store has not set one."
},
"cart_link_template": {
"type": "string",
"pattern": "^https://[^/]+/cart\\?products=[0-9a-f-]{36}:\\{qty\\}&src=(api|skill|ucp)&agent=[^&]+&cart_link_id=\\{cart_link_id\\}$"
},
"delivery_estimate_days": {
"type": "array",
"items": {
"type": "integer",
"minimum": 0
},
"maxItems": 2,
"minItems": 2,
"description": "Reserved; not sent today."
}
},
"additionalProperties": false
},
"description": {
"type": "object",
"required": [
"plain"
],
"properties": {
"plain": {
"type": "string",
"minLength": 1
}
},
"additionalProperties": false
},
"price_range": {
"type": "object",
"required": [
"min",
"max"
],
"properties": {
"max": {
"$ref": "#/definitions/money"
},
"min": {
"$ref": "#/definitions/money"
}
},
"additionalProperties": false
},
"error_document": {
"type": "object",
"required": [
"ucp",
"messages",
"next"
],
"properties": {
"ucp": {
"type": "object",
"required": [
"version",
"status"
],
"properties": {
"status": {
"const": "error"
},
"version": {
"const": "2026-04-08"
}
},
"additionalProperties": false
},
"next": {
"type": "array",
"items": {
"type": "string",
"maxLength": 400,
"minLength": 1
},
"maxItems": 4,
"minItems": 1
},
"messages": {
"type": "array",
"items": {
"$ref": "#/definitions/message"
},
"minItems": 1,
"description": "At least one message has type error."
}
},
"additionalProperties": false
}
}
}