Create cart
create_cartCreate 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.
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": {
"cart": "<cart>"
},
"name": "create_cart"
}
}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". | |
| cart | Yes | The cart to create: line_items, with optional context, attribution and why. | |
| meta | No | Optional UCP request metadata. meta["ucp-agent"].profile is your UCP agent profile URL; it is recorded, never required. | |
| 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 | |||