Tool tree
gradeNot graded
searchProductsAnswer
Search the store catalog by keyword with optional category and price filters. Returns matching products with id, name, price, currency, availability and product URL.
View tool JSON
{
"name": "searchProducts",
"kind": "answer",
"impl": "imperative",
"description": "Search the store catalog by keyword with optional category and price filters. Returns matching products with id, name, price, currency, availability and product URL.",
"inputSchema": {
"type": "object",
"properties": {
"query": {
"type": "string",
"description": "Search keywords or phrase",
"maxLength": 200
},
"category": {
"type": "integer",
"description": "Category id to filter by",
"minimum": 1
},
"minPrice": {
"type": "number",
"description": "Minimum price (in store currency)",
"minimum": 0
},
"maxPrice": {
"type": "number",
"description": "Maximum price (in store currency)",
"minimum": 0
},
"inStockOnly": {
"type": "boolean",
"description": "Return only in-stock products",
"default": false
},
"limit": {
"type": "integer",
"description": "Max number of results (capped server-side)",
"default": 12,
"minimum": 1,
"maximum": 50
}
},
"required": [
"query"
],
"additionalProperties": false
}
}getProductDetailsAnswer
Get full details for a product: combinations/variants with stock and price, attributes, features, and images.
View tool JSON
{
"name": "getProductDetails",
"kind": "answer",
"impl": "imperative",
"description": "Get full details for a product: combinations/variants with stock and price, attributes, features, and images.",
"inputSchema": {
"type": "object",
"properties": {
"productId": {
"type": "integer",
"description": "Product id",
"minimum": 1
}
},
"required": [
"productId"
],
"additionalProperties": false
}
}checkAvailabilityAnswer
Check current stock availability and estimated delivery for a product or specific combination.
View tool JSON
{
"name": "checkAvailability",
"kind": "answer",
"impl": "imperative",
"description": "Check current stock availability and estimated delivery for a product or specific combination.",
"inputSchema": {
"type": "object",
"properties": {
"productId": {
"type": "integer",
"minimum": 1
},
"combinationId": {
"type": "integer",
"description": "Optional combination/variant id",
"minimum": 1
}
},
"required": [
"productId"
],
"additionalProperties": false
}
}getCategoriesAnswer
Get the category tree (or a subtree) for navigation. Returns id, name, depth and children for each node.
View tool JSON
{
"name": "getCategories",
"kind": "answer",
"impl": "imperative",
"description": "Get the category tree (or a subtree) for navigation. Returns id, name, depth and children for each node.",
"inputSchema": {
"type": "object",
"properties": {
"parentId": {
"type": "integer",
"description": "Root of the subtree. Defaults to store root.",
"minimum": 1
},
"depth": {
"type": "integer",
"description": "Maximum depth to traverse",
"default": 2,
"minimum": 1,
"maximum": 5
}
},
"additionalProperties": false
}
}getStoreInfoAnswer
Get store metadata: name, supported languages and currencies, shipping countries, return policy summary, accepted payment method names (not credentials), and public contact info.
View tool JSON
{
"name": "getStoreInfo",
"kind": "answer",
"impl": "imperative",
"description": "Get store metadata: name, supported languages and currencies, shipping countries, return policy summary, accepted payment method names (not credentials), and public contact info.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}getShippingOptionsAnswer
Get available shipping carriers, costs and estimated delivery times for the current cart or a destination.
View tool JSON
{
"name": "getShippingOptions",
"kind": "answer",
"impl": "imperative",
"description": "Get available shipping carriers, costs and estimated delivery times for the current cart or a destination.",
"inputSchema": {
"type": "object",
"properties": {
"countryIso": {
"type": "string",
"description": "ISO 3166-1 alpha-2 country code",
"maxLength": 2
},
"zipCode": {
"type": "string",
"description": "Postal code",
"maxLength": 16
}
},
"additionalProperties": false
}
}getCartAnswer
Get the current shopping cart: line items, subtotal, shipping, total. Read-only.
View tool JSON
{
"name": "getCart",
"kind": "answer",
"impl": "imperative",
"description": "Get the current shopping cart: line items, subtotal, shipping, total. Read-only.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}addToCartAction
Add a product (and optional variant) to the current shopping cart. Does NOT complete any purchase. The browser will ask the user to confirm.
View tool JSON
{
"name": "addToCart",
"kind": "act",
"impl": "imperative",
"description": "Add a product (and optional variant) to the current shopping cart. Does NOT complete any purchase. The browser will ask the user to confirm.",
"inputSchema": {
"type": "object",
"properties": {
"productId": {
"type": "integer",
"minimum": 1
},
"combinationId": {
"type": "integer",
"description": "Optional variant id",
"minimum": 1
},
"quantity": {
"type": "integer",
"default": 1,
"minimum": 1,
"maximum": 999
}
},
"required": [
"productId"
],
"additionalProperties": false
}
}updateCartItemAction
Set the quantity of an existing line in the cart. Use quantity=0 to remove (or call removeFromCart).
View tool JSON
{
"name": "updateCartItem",
"kind": "act",
"impl": "imperative",
"description": "Set the quantity of an existing line in the cart. Use quantity=0 to remove (or call removeFromCart).",
"inputSchema": {
"type": "object",
"properties": {
"productId": {
"type": "integer",
"minimum": 1
},
"combinationId": {
"type": "integer",
"minimum": 1
},
"quantity": {
"type": "integer",
"minimum": 0,
"maximum": 999
}
},
"required": [
"productId",
"quantity"
],
"additionalProperties": false
}
}removeFromCartAction
Remove a specific line from the cart.
View tool JSON
{
"name": "removeFromCart",
"kind": "act",
"impl": "imperative",
"description": "Remove a specific line from the cart.",
"inputSchema": {
"type": "object",
"properties": {
"productId": {
"type": "integer",
"minimum": 1
},
"combinationId": {
"type": "integer",
"minimum": 1
}
},
"required": [
"productId"
],
"additionalProperties": false
}
}applyCouponAction
Apply a discount/voucher code to the cart. Returns whether it was accepted with the new totals.
View tool JSON
{
"name": "applyCoupon",
"kind": "act",
"impl": "imperative",
"description": "Apply a discount/voucher code to the cart. Returns whether it was accepted with the new totals.",
"inputSchema": {
"type": "object",
"properties": {
"code": {
"type": "string",
"minLength": 1,
"maxLength": 64
}
},
"required": [
"code"
],
"additionalProperties": false
}
}initiateCheckoutSensitive Action
Prepare checkout and return the secure checkout URL for the human user to review and complete payment. NEVER processes payment.
View tool JSON
{
"name": "initiateCheckout",
"kind": "transact",
"impl": "imperative",
"description": "Prepare checkout and return the secure checkout URL for the human user to review and complete payment. NEVER processes payment.",
"inputSchema": {
"type": "object",
"properties": {},
"additionalProperties": false
}
}searchProductsAnswer
Search the store catalog by keyword and show matching products.
View tool JSON
{
"name": "searchProducts",
"kind": "answer",
"impl": "declarative",
"description": "Search the store catalog by keyword and show matching products.",
"inputSchema": {
"type": "object",
"properties": {
"s": {
"type": "string"
}
}
}
}