Everyday products from independent brands in one cart; the person reviews and pays on loyaltie.com.
Maintain this server? Claim it
Call this server's tools from your browser. Nothing to install.
Requests go through mcptry because browsers can't call most MCP servers directly. Header values are sent to the server for that request only and are never stored or logged.
Tool list from our last check. Connect live to refresh it.
A loyaltie.com cart link for 1 to 20 listed products (quantity 1 to 99, each id once, one-time purchase). It places no order and takes no payment: give the link to the person; they review the cart on loyaltie.com and, to pay, sign in or create an account there; tell them that. Ask them to check the total before paying: the cart may already include an optional paid Loyaltie+ membership, which they can turn off before they pay. It checks only that each product is listed, not that it is in stock; sold-out products are left out when the person opens the link, which sets each linked product's quantity to the link's (it is not added on top) and keeps other products already in the cart. You never pay or place an order. Unknown ids fail with not_found.
The cart link to build: line_items, with optional context and attribution.
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".
Optional UCP request metadata. meta["ucp-agent"].profile is your UCP agent profile URL; it is recorded, never required.
Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped.
This tool isn't marked read-only, so it may change something on the server or in an account you connected.
Pick your client. Values in capitals, like YOUR_TOKEN, are yours to fill in.
Run in a terminal
claude mcp add --transport http catalog https://loyaltie.com/api/ucp/mcp
A loyaltie.com cart link for 1 to 20 listed products (quantity 1 to 99, each id once, one-time purchase). It places no order and takes no payment: give the link to the person; they review the cart on loyaltie.com and, to pay, sign in or create an account there; tell them that. Ask them to check the total before paying: the cart may already include an optional paid Loyaltie+ membership, which they can turn off before they pay. It checks only that each product is listed, not that it is in stock; sold-out products are left out when the person opens the link, which sets each linked product's quantity to the link's (it is not added on top) and keeps other products already in the cart. You never pay or place an order. Unknown ids fail with not_found.
| Argument | Type | Description |
|---|---|---|
| src | string | 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". |
| cart* | object | The cart link to build: line_items, with optional context and attribution. |
| meta | object | Optional UCP request metadata. meta["ucp-agent"].profile is your UCP agent profile URL; it is recorded, never required. |
| agent_id | string | Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"cart"
],
"properties": {
"src": {
"type": "string",
"maxLength": 32,
"description": "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\"."
},
"cart": {
"type": "object",
"required": [
"line_items"
],
"properties": {
"context": {
"type": "object",
"properties": {
"intent": {
"type": "string",
"maxLength": 500,
"description": "Tell us the person's task in a few words; it improves results and is never shared."
}
},
"description": "Optional. Only intent is read.",
"additionalProperties": true
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"id",
"quantity"
],
"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}$",
"description": "Product id from a catalog result."
},
"quantity": {
"type": "integer",
"maximum": 99,
"minimum": 1,
"description": "How many, 1 to 99."
}
},
"additionalProperties": false
},
"maxItems": 20,
"minItems": 1,
"description": "1 to 20 products, each id once."
},
"attribution": {
"type": "object",
"description": "UCP attribution: URL-style campaign and click parameters, string values. Recorded for reporting; never changes the response."
}
},
"description": "The cart link to build: line_items, with optional context and attribution.",
"additionalProperties": false
},
"meta": {
"type": "object",
"properties": {
"ucp-agent": {
"type": "object",
"properties": {
"profile": {
"type": "string",
"maxLength": 1024,
"description": "Your UCP agent profile URL. Recorded, never required."
}
},
"description": "Your UCP agent details.",
"additionalProperties": true
}
},
"description": "Optional UCP request metadata. meta[\"ucp-agent\"].profile is your UCP agent profile URL; it is recorded, never required.",
"additionalProperties": true
},
"agent_id": {
"type": "string",
"maxLength": 255,
"description": "Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped."
}
},
"additionalProperties": false
}Create a cart on loyaltie.com for 1 to 20 listed products from any number of makers (quantity 1 to 99, each id once, one-time purchase). Prices and stock come from our catalog, never from the request. Returns id, line items with prices, totals for the items only (shipping, any discount and any Loyaltie+ membership in the cart are added at checkout), continue_url and expires_at: give the person continue_url; they sign in or create an account at checkout and pay on loyaltie.com, because paying needs an account. Ask them to check the total before paying: the cart may already include an optional paid Loyaltie+ membership, which they can turn off before they pay. You never pay or place an order. An unavailable or sold-out item fails the call with its path; a quantity above the stock on hand is lowered, with a warning.
| Argument | Type | Description |
|---|---|---|
| src | string | 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". |
| cart* | object | The cart to create: line_items, with optional context, attribution and why. |
| meta | object | Optional UCP request metadata. meta["ucp-agent"].profile is your UCP agent profile URL; it is recorded, never required. |
| agent_id | string | Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"cart"
],
"properties": {
"src": {
"type": "string",
"maxLength": 32,
"description": "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\"."
},
"cart": {
"type": "object",
"required": [
"line_items"
],
"properties": {
"why": {
"type": "string",
"maxLength": 500,
"description": "Optional: why these products, in a few words. Recorded, never shared; never changes the cart."
},
"context": {
"type": "object",
"properties": {
"intent": {
"type": "string",
"maxLength": 500,
"description": "Tell us the person's task in a few words; it improves results and is never shared."
}
},
"description": "Optional UCP context. Only intent is read.",
"additionalProperties": true
},
"line_items": {
"type": "array",
"items": {
"type": "object",
"required": [
"item",
"quantity"
],
"properties": {
"item": {
"type": "object",
"required": [
"id"
],
"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}$",
"description": "Product id from a catalog result."
}
},
"description": "The product.",
"additionalProperties": true
},
"quantity": {
"type": "integer",
"maximum": 99,
"minimum": 1,
"description": "How many, 1 to 99."
}
},
"additionalProperties": true
},
"maxItems": 20,
"minItems": 1,
"description": "1 to 20 products, each id once."
},
"attribution": {
"type": "object",
"description": "UCP attribution: URL-style campaign and click parameters, string values. Recorded for reporting; never changes the response."
}
},
"description": "The cart to create: line_items, with optional context, attribution and why.",
"additionalProperties": true
},
"meta": {
"type": "object",
"properties": {
"ucp-agent": {
"type": "object",
"properties": {
"profile": {
"type": "string",
"maxLength": 1024,
"description": "Your UCP agent profile URL. Recorded, never required."
}
},
"description": "Your UCP agent details.",
"additionalProperties": true
}
},
"description": "Optional UCP request metadata. meta[\"ucp-agent\"].profile is your UCP agent profile URL; it is recorded, never required.",
"additionalProperties": true
},
"agent_id": {
"type": "string",
"maxLength": 255,
"description": "Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped."
}
},
"additionalProperties": false
}A cart create_cart returned, by id, with current prices, quantities and availability, totals for the items only (shipping, any discount and any Loyaltie+ membership in the cart are added at checkout), and the same continue_url cart. When you give the person continue_url, ask them to check the total before paying: the cart may already include an optional paid Loyaltie+ membership, which they can turn off before they pay. An item no longer available or sold out fails the call with its path; a quantity above the stock now on hand is lowered, with a warning. An unknown or expired id fails with not_found.
| Argument | Type | Description |
|---|---|---|
| src | string | 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". |
| cart* | object | The cart to read: id, with optional context. |
| meta | object | Optional UCP request metadata. meta["ucp-agent"].profile is your UCP agent profile URL; it is recorded, never required. |
| agent_id | string | Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"cart"
],
"properties": {
"src": {
"type": "string",
"maxLength": 32,
"description": "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\"."
},
"cart": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"maxLength": 1400,
"minLength": 1,
"description": "The id create_cart returned."
},
"context": {
"type": "object",
"properties": {
"intent": {
"type": "string",
"maxLength": 500,
"description": "Tell us the person's task in a few words; it improves results and is never shared."
}
},
"description": "Optional. Only intent is read.",
"additionalProperties": true
}
},
"description": "The cart to read: id, with optional context.",
"additionalProperties": true
},
"meta": {
"type": "object",
"properties": {
"ucp-agent": {
"type": "object",
"properties": {
"profile": {
"type": "string",
"maxLength": 1024,
"description": "Your UCP agent profile URL. Recorded, never required."
}
},
"description": "Your UCP agent details.",
"additionalProperties": true
}
},
"description": "Optional UCP request metadata. meta[\"ucp-agent\"].profile is your UCP agent profile URL; it is recorded, never required.",
"additionalProperties": true
},
"agent_id": {
"type": "string",
"maxLength": 255,
"description": "Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped."
}
},
"additionalProperties": false
}A maker's profile (story, city and state, shipping policy) and its listed products, by maker id or store link. The products are short references (id, title, price, availability, at most one photo) with no link or warnings: call lookup_catalog for links and warnings before showing any product.
| Argument | Type | Description |
|---|---|---|
| src | string | 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 | object | Optional UCP request metadata. meta["ucp-agent"].profile is your UCP agent profile URL; it is recorded, never required. |
| maker* | object | The maker to read: id, with optional context and attribution. |
| agent_id | string | Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"maker"
],
"properties": {
"src": {
"type": "string",
"maxLength": 32,
"description": "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": {
"type": "object",
"properties": {
"ucp-agent": {
"type": "object",
"properties": {
"profile": {
"type": "string",
"maxLength": 1024,
"description": "Your UCP agent profile URL. Recorded, never required."
}
},
"description": "Your UCP agent details.",
"additionalProperties": true
}
},
"description": "Optional UCP request metadata. meta[\"ucp-agent\"].profile is your UCP agent profile URL; it is recorded, never required.",
"additionalProperties": true
},
"maker": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"anyOf": [
{
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
{
"pattern": "^[a-z0-9][a-z0-9_-]*$"
}
],
"maxLength": 64,
"minLength": 1,
"description": "Maker id (seller.id) or store link (metadata.maker.link)."
},
"context": {
"type": "object",
"properties": {
"intent": {
"type": "string",
"maxLength": 500,
"description": "Tell us the person's task in a few words; it improves results and is never shared."
}
},
"description": "Optional. Only intent is read.",
"additionalProperties": true
},
"attribution": {
"type": "object",
"description": "UCP attribution: URL-style campaign and click parameters, string values. Recorded for reporting; never changes the response."
}
},
"description": "The maker to read: id, with optional context and attribution.",
"additionalProperties": false
},
"agent_id": {
"type": "string",
"maxLength": 255,
"description": "Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped."
}
},
"additionalProperties": false
}One full product by id or URL: price, conditional offers with terms, variants, availability, rating, ships-from, the verbatim Agent Context, and allergen and safety disclosures as warning messages. Skip it when earlier results already answer. An unknown id fails with not_found.
| Argument | Type | Description |
|---|---|---|
| src | string | 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 | object | Optional UCP request metadata. meta["ucp-agent"].profile is your UCP agent profile URL; it is recorded, never required. |
| catalog* | object | The product to read: id, with optional selected, preferences, context and filters. |
| agent_id | string | Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"catalog"
],
"properties": {
"src": {
"type": "string",
"maxLength": 32,
"description": "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": {
"type": "object",
"properties": {
"ucp-agent": {
"type": "object",
"properties": {
"profile": {
"type": "string",
"maxLength": 1024,
"description": "Your UCP agent profile URL. Recorded, never required."
}
},
"description": "Your UCP agent details.",
"additionalProperties": true
}
},
"description": "Optional UCP request metadata. meta[\"ucp-agent\"].profile is your UCP agent profile URL; it is recorded, never required.",
"additionalProperties": true
},
"catalog": {
"type": "object",
"required": [
"id"
],
"properties": {
"id": {
"type": "string",
"anyOf": [
{
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
{
"pattern": "^https://"
}
],
"maxLength": 2048,
"minLength": 1,
"description": "A product id or loyaltie.com product URL, exactly as returned."
},
"context": {
"type": "object",
"properties": {
"intent": {
"type": "string",
"maxLength": 500,
"description": "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."
},
"currency": {
"type": "string",
"description": "ISO 4217. Prices are not converted; a currency other than USD is reported in messages."
},
"language": {
"type": "string",
"description": "BCP 47. Accepted, no effect. Our messages are English; maker text is shown as written."
},
"postal_code": {
"type": "string",
"description": "Accepted, no effect."
},
"address_region": {
"type": "string",
"description": "State, e.g. NC. Makers in this state rank higher."
},
"address_country": {
"type": "string",
"description": "ISO 3166-1 alpha-2, e.g. US."
}
},
"description": "Soft: ranks and localizes, never removes a product. Prices are never converted to context.currency; each price states its own currency.",
"additionalProperties": true
},
"filters": {
"type": "object",
"properties": {
"price": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"minimum": 0,
"description": "Highest price, in USD cents."
},
"min": {
"type": "integer",
"minimum": 0,
"description": "Lowest price, in USD cents."
}
},
"description": "Inclusive bounds in USD cents.",
"additionalProperties": false
},
"shops": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 1000,
"minItems": 1,
"description": "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."
},
"occasion": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
],
"description": "OR. Occasions such as gift. A product with no occasion listed does not match; for a soft preference use context.intent."
},
"ships_to": {
"type": "object",
"required": [
"country"
],
"properties": {
"region": {
"type": "string",
"description": "The US state: USPS code (NC) or name."
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "ISO 3166-1 alpha-2. Only US can be checked."
},
"postal_code": {
"type": "string",
"description": "Not applied; reported as filter_ignored."
}
},
"description": "The US state the order ships to: {country: \"US\", region}. Makers with no state list are kept, including one with no shipping set up; a match does not prove the product ships there, the cart confirms. Only US states can be checked: another country returns nothing, which does not mean no maker ships there; leave ships_to out and let the product page and cart confirm.",
"additionalProperties": true
},
"available": {
"type": "boolean",
"default": true,
"description": "true/omitted: buyable only; false: also unavailable."
},
"condition": {
"type": "array",
"items": {
"type": "string"
},
"description": "Every product is new."
},
"attributes": {
"type": "array",
"items": {
"type": "object"
},
"description": "Not applied (products carry no attribute data); reported as filter_ignored."
},
"categories": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9-]+(/[a-z0-9-]+)*$"
},
"maxItems": 50,
"minItems": 1,
"description": "OR. Category path slugs, e.g. drink/coffee; a path matches its subcategories."
},
"ships_from": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"region": {
"type": "string",
"minLength": 2,
"description": "The maker's state: USPS code (NC) or name."
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Default US."
}
},
"additionalProperties": true
},
"maxItems": 60,
"minItems": 1
},
{
"type": "object",
"properties": {
"region": {
"type": "string",
"minLength": 2,
"description": "The maker's state: USPS code (NC) or name."
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Default US."
}
},
"additionalProperties": true
}
],
"description": "Where the maker ships from; OR across entries. Our maker-state filter is region."
},
"regular_delivery": {
"type": "boolean",
"description": "true: only products with a regular-delivery plan of their own or in a bundle on one."
}
},
"description": "Hard requirements: fields AND, values inside one list OR. A filter that cannot be applied is reported in messages (filter_ignored).",
"additionalProperties": true
},
"signals": {
"type": "object",
"description": "UCP signals. Accepted and ignored.",
"additionalProperties": true
},
"selected": {
"type": "array",
"items": {
"type": "object",
"required": [
"name",
"label"
],
"properties": {
"name": {
"type": "string",
"description": "Option name."
},
"label": {
"type": "string",
"description": "Chosen value."
}
}
},
"description": "Accepted. Products have no option choices yet, so product.selected is []."
},
"attribution": {
"type": "object",
"description": "UCP attribution: URL-style campaign and click parameters, string values. Recorded for reporting; never changes the response."
},
"preferences": {
"type": "array",
"items": {
"type": "string"
},
"description": "Accepted, no effect."
}
},
"description": "The product to read: id, with optional selected, preferences, context and filters.",
"additionalProperties": true
},
"agent_id": {
"type": "string",
"maxLength": 255,
"description": "Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped."
}
},
"additionalProperties": false
}Full products for 1 to 50 known ids or loyaltie.com product URLs, exactly as other calls returned them. Unknown ids are reported in messages; when none is found the call fails with not_found. Amounts are cents.
| Argument | Type | Description |
|---|---|---|
| src | string | 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 | object | Optional UCP request metadata. meta["ucp-agent"].profile is your UCP agent profile URL; it is recorded, never required. |
| catalog* | object | The products to read: ids, with optional filters, context and view. |
| agent_id | string | Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"catalog"
],
"properties": {
"src": {
"type": "string",
"maxLength": 32,
"description": "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": {
"type": "object",
"properties": {
"ucp-agent": {
"type": "object",
"properties": {
"profile": {
"type": "string",
"maxLength": 1024,
"description": "Your UCP agent profile URL. Recorded, never required."
}
},
"description": "Your UCP agent details.",
"additionalProperties": true
}
},
"description": "Optional UCP request metadata. meta[\"ucp-agent\"].profile is your UCP agent profile URL; it is recorded, never required.",
"additionalProperties": true
},
"catalog": {
"type": "object",
"required": [
"ids"
],
"properties": {
"ids": {
"type": "array",
"items": {
"type": "string",
"anyOf": [
{
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
{
"pattern": "^https://"
}
],
"maxLength": 2048,
"minLength": 1
},
"maxItems": 50,
"minItems": 1,
"description": "Product ids or loyaltie.com product URLs exactly as returned."
},
"view": {
"enum": [
"short",
"full"
],
"default": "full",
"description": "\"full\" (default) adds offers, the Agent Context, all images and the cart link template; \"short\" leaves them out."
},
"context": {
"type": "object",
"properties": {
"intent": {
"type": "string",
"maxLength": 500,
"description": "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."
},
"currency": {
"type": "string",
"description": "ISO 4217. Prices are not converted; a currency other than USD is reported in messages."
},
"language": {
"type": "string",
"description": "BCP 47. Accepted, no effect. Our messages are English; maker text is shown as written."
},
"postal_code": {
"type": "string",
"description": "Accepted, no effect."
},
"address_region": {
"type": "string",
"description": "State, e.g. NC. Makers in this state rank higher."
},
"address_country": {
"type": "string",
"description": "ISO 3166-1 alpha-2, e.g. US."
}
},
"description": "Soft: ranks and localizes, never removes a product. Prices are never converted to context.currency; each price states its own currency.",
"additionalProperties": true
},
"filters": {
"type": "object",
"properties": {
"price": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"minimum": 0,
"description": "Highest price, in USD cents."
},
"min": {
"type": "integer",
"minimum": 0,
"description": "Lowest price, in USD cents."
}
},
"description": "Inclusive bounds in USD cents.",
"additionalProperties": false
},
"shops": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 1000,
"minItems": 1,
"description": "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."
},
"occasion": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
],
"description": "OR. Occasions such as gift. A product with no occasion listed does not match; for a soft preference use context.intent."
},
"ships_to": {
"type": "object",
"required": [
"country"
],
"properties": {
"region": {
"type": "string",
"description": "The US state: USPS code (NC) or name."
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "ISO 3166-1 alpha-2. Only US can be checked."
},
"postal_code": {
"type": "string",
"description": "Not applied; reported as filter_ignored."
}
},
"description": "The US state the order ships to: {country: \"US\", region}. Makers with no state list are kept, including one with no shipping set up; a match does not prove the product ships there, the cart confirms. Only US states can be checked: another country returns nothing, which does not mean no maker ships there; leave ships_to out and let the product page and cart confirm.",
"additionalProperties": true
},
"available": {
"type": "boolean",
"default": true,
"description": "true/omitted: buyable only; false: also unavailable."
},
"condition": {
"type": "array",
"items": {
"type": "string"
},
"description": "Every product is new."
},
"attributes": {
"type": "array",
"items": {
"type": "object"
},
"description": "Not applied (products carry no attribute data); reported as filter_ignored."
},
"categories": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9-]+(/[a-z0-9-]+)*$"
},
"maxItems": 50,
"minItems": 1,
"description": "OR. Category path slugs, e.g. drink/coffee; a path matches its subcategories."
},
"ships_from": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"region": {
"type": "string",
"minLength": 2,
"description": "The maker's state: USPS code (NC) or name."
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Default US."
}
},
"additionalProperties": true
},
"maxItems": 60,
"minItems": 1
},
{
"type": "object",
"properties": {
"region": {
"type": "string",
"minLength": 2,
"description": "The maker's state: USPS code (NC) or name."
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Default US."
}
},
"additionalProperties": true
}
],
"description": "Where the maker ships from; OR across entries. Our maker-state filter is region."
},
"regular_delivery": {
"type": "boolean",
"description": "true: only products with a regular-delivery plan of their own or in a bundle on one."
}
},
"description": "Hard requirements: fields AND, values inside one list OR. A filter that cannot be applied is reported in messages (filter_ignored).",
"additionalProperties": true
},
"signals": {
"type": "object",
"description": "UCP signals. Accepted and ignored.",
"additionalProperties": true
},
"attribution": {
"type": "object",
"description": "UCP attribution: URL-style campaign and click parameters, string values. Recorded for reporting; never changes the response."
}
},
"description": "The products to read: ids, with optional filters, context and view.",
"additionalProperties": true
},
"agent_id": {
"type": "string",
"maxLength": 255,
"description": "Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped."
}
},
"additionalProperties": false
}Search 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.
| Argument | Type | Description |
|---|---|---|
| src | string | 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 | object | Optional UCP request metadata. meta["ucp-agent"].profile is your UCP agent profile URL; it is recorded, never required. |
| catalog* | object | The search: query or like, with optional filters, context, pagination and view. |
| agent_id | string | Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"catalog"
],
"properties": {
"src": {
"type": "string",
"maxLength": 32,
"description": "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": {
"type": "object",
"properties": {
"ucp-agent": {
"type": "object",
"properties": {
"profile": {
"type": "string",
"maxLength": 1024,
"description": "Your UCP agent profile URL. Recorded, never required."
}
},
"description": "Your UCP agent details.",
"additionalProperties": true
}
},
"description": "Optional UCP request metadata. meta[\"ucp-agent\"].profile is your UCP agent profile URL; it is recorded, never required.",
"additionalProperties": true
},
"catalog": {
"type": "object",
"anyOf": [
{
"required": [
"query"
]
},
{
"required": [
"like"
]
}
],
"properties": {
"like": {
"type": "array",
"items": {
"type": "object"
},
"maxItems": 2,
"minItems": 1,
"description": "Not offered yet; send query."
},
"view": {
"enum": [
"short",
"full"
],
"default": "short",
"description": "\"full\" adds offers, the Agent Context, all images and the cart link template."
},
"query": {
"type": "string",
"maxLength": 500,
"minLength": 1,
"description": "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."
},
"context": {
"type": "object",
"properties": {
"intent": {
"type": "string",
"maxLength": 500,
"description": "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."
},
"currency": {
"type": "string",
"description": "ISO 4217. Prices are not converted; a currency other than USD is reported in messages."
},
"language": {
"type": "string",
"description": "BCP 47. Accepted, no effect. Our messages are English; maker text is shown as written."
},
"postal_code": {
"type": "string",
"description": "Accepted, no effect."
},
"address_region": {
"type": "string",
"description": "State, e.g. NC. Makers in this state rank higher."
},
"address_country": {
"type": "string",
"description": "ISO 3166-1 alpha-2, e.g. US."
}
},
"description": "Soft: ranks and localizes, never removes a product. Prices are never converted to context.currency; each price states its own currency.",
"additionalProperties": true
},
"filters": {
"type": "object",
"properties": {
"price": {
"type": "object",
"properties": {
"max": {
"type": "integer",
"minimum": 0,
"description": "Highest price, in USD cents."
},
"min": {
"type": "integer",
"minimum": 0,
"description": "Lowest price, in USD cents."
}
},
"description": "Inclusive bounds in USD cents.",
"additionalProperties": false
},
"shops": {
"type": "array",
"items": {
"type": "string",
"minLength": 1
},
"maxItems": 1000,
"minItems": 1,
"description": "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."
},
"rating": {
"type": "object",
"description": "Not applied; reported as filter_ignored."
},
"occasion": {
"anyOf": [
{
"type": "string"
},
{
"type": "array",
"items": {
"type": "string"
}
}
],
"description": "OR. Occasions such as gift. A product with no occasion listed does not match; for a soft preference use context.intent."
},
"ships_to": {
"type": "object",
"required": [
"country"
],
"properties": {
"region": {
"type": "string",
"description": "The US state: USPS code (NC) or name."
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "ISO 3166-1 alpha-2. Only US can be checked."
},
"postal_code": {
"type": "string",
"description": "Not applied; reported as filter_ignored."
}
},
"description": "The US state the order ships to: {country: \"US\", region}. Makers with no state list are kept, including one with no shipping set up; a match does not prove the product ships there, the cart confirms. Only US states can be checked: another country returns nothing, which does not mean no maker ships there; leave ships_to out and let the product page and cart confirm.",
"additionalProperties": true
},
"available": {
"type": "boolean",
"default": true,
"description": "true/omitted: buyable only; false: also unavailable."
},
"condition": {
"type": "array",
"items": {
"type": "string"
},
"description": "Every product is new."
},
"attributes": {
"type": "array",
"items": {
"type": "object"
},
"description": "Not applied (products carry no attribute data); reported as filter_ignored."
},
"categories": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[a-z0-9-]+(/[a-z0-9-]+)*$"
},
"maxItems": 50,
"minItems": 1,
"description": "OR. Category path slugs, e.g. drink/coffee; a path matches its subcategories."
},
"price_tier": {
"type": "array",
"items": {
"type": "string"
},
"description": "Not applied; reported as filter_ignored. Use price."
},
"ships_from": {
"anyOf": [
{
"type": "array",
"items": {
"type": "object",
"properties": {
"region": {
"type": "string",
"minLength": 2,
"description": "The maker's state: USPS code (NC) or name."
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Default US."
}
},
"additionalProperties": true
},
"maxItems": 60,
"minItems": 1
},
{
"type": "object",
"properties": {
"region": {
"type": "string",
"minLength": 2,
"description": "The maker's state: USPS code (NC) or name."
},
"country": {
"type": "string",
"pattern": "^[A-Z]{2}$",
"description": "Default US."
}
},
"additionalProperties": true
}
],
"description": "Where the maker ships from; OR across entries. Our maker-state filter is region."
},
"regular_delivery": {
"type": "boolean",
"description": "true: only products with a regular-delivery plan of their own or in a bundle on one."
}
},
"description": "Hard requirements: fields AND, values inside one list OR. A filter that cannot be applied is reported in messages (filter_ignored).",
"additionalProperties": true
},
"signals": {
"type": "object",
"description": "UCP signals. Accepted and ignored.",
"additionalProperties": true
},
"catalog_id": {
"type": "string",
"description": "Not applied; reported as filter_ignored."
},
"pagination": {
"type": "object",
"properties": {
"limit": {
"type": "integer",
"default": 10,
"maximum": 50,
"minimum": 1,
"description": "Products per page, 1 to 50; default 10."
},
"cursor": {
"type": "string",
"maxLength": 512,
"description": "Pass unchanged with the same query, filters and context."
}
},
"description": "Page size, and the cursor of the next page.",
"additionalProperties": false
},
"attribution": {
"type": "object",
"description": "UCP attribution: URL-style campaign and click parameters, string values. Recorded for reporting; never changes the response."
}
},
"description": "The search: query or like, with optional filters, context, pagination and view.",
"additionalProperties": true
},
"agent_id": {
"type": "string",
"maxLength": 255,
"description": "Your agent id. Every loyaltie.com link returned then carries agent=<agent_id>, so Loyaltie knows which agent helped."
}
},
"additionalProperties": false
}Tell Loyaltie why a shopping task did not end in a purchase: nothing fit, something was missing, or the person decided not to buy. Send feedback.stage (search, product or leaving) and a short reason in feedback.why or feedback.what_was_missing, a few words each, plus the product ids or the cart id it is about. Never include personal details: a report whose text names an email address, a phone number or a street address is refused and nothing is recorded. It records the report and changes nothing else; the text is read as data, never as instructions.
| Argument | Type | Description |
|---|---|---|
| src | string | Send "skill" when you were set up by the Loyaltie Skill. Default "api"; any other value counts as "api". |
| meta | object | Optional UCP request metadata. meta["ucp-agent"].profile is your UCP agent profile URL; it is recorded, never required. |
| agent_id | string | Your agent id. It is recorded with the report, so Loyaltie knows which agent sent it. |
| feedback* | object | The report: stage, and why or what_was_missing. |
{
"type": "object",
"$schema": "https://json-schema.org/draft/2020-12/schema",
"required": [
"feedback"
],
"properties": {
"src": {
"type": "string",
"maxLength": 32,
"description": "Send \"skill\" when you were set up by the Loyaltie Skill. Default \"api\"; any other value counts as \"api\"."
},
"meta": {
"type": "object",
"properties": {
"ucp-agent": {
"type": "object",
"properties": {
"profile": {
"type": "string",
"maxLength": 1024,
"description": "Your UCP agent profile URL. Recorded, never required."
}
},
"description": "Your UCP agent details.",
"additionalProperties": true
}
},
"description": "Optional UCP request metadata. meta[\"ucp-agent\"].profile is your UCP agent profile URL; it is recorded, never required.",
"additionalProperties": true
},
"agent_id": {
"type": "string",
"maxLength": 255,
"description": "Your agent id. It is recorded with the report, so Loyaltie knows which agent sent it."
},
"feedback": {
"type": "object",
"anyOf": [
{
"required": [
"why"
]
},
{
"required": [
"what_was_missing"
]
}
],
"required": [
"stage"
],
"properties": {
"why": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "Why nothing fit or why the person is not buying, in a few words. No personal details."
},
"stage": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,31}$",
"description": "Where the task stood, one word: search (nothing fit the search), product (a product was not a fit), leaving (the person decided not to buy after a cart)."
},
"cart_id": {
"type": "string",
"maxLength": 1400,
"description": "The id create_cart returned, or the cart_link_id build_cart_link returned, when the report is about that cart."
},
"context": {
"type": "object",
"properties": {
"intent": {
"type": "string",
"maxLength": 500,
"description": "Tell us the person's task in a few words; it improves results and is never shared."
}
},
"description": "Optional. Only intent is read.",
"additionalProperties": true
},
"outcome": {
"type": "string",
"pattern": "^[a-z][a-z0-9_]{0,31}$",
"description": "Optional: how it ended, one word, such as no_match or not_buying."
},
"product_ids": {
"type": "array",
"items": {
"type": "string",
"pattern": "^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$"
},
"maxItems": 20,
"description": "The products the report is about."
},
"what_was_missing": {
"type": "string",
"maxLength": 2000,
"minLength": 1,
"description": "What the person was looking for that is not here, in a few words. No personal details."
}
},
"description": "The report: stage, and why or what_was_missing.",
"additionalProperties": true
}
},
"additionalProperties": false
}We read every tool's name, description and inputs the way the model will, looking for instructions hidden from you. A clean result means no warning signs, not a guarantee. Scanned Nov 19, 2026.