MCP-Server
SendaMeal Storefront
com.sendameal/storefront
Was dieses MCP kann
Searches a gift-meal catalog, manages a shopping cart, and creates checkout links for guest purchases.
Funktionen
Tools
6
Tools
add_item_to_cart
Add one or more items to the shopping cart.
If no cart exists, this tool makes a new cart. This tool adds products and gift
certificates.
Steps
1. Call the 'search_products' tool to find a product.
2. Call the 'get_product_details' tool to get the variants and the modifier options.
3. Call this tool to add the item.
4. Call the 'create_checkout_url' tool to get a checkout URL.
Rules
Send 'quantity' and 'productEntityId' for each item.
If the product has variants, send 'variantEntityId'.
Modifier options
A modifier option is a product choice that is not a variant.
Examples are an engraving message and a nicotine strength.
The 'get_product_details' tool returns these options in 'modifierOptions'.
If the product has no 'modifierOptions', do not send 'selectedOptions'.
Do not send a variant option in 'selectedOptions'.
Send a variant in 'variantEntityId'.
An option is required if 'isRequired' is 'true'.
Send each required option.
If you do not send a required option, the server does not add the item.
To send an option:
1. Read the bucket name from 'selectedOptionsKey'.
2. Add the option to 'item.selectedOptions' in that bucket.
3. Send the 'optionEntityId' of the option.
4. For a choice option, send the 'valueEntityId' of the value that the user selected.
Send only the buckets that you need.
Example. A required choice option has a 'selectedOptionsKey' of "multipleChoices", an
'optionEntityId' of 108, and a selected value with a 'valueEntityId' of 251:
{
"item": {
"quantity": 1,
"productEntityId": 88,
"variantEntityId": 67,
"selectedOptions": {
"multipleChoices": [ { "optionEntityId": 108, "optionValueEntityId": 251 } ]
}
}
}
A free-entry bucket takes a typed value in place of an ID.
'textFields' and 'multiLineTextFields' take "text".
'numberFields' takes "number".
'dateFields' takes "date".
Obey the 'constraints' of the option.
If a required option has more than one value, ask the user to select one value.
Do not select a value yourself. Do not use the default value.
If 'unsupported' is 'true', you cannot send the option.
If such an option is also required, tell the user to buy the product on the website.
Eingabeschema
{'type': 'object', 'required': ['item'], 'properties': {'item': {'type': 'object', 'required': ['quantity', 'productEntityId', 'variantEntityId'], 'properties': {'quantity': {'type': 'integer'}, 'productEntityId': {'type': 'integer'}, 'selectedOptions': {'type': ['null', 'object'], 'properties': {'checkboxes': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['optionEntityId', 'optionValueEntityId'], 'properties': {'optionEntityId': {'type': 'integer'}, 'optionValueEntityId': {'type': 'integer'}}, 'additionalProperties': False}}, 'dateFields': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['optionEntityId', 'date'], 'properties': {'date': {'type': 'string'}, 'optionEntityId': {'type': 'integer'}}, 'additionalProperties': False}}, 'textFields': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['optionEntityId', 'text'], 'properties': {'text': {'type': 'string'}, 'optionEntityId': {'type': 'integer'}}, 'additionalProperties': False}}, 'numberFields': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['optionEntityId', 'number'], 'properties': {'number': {'type': 'number'}, 'optionEntityId': {'type': 'integer'}}, 'additionalProperties': False}}, 'multipleChoices': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['optionEntityId', 'optionValueEntityId'], 'properties': {'optionEntityId': {'type': 'integer'}, 'optionValueEntityId': {'type': 'integer'}}, 'additionalProperties': False}}, 'multiLineTextFields': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['optionEntityId', 'text'], 'properties': {'text': {'type': 'string'}, 'optionEntityId': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'variantEntityId': {'type': ['null', 'integer']}}, 'additionalProperties': False}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['success', 'cart'], 'properties': {'cart': {'type': ['null', 'object'], 'required': ['currencyCode', 'displayCurrencyCode', 'isTaxIncluded', 'locale', 'version', 'baseAmount', 'baseAmountInDisplayCurrency', 'discountedAmount', 'discountedAmountInDisplayCurrency', 'amount', 'amountInDisplayCurrency', 'discounts', 'lineItems', 'createdAt', 'updatedAt'], 'properties': {'amount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'locale': {'type': 'string'}, 'version': {'type': ['null', 'integer']}, 'createdAt': {'type': 'object', 'required': ['utc'], 'properties': {'utc': {'type': 'string'}}, 'additionalProperties': False}, 'discounts': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'discountedAmount', 'discountedAmountInDisplayCurrency'], 'properties': {'entityId': {'type': 'string'}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'lineItems': {'type': 'object', 'required': ['totalQuantity', 'physicalItems', 'digitalItems', 'giftCertificates', 'customItems'], 'properties': {'customItems': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'sku', 'name', 'quantity', 'listPrice', 'listPriceInDisplayCurrency', 'extendedListPrice', 'extendedListPriceInDisplayCurrency'], 'properties': {'sku': {'type': ['null', 'string']}, 'name': {'type': 'string'}, 'entityId': {'type': 'string'}, 'quantity': {'type': 'integer'}, 'listPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'listPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'digitalItems': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'parentEntityId', 'productEntityId', 'variantEntityId', 'sku', 'name', 'brand', 'quantity', 'isTaxable', 'path', 'discounts', 'discountedAmount', 'discountedAmountInDisplayCurrency', 'couponAmount', 'couponAmountInDisplayCurrency', 'listPrice', 'listPriceInDisplayCurrency', 'originalPrice', 'originalPriceInDisplayCurrency', 'salePrice', 'salePriceInDisplayCurrency', 'extendedListPrice', 'extendedListPriceInDisplayCurrency', 'extendedSalePrice', 'extendedSalePriceInDisplayCurrency', 'image'], 'properties': {'sku': {'type': ['null', 'string']}, 'name': {'type': 'string'}, 'path': {'type': 'string'}, 'brand': {'type': ['null', 'string']}, 'image': {'type': ['null', 'object'], 'required': ['urlOriginal', 'urlTemplate', 'altText', 'isDefault'], 'properties': {'altText': {'type': 'string'}, 'isDefault': {'type': 'boolean'}, 'urlOriginal': {'type': 'string'}, 'urlTemplate': {'type': 'string'}}, 'additionalProperties': False}, 'entityId': {'type': 'string'}, 'quantity': {'type': 'integer'}, 'discounts': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'discountedAmount', 'discountedAmountInDisplayCurrency'], 'properties': {'entityId': {'type': 'string'}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'isTaxable': {'type': 'boolean'}, 'listPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'salePrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'couponAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'originalPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'parentEntityId': {'type': ['null', 'string']}, 'productEntityId': {'type': 'integer'}, 'selectedOptions': {'type': 'array', 'items': {'oneOf': [{'type': 'object', 'required': ['entityId', 'name', '__typename', 'value', 'valueEntityId', '__typename'], 'properties': {'name': {'type': 'string'}, 'value': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedCheckboxOption'}, 'valueEntityId': {'type': 'integer'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'date', '__typename'], 'properties': {'date': {'type': 'object', 'required': ['utc'], 'properties': {'utc': {'type': 'string'}}, 'additionalProperties': False}, 'name': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedDateFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'fileName', '__typename'], 'properties': {'name': {'type': 'string'}, 'entityId': {'type': 'integer'}, 'fileName': {'type': 'string'}, '__typename': {'type': 'string', 'const': 'CartSelectedFileUploadOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'text', '__typename'], 'properties': {'name': {'type': 'string'}, 'text': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedMultiLineTextFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'value', 'valueEntityId', '__typename'], 'properties': {'name': {'type': 'string'}, 'value': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedMultipleChoiceOption'}, 'valueEntityId': {'type': 'integer'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'number', '__typename'], 'properties': {'name': {'type': 'string'}, 'number': {'type': 'number'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedNumberFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'text', '__typename'], 'properties': {'name': {'type': 'string'}, 'text': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedTextFieldOption'}}, 'additionalProperties': False}]}}, 'variantEntityId': {'type': ['null', 'integer']}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedSalePrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'listPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'salePriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'couponAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'originalPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedSalePriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'physicalItems': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'parentEntityId', 'productEntityId', 'variantEntityId', 'sku', 'name', 'brand', 'quantity', 'isTaxable', 'isShippingRequired', 'path', 'discounts', 'discountedAmount', 'discountedAmountInDisplayCurrency', 'couponAmount', 'couponAmountInDisplayCurrency', 'listPrice', 'listPriceInDisplayCurrency', 'originalPrice', 'originalPriceInDisplayCurrency', 'salePrice', 'salePriceInDisplayCurrency', 'extendedListPrice', 'extendedListPriceInDisplayCurrency', 'extendedSalePrice', 'extendedSalePriceInDisplayCurrency', 'giftWrapping', 'image'], 'properties': {'sku': {'type': ['null', 'string']}, 'name': {'type': 'string'}, 'path': {'type': 'string'}, 'brand': {'type': ['null', 'string']}, 'image': {'type': ['null', 'object'], 'required': ['urlOriginal', 'urlTemplate', 'altText', 'isDefault'], 'properties': {'altText': {'type': 'string'}, 'isDefault': {'type': 'boolean'}, 'urlOriginal': {'type': 'string'}, 'urlTemplate': {'type': 'string'}}, 'additionalProperties': False}, 'entityId': {'type': 'string'}, 'quantity': {'type': 'integer'}, 'discounts': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'discountedAmount', 'discountedAmountInDisplayCurrency'], 'properties': {'entityId': {'type': 'string'}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'isTaxable': {'type': 'boolean'}, 'listPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'salePrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'couponAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'giftWrapping': {'type': ['null', 'object'], 'required': ['name', 'message', 'amount', 'amountInDisplayCurrency'], 'properties': {'name': {'type': 'string'}, 'amount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'message': {'type': ['null', 'string']}, 'amountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'originalPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'parentEntityId': {'type': ['null', 'string']}, 'productEntityId': {'type': 'integer'}, 'selectedOptions': {'type': 'array', 'items': {'oneOf': [{'type': 'object', 'required': ['entityId', 'name', '__typename', 'value', 'valueEntityId', '__typename'], 'properties': {'name': {'type': 'string'}, 'value': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedCheckboxOption'}, 'valueEntityId': {'type': 'integer'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'date', '__typename'], 'properties': {'date': {'type': 'object', 'required': ['utc'], 'properties': {'utc': {'type': 'string'}}, 'additionalProperties': False}, 'name': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedDateFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'fileName', '__typename'], 'properties': {'name': {'type': 'string'}, 'entityId': {'type': 'integer'}, 'fileName': {'type': 'string'}, '__typename': {'type': 'string', 'const': 'CartSelectedFileUploadOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'text', '__typename'], 'properties': {'name': {'type': 'string'}, 'text': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedMultiLineTextFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'value', 'valueEntityId', '__typename'], 'properties': {'name': {'type': 'string'}, 'value': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedMultipleChoiceOption'}, 'valueEntityId': {'type': 'integer'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'number', '__typename'], 'properties': {'name': {'type': 'string'}, 'number': {'type': 'number'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedNumberFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'text', '__typename'], 'properties': {'name': {'type': 'string'}, 'text': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedTextFieldOption'}}, 'additionalProperties': False}]}}, 'variantEntityId': {'type': ['null', 'integer']}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedSalePrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'isShippingRequired': {'type': 'boolean'}, 'listPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'salePriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'couponAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'originalPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedSalePriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'totalQuantity': {'type': 'integer'}, 'giftCertificates': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'name', 'theme', 'isTaxable', 'message', 'amount', 'amountInDisplayCurrency', 'sender', 'recipient'], 'properties': {'name': {'type': 'string'}, 'theme': {'type': 'string'}, 'amount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'sender': {'type': 'object', 'required': ['name', 'email'], 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string'}}, 'additionalProperties': False}, 'message': {'type': ['null', 'string']}, 'entityId': {'type': 'string'}, 'isTaxable': {'type': 'boolean'}, 'recipient': {'type': 'object', 'required': ['name', 'email'], 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string'}}, 'additionalProperties': False}, 'amountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'updatedAt': {'type': 'object', 'required': ['utc'], 'properties': {'utc': {'type': 'string'}}, 'additionalProperties': False}, 'baseAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'currencyCode': {'type': 'string'}, 'isTaxIncluded': {'type': 'boolean'}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'displayCurrencyCode': {'type': 'string'}, 'amountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'baseAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'message': {'type': 'string'}, 'success': {'type': 'boolean'}}, 'additionalProperties': False}
create_checkout_url
CreateResult a checkout URL for a cart assigned to a current session
Arguments:
None, but requires a cart to be present in the current session.
Returns:
- checkoutURL - the URL to redirect the user to for checkout
- errors - any errors encountered during the process (like, cart not found, etc.)
Flow:
- Call 'manage_cart' with 'create_cart' operation to create a new cart.
- Call this tool to create a checkout URL for the cart assigned to the current session.
Eingabeschema
{'type': 'object', 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['success'], 'properties': {'message': {'type': 'string'}, 'success': {'type': 'boolean'}, 'checkoutURL': {'type': ['null', 'string']}}, 'additionalProperties': False}
get_product_details
Get the details of one or more products. The details are the variants, the options, and
the images.
Arguments
productIds - The list of product IDs. Get these IDs from the 'search_products' tool.
Request only the products that the user needs.
The server has a maximum count of IDs. The default maximum is 20.
If you send too many IDs, the server returns an error. Then send fewer IDs.
option_values - The option IDs and the value IDs of one variant.
Use this argument with one product ID only. This argument applies to the B2C catalog.
For a B2B buyer, the tool returns all the variants. Then select one variant.
channelId - Optional. This argument selects the B2B catalog.
The default is the channel of the request.
variantCursor - Optional. This argument gets the next page of variants.
Use this argument with one product ID only.
Take the value from 'nextVariantCursor' in the previous result.
If 'nextVariantCursor' is absent, or is null, or is the text "null", do not send this
argument.
Results
The tool returns a list of products in 'products'. The output schema gives all the
fields.
A product has 'modifierOptions' only if the product has modifier options.
A variant has a price, an inventory level, a purchase flag, and bulk prices only for a
B2B buyer.
If the tool does not find a product, the list does not include that product.
Modifier options
A modifier option is a product choice that is not a variant.
Examples are an engraving message and a gift note.
A variant option is never a modifier option.
If a product has no 'modifierOptions', add the product to the cart without
'selectedOptions'.
An option is required if 'isRequired' is 'true'.
Send each required option to the 'add_item_to_cart' tool.
If you do not send a required option, the server does not add the item.
A variant selection does not replace a required option.
Each option has 'optionEntityId', 'displayName', and 'selectedOptionsKey'.
'selectedOptionsKey' is the name of the field to send the option in.
A choice option has 'values'. Each value has 'valueEntityId' and 'label'.
A free-entry option has 'constraints' in place of 'values'.
If 'unsupported' is 'true', you cannot send the option. A file upload is one example.
If such an option is also required, tell the user to buy the product on the website.
Variant pages
The list of variants can be one page of a longer list. The server sets the page size.
If 'hasMoreVariants' is 'true', more variants exist than the tool returned.
Then do not tell the user that a variant does not exist. You did not receive all the
variants.
To get the next page, call this tool again. Send the same product ID, and only that
product ID. Send 'variantCursor' with the value of 'nextVariantCursor'.
A filter is better than a page walk. If the user named the variant, send 'option_values'
instead. One filtered call is cheaper than many pages.
Do not change 'option_values' between pages. The cursor is a position in the list of the
previous call. A different filter gives the wrong variants.
Stock
Each product has 'inStock'. It tells you if the store has units in stock.
It does not tell you if the user can buy the product.
If 'inStock' is 'false', do not refuse the request.
Many stores accept orders for products that are not in stock.
Tell the user that the product is not in stock, and that delivery can take more time.
Then add the product if the user agrees.
If the store blocks the purchase, the 'add_item_to_cart' tool fails and gives a reason.
Give that reason to the user.
If 'inStock' is 'true', the store reports no out-of-stock condition.
A store that does not count stock reports 'true' for all products.
Therefore do not tell the user a quantity.
'inventoryLevel' is present only if the store publishes stock counts.
If 'inventoryLevel' is absent, the count is unknown. The count is not zero.
Each variant has its own 'inStock'. Use the value of the variant if you add one variant.
Steps
1. Call the 'search_products' tool to get the product IDs.
2. Call this tool with the product IDs.
3. Call the 'add_item_to_cart' tool with the results of step 1 and step 2.
If a product has variants, you must tell the 'add_item_to_cart' tool which variant to
add.
If a product has required modifier options, you must send those options.
Eingabeschema
{'type': 'object', 'required': ['productIds'], 'properties': {'channelId': {'type': ['null', 'integer']}, 'productIds': {'type': ['null', 'array'], 'items': {'type': 'integer'}}, 'option_values': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['optionEntityId', 'valueEntityId'], 'properties': {'valueEntityId': {'type': 'integer'}, 'optionEntityId': {'type': 'integer'}}, 'additionalProperties': False}}, 'variantCursor': {'type': ['null', 'string']}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['success', 'products', 'totalCount'], 'properties': {'message': {'type': 'string'}, 'success': {'type': 'boolean'}, 'products': {'type': ['null', 'array'], 'items': {'type': 'object', 'properties': {'id': {'type': 'integer'}, 'sku': {'type': 'string'}, 'name': {'type': 'string'}, 'images': {'type': ['null', 'array'], 'items': {'type': 'string'}}, 'inStock': {'type': ['null', 'boolean']}, 'variants': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'SKU'], 'properties': {'SKU': {'type': 'string'}, 'price': {'type': ['null', 'number']}, 'inStock': {'type': ['null', 'boolean']}, 'options': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['optionId', 'optionLabel', 'valueId', 'valueLabel'], 'properties': {'valueId': {'type': 'integer'}, 'optionId': {'type': 'integer'}, 'valueLabel': {'type': 'string'}, 'optionLabel': {'type': 'string'}}, 'additionalProperties': False}}, 'entityId': {'type': 'integer'}, 'bulkPricing': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['minQty', 'price'], 'properties': {'price': {'type': 'number'}, 'maxQty': {'type': ['null', 'integer']}, 'minQty': {'type': 'integer'}}, 'additionalProperties': False}}, 'purchaseable': {'type': ['null', 'boolean']}, 'inventoryLevel': {'type': ['null', 'integer']}}, 'additionalProperties': False}}, 'productUrl': {'type': 'string'}, 'availability': {'type': 'string'}, 'currencyCode': {'type': 'string'}, 'isPriceHidden': {'type': 'boolean'}, 'hasMoreVariants': {'type': 'boolean'}, 'modifierOptions': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['optionEntityId', 'displayName', 'isRequired'], 'properties': {'values': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['valueEntityId', 'label'], 'properties': {'label': {'type': 'string'}, 'isDefault': {'type': 'boolean'}, 'valueEntityId': {'type': 'integer'}}, 'additionalProperties': False}}, 'isRequired': {'type': 'boolean'}, 'constraints': {'type': ['null', 'object'], 'properties': {'latest': {'type': 'string'}, 'lowest': {'type': ['null', 'number']}, 'highest': {'type': ['null', 'number']}, 'earliest': {'type': 'string'}, 'maxLines': {'type': ['null', 'integer']}, 'maxLength': {'type': ['null', 'integer']}, 'minLength': {'type': ['null', 'integer']}, 'isIntegerOnly': {'type': 'boolean'}}, 'additionalProperties': False}, 'displayName': {'type': 'string'}, 'unsupported': {'type': 'boolean'}, 'optionEntityId': {'type': 'integer'}, 'selectedOptionsKey': {'type': 'string'}}, 'additionalProperties': False}}, 'inventoryTracking': {'type': 'string'}, 'nextVariantCursor': {'type': 'string'}, 'orderQuantityMaximum': {'type': 'integer'}, 'orderQuantityMinimum': {'type': 'integer'}}, 'additionalProperties': False}}, 'totalCount': {'type': 'integer'}}, 'additionalProperties': False}
remove_item_from_cart
Remove specific items from your shopping cart.
It is removing the item completly from the cart.
If you want to reduce quantity of the items use 'update_cart_item'
Remove unwanted items from your shopping cart by targeting specific item IDs. This tool provides precise control over cart cleanup and item removal.
Use this tool when customers want to:
-Remove specific products they no longer want
-Delete gift certificates from their cart
-Clean up their cart before checkout
-Remove items added by mistake
Features:
- Target removal by specific item ID
- Works with both products and gift certificates
- Maintains cart structure after removal
- Immediate cart updates
Flow:
- Call 'search_products' tool to find products by search term.
- Call 'get_product_details' tool to get product variants and images.
- Call 'add_item_to_cart' tool to create new cart with item
- Call 'add_item_to_cart' tool to add another item to cart
- Call 'remove_item_from_cart' tool to remove added item to cart
- Call 'create_checkout_url' tool to generate a checkout URL for the cart.
Requires an existing cart with items to remove.
Eingabeschema
{'type': 'object', 'required': ['item_id'], 'properties': {'item_id': {'type': 'string'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['success', 'cart'], 'properties': {'cart': {'type': ['null', 'object'], 'required': ['currencyCode', 'displayCurrencyCode', 'isTaxIncluded', 'locale', 'version', 'baseAmount', 'baseAmountInDisplayCurrency', 'discountedAmount', 'discountedAmountInDisplayCurrency', 'amount', 'amountInDisplayCurrency', 'discounts', 'lineItems', 'createdAt', 'updatedAt'], 'properties': {'amount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'locale': {'type': 'string'}, 'version': {'type': ['null', 'integer']}, 'createdAt': {'type': 'object', 'required': ['utc'], 'properties': {'utc': {'type': 'string'}}, 'additionalProperties': False}, 'discounts': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'discountedAmount', 'discountedAmountInDisplayCurrency'], 'properties': {'entityId': {'type': 'string'}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'lineItems': {'type': 'object', 'required': ['totalQuantity', 'physicalItems', 'digitalItems', 'giftCertificates', 'customItems'], 'properties': {'customItems': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'sku', 'name', 'quantity', 'listPrice', 'listPriceInDisplayCurrency', 'extendedListPrice', 'extendedListPriceInDisplayCurrency'], 'properties': {'sku': {'type': ['null', 'string']}, 'name': {'type': 'string'}, 'entityId': {'type': 'string'}, 'quantity': {'type': 'integer'}, 'listPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'listPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'digitalItems': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'parentEntityId', 'productEntityId', 'variantEntityId', 'sku', 'name', 'brand', 'quantity', 'isTaxable', 'path', 'discounts', 'discountedAmount', 'discountedAmountInDisplayCurrency', 'couponAmount', 'couponAmountInDisplayCurrency', 'listPrice', 'listPriceInDisplayCurrency', 'originalPrice', 'originalPriceInDisplayCurrency', 'salePrice', 'salePriceInDisplayCurrency', 'extendedListPrice', 'extendedListPriceInDisplayCurrency', 'extendedSalePrice', 'extendedSalePriceInDisplayCurrency', 'image'], 'properties': {'sku': {'type': ['null', 'string']}, 'name': {'type': 'string'}, 'path': {'type': 'string'}, 'brand': {'type': ['null', 'string']}, 'image': {'type': ['null', 'object'], 'required': ['urlOriginal', 'urlTemplate', 'altText', 'isDefault'], 'properties': {'altText': {'type': 'string'}, 'isDefault': {'type': 'boolean'}, 'urlOriginal': {'type': 'string'}, 'urlTemplate': {'type': 'string'}}, 'additionalProperties': False}, 'entityId': {'type': 'string'}, 'quantity': {'type': 'integer'}, 'discounts': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'discountedAmount', 'discountedAmountInDisplayCurrency'], 'properties': {'entityId': {'type': 'string'}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'isTaxable': {'type': 'boolean'}, 'listPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'salePrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'couponAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'originalPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'parentEntityId': {'type': ['null', 'string']}, 'productEntityId': {'type': 'integer'}, 'selectedOptions': {'type': 'array', 'items': {'oneOf': [{'type': 'object', 'required': ['entityId', 'name', '__typename', 'value', 'valueEntityId', '__typename'], 'properties': {'name': {'type': 'string'}, 'value': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedCheckboxOption'}, 'valueEntityId': {'type': 'integer'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'date', '__typename'], 'properties': {'date': {'type': 'object', 'required': ['utc'], 'properties': {'utc': {'type': 'string'}}, 'additionalProperties': False}, 'name': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedDateFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'fileName', '__typename'], 'properties': {'name': {'type': 'string'}, 'entityId': {'type': 'integer'}, 'fileName': {'type': 'string'}, '__typename': {'type': 'string', 'const': 'CartSelectedFileUploadOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'text', '__typename'], 'properties': {'name': {'type': 'string'}, 'text': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedMultiLineTextFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'value', 'valueEntityId', '__typename'], 'properties': {'name': {'type': 'string'}, 'value': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedMultipleChoiceOption'}, 'valueEntityId': {'type': 'integer'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'number', '__typename'], 'properties': {'name': {'type': 'string'}, 'number': {'type': 'number'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedNumberFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'text', '__typename'], 'properties': {'name': {'type': 'string'}, 'text': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedTextFieldOption'}}, 'additionalProperties': False}]}}, 'variantEntityId': {'type': ['null', 'integer']}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedSalePrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'listPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'salePriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'couponAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'originalPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedSalePriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'physicalItems': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'parentEntityId', 'productEntityId', 'variantEntityId', 'sku', 'name', 'brand', 'quantity', 'isTaxable', 'isShippingRequired', 'path', 'discounts', 'discountedAmount', 'discountedAmountInDisplayCurrency', 'couponAmount', 'couponAmountInDisplayCurrency', 'listPrice', 'listPriceInDisplayCurrency', 'originalPrice', 'originalPriceInDisplayCurrency', 'salePrice', 'salePriceInDisplayCurrency', 'extendedListPrice', 'extendedListPriceInDisplayCurrency', 'extendedSalePrice', 'extendedSalePriceInDisplayCurrency', 'giftWrapping', 'image'], 'properties': {'sku': {'type': ['null', 'string']}, 'name': {'type': 'string'}, 'path': {'type': 'string'}, 'brand': {'type': ['null', 'string']}, 'image': {'type': ['null', 'object'], 'required': ['urlOriginal', 'urlTemplate', 'altText', 'isDefault'], 'properties': {'altText': {'type': 'string'}, 'isDefault': {'type': 'boolean'}, 'urlOriginal': {'type': 'string'}, 'urlTemplate': {'type': 'string'}}, 'additionalProperties': False}, 'entityId': {'type': 'string'}, 'quantity': {'type': 'integer'}, 'discounts': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'discountedAmount', 'discountedAmountInDisplayCurrency'], 'properties': {'entityId': {'type': 'string'}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'isTaxable': {'type': 'boolean'}, 'listPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'salePrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'couponAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'giftWrapping': {'type': ['null', 'object'], 'required': ['name', 'message', 'amount', 'amountInDisplayCurrency'], 'properties': {'name': {'type': 'string'}, 'amount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'message': {'type': ['null', 'string']}, 'amountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'originalPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'parentEntityId': {'type': ['null', 'string']}, 'productEntityId': {'type': 'integer'}, 'selectedOptions': {'type': 'array', 'items': {'oneOf': [{'type': 'object', 'required': ['entityId', 'name', '__typename', 'value', 'valueEntityId', '__typename'], 'properties': {'name': {'type': 'string'}, 'value': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedCheckboxOption'}, 'valueEntityId': {'type': 'integer'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'date', '__typename'], 'properties': {'date': {'type': 'object', 'required': ['utc'], 'properties': {'utc': {'type': 'string'}}, 'additionalProperties': False}, 'name': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedDateFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'fileName', '__typename'], 'properties': {'name': {'type': 'string'}, 'entityId': {'type': 'integer'}, 'fileName': {'type': 'string'}, '__typename': {'type': 'string', 'const': 'CartSelectedFileUploadOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'text', '__typename'], 'properties': {'name': {'type': 'string'}, 'text': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedMultiLineTextFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'value', 'valueEntityId', '__typename'], 'properties': {'name': {'type': 'string'}, 'value': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedMultipleChoiceOption'}, 'valueEntityId': {'type': 'integer'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'number', '__typename'], 'properties': {'name': {'type': 'string'}, 'number': {'type': 'number'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedNumberFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'text', '__typename'], 'properties': {'name': {'type': 'string'}, 'text': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedTextFieldOption'}}, 'additionalProperties': False}]}}, 'variantEntityId': {'type': ['null', 'integer']}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedSalePrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'isShippingRequired': {'type': 'boolean'}, 'listPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'salePriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'couponAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'originalPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedSalePriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'totalQuantity': {'type': 'integer'}, 'giftCertificates': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'name', 'theme', 'isTaxable', 'message', 'amount', 'amountInDisplayCurrency', 'sender', 'recipient'], 'properties': {'name': {'type': 'string'}, 'theme': {'type': 'string'}, 'amount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'sender': {'type': 'object', 'required': ['name', 'email'], 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string'}}, 'additionalProperties': False}, 'message': {'type': ['null', 'string']}, 'entityId': {'type': 'string'}, 'isTaxable': {'type': 'boolean'}, 'recipient': {'type': 'object', 'required': ['name', 'email'], 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string'}}, 'additionalProperties': False}, 'amountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'updatedAt': {'type': 'object', 'required': ['utc'], 'properties': {'utc': {'type': 'string'}}, 'additionalProperties': False}, 'baseAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'currencyCode': {'type': 'string'}, 'isTaxIncluded': {'type': 'boolean'}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'displayCurrencyCode': {'type': 'string'}, 'amountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'baseAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'message': {'type': 'string'}, 'success': {'type': 'boolean'}}, 'additionalProperties': False}
search_products
Search products by a term
Arguments:
term - the search term to look for products. It should be at least 3 characters long.
cursor - optional, used for pagination. If provided, it will return the next page of results after.
Pagination:
Supports pagination with 'cursor' arguments. If 'cursor' is not provided, it will return the first page of results.
Value for 'cursor' can be obtained from the 'nextCursor' field in the response. If 'nextCursor' is null, it means there are no more results to fetch.
If value of cursor is null (or a string representation of 'null') dont send it in the payload.
Results:
Each product includes 'requiresFileUpload'. When true, the product has a required file-upload
option (e.g. "upload your design") and shouldn't be added to cart through this assistant. Do not
attempt to purchase it â tell the user it must be ordered on the website.
Stock:
Each product carries 'inStock'. It reports whether the store has units on hand. It does NOT
report whether the item can be bought.
- false does NOT mean the purchase will fail. Many stores accept orders for out-of-stock
items - backorder, pre-order, or made-to-order goods that are fabricated after ordering.
Whether a given store does is not exposed by this API.
So: tell the user the item is out of stock and may take longer to arrive, then ADD IT if
they still want it. Do not refuse on 'inStock: false' alone.
- If the store really does block it, 'add_item_to_cart' fails and returns the reason. Relay
that reason to the user. Attempting the add is the only reliable way to find out.
- true only means no out-of-stock condition is reported. A store that does not track inventory
reports true for every product, so never state or imply a quantity.
- 'inventoryLevel' appears only on stores that publish stock figures; absent means undisclosed,
not zero.
Flow:
- Call this tool with a 'term' argument and optionally with 'cursor' to search for products.
- if you find a matching product, call 'get_product_details' with the product ID to get its
variants and options (if any).
- if 'requiresFileUpload' is true, inform the user the product needs a file upload and cannot
be purchased here.
- Call 'add_item_to_cart' with results of 'search_products' and 'get_product_details' (variant) tools to add the product to the cart.
- [IMPORTANT] If product has variants ask user to pick
Eingabeschema
{'type': 'object', 'required': ['term'], 'properties': {'term': {'type': 'string'}, 'cursor': {'type': ['null', 'string']}, 'context': {'type': ['null', 'string'], 'description': 'Additional information about the request such as user demographics, mood, location, or other relevant details that could help in tailoring the response appropriately. Should not contains PII.'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['success', 'products'], 'properties': {'message': {'type': 'string'}, 'success': {'type': 'boolean'}, 'products': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['id', 'name', 'sku', 'hasBulkPricing', 'isPriceHidden'], 'properties': {'id': {'type': 'integer'}, 'sku': {'type': 'string'}, 'name': {'type': 'string'}, 'inStock': {'type': ['null', 'boolean']}, 'imageUrl': {'type': 'string'}, 'priceRange': {'type': ['null', 'object'], 'required': ['min', 'max'], 'properties': {'max': {'type': 'number'}, 'min': {'type': 'number'}}, 'additionalProperties': False}, 'productUrl': {'type': 'string'}, 'availability': {'type': 'string'}, 'currencyCode': {'type': 'string'}, 'variantCount': {'type': 'integer'}, 'isPriceHidden': {'type': 'boolean'}, 'hasBulkPricing': {'type': 'boolean'}, 'inventoryLevel': {'type': ['null', 'integer']}, 'inventoryTracking': {'type': 'string'}, 'requiresFileUpload': {'type': 'boolean'}, 'orderQuantityMaximum': {'type': 'integer'}, 'orderQuantityMinimum': {'type': 'integer'}}, 'additionalProperties': False}}, 'nextCursor': {'type': 'string'}}, 'additionalProperties': False}
update_cart_item
Change an item that is already in the shopping cart.
Use this tool to change the quantity, the variant, or the modifier options of one cart
item. A cart must exist and must have items.
Steps
1. Call the 'add_item_to_cart' tool to put an item in the cart.
2. Call this tool to change the item.
3. Call the 'create_checkout_url' tool to get a checkout URL.
Rules
Send 'line_item_id' to select the cart item to change.
Send 'quantity' and 'productEntityId' in 'item'.
If the product has variants, send 'variantEntityId'.
Modifier options
'item.selectedOptions' works as it works in the 'add_item_to_cart' tool.
The 'get_product_details' tool returns these options in 'modifierOptions'.
If the product has required modifier options, send them again in this request.
If you do not send them, the server does not change the item.
Send only the buckets that you need.
Eingabeschema
{'type': 'object', 'required': ['line_item_id', 'item'], 'properties': {'item': {'type': 'object', 'required': ['quantity', 'productEntityId', 'variantEntityId'], 'properties': {'quantity': {'type': 'integer'}, 'productEntityId': {'type': 'integer'}, 'selectedOptions': {'type': ['null', 'object'], 'properties': {'checkboxes': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['optionEntityId', 'optionValueEntityId'], 'properties': {'optionEntityId': {'type': 'integer'}, 'optionValueEntityId': {'type': 'integer'}}, 'additionalProperties': False}}, 'dateFields': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['optionEntityId', 'date'], 'properties': {'date': {'type': 'string'}, 'optionEntityId': {'type': 'integer'}}, 'additionalProperties': False}}, 'textFields': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['optionEntityId', 'text'], 'properties': {'text': {'type': 'string'}, 'optionEntityId': {'type': 'integer'}}, 'additionalProperties': False}}, 'numberFields': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['optionEntityId', 'number'], 'properties': {'number': {'type': 'number'}, 'optionEntityId': {'type': 'integer'}}, 'additionalProperties': False}}, 'multipleChoices': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['optionEntityId', 'optionValueEntityId'], 'properties': {'optionEntityId': {'type': 'integer'}, 'optionValueEntityId': {'type': 'integer'}}, 'additionalProperties': False}}, 'multiLineTextFields': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['optionEntityId', 'text'], 'properties': {'text': {'type': 'string'}, 'optionEntityId': {'type': 'integer'}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'variantEntityId': {'type': ['null', 'integer']}}, 'additionalProperties': False}, 'line_item_id': {'type': 'string'}}, 'additionalProperties': False}
Ausgabeschema
{'type': 'object', 'required': ['success', 'cart'], 'properties': {'cart': {'type': ['null', 'object'], 'required': ['currencyCode', 'displayCurrencyCode', 'isTaxIncluded', 'locale', 'version', 'baseAmount', 'baseAmountInDisplayCurrency', 'discountedAmount', 'discountedAmountInDisplayCurrency', 'amount', 'amountInDisplayCurrency', 'discounts', 'lineItems', 'createdAt', 'updatedAt'], 'properties': {'amount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'locale': {'type': 'string'}, 'version': {'type': ['null', 'integer']}, 'createdAt': {'type': 'object', 'required': ['utc'], 'properties': {'utc': {'type': 'string'}}, 'additionalProperties': False}, 'discounts': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'discountedAmount', 'discountedAmountInDisplayCurrency'], 'properties': {'entityId': {'type': 'string'}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'lineItems': {'type': 'object', 'required': ['totalQuantity', 'physicalItems', 'digitalItems', 'giftCertificates', 'customItems'], 'properties': {'customItems': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'sku', 'name', 'quantity', 'listPrice', 'listPriceInDisplayCurrency', 'extendedListPrice', 'extendedListPriceInDisplayCurrency'], 'properties': {'sku': {'type': ['null', 'string']}, 'name': {'type': 'string'}, 'entityId': {'type': 'string'}, 'quantity': {'type': 'integer'}, 'listPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'listPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'digitalItems': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'parentEntityId', 'productEntityId', 'variantEntityId', 'sku', 'name', 'brand', 'quantity', 'isTaxable', 'path', 'discounts', 'discountedAmount', 'discountedAmountInDisplayCurrency', 'couponAmount', 'couponAmountInDisplayCurrency', 'listPrice', 'listPriceInDisplayCurrency', 'originalPrice', 'originalPriceInDisplayCurrency', 'salePrice', 'salePriceInDisplayCurrency', 'extendedListPrice', 'extendedListPriceInDisplayCurrency', 'extendedSalePrice', 'extendedSalePriceInDisplayCurrency', 'image'], 'properties': {'sku': {'type': ['null', 'string']}, 'name': {'type': 'string'}, 'path': {'type': 'string'}, 'brand': {'type': ['null', 'string']}, 'image': {'type': ['null', 'object'], 'required': ['urlOriginal', 'urlTemplate', 'altText', 'isDefault'], 'properties': {'altText': {'type': 'string'}, 'isDefault': {'type': 'boolean'}, 'urlOriginal': {'type': 'string'}, 'urlTemplate': {'type': 'string'}}, 'additionalProperties': False}, 'entityId': {'type': 'string'}, 'quantity': {'type': 'integer'}, 'discounts': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'discountedAmount', 'discountedAmountInDisplayCurrency'], 'properties': {'entityId': {'type': 'string'}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'isTaxable': {'type': 'boolean'}, 'listPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'salePrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'couponAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'originalPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'parentEntityId': {'type': ['null', 'string']}, 'productEntityId': {'type': 'integer'}, 'selectedOptions': {'type': 'array', 'items': {'oneOf': [{'type': 'object', 'required': ['entityId', 'name', '__typename', 'value', 'valueEntityId', '__typename'], 'properties': {'name': {'type': 'string'}, 'value': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedCheckboxOption'}, 'valueEntityId': {'type': 'integer'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'date', '__typename'], 'properties': {'date': {'type': 'object', 'required': ['utc'], 'properties': {'utc': {'type': 'string'}}, 'additionalProperties': False}, 'name': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedDateFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'fileName', '__typename'], 'properties': {'name': {'type': 'string'}, 'entityId': {'type': 'integer'}, 'fileName': {'type': 'string'}, '__typename': {'type': 'string', 'const': 'CartSelectedFileUploadOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'text', '__typename'], 'properties': {'name': {'type': 'string'}, 'text': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedMultiLineTextFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'value', 'valueEntityId', '__typename'], 'properties': {'name': {'type': 'string'}, 'value': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedMultipleChoiceOption'}, 'valueEntityId': {'type': 'integer'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'number', '__typename'], 'properties': {'name': {'type': 'string'}, 'number': {'type': 'number'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedNumberFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'text', '__typename'], 'properties': {'name': {'type': 'string'}, 'text': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedTextFieldOption'}}, 'additionalProperties': False}]}}, 'variantEntityId': {'type': ['null', 'integer']}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedSalePrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'listPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'salePriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'couponAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'originalPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedSalePriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'physicalItems': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'parentEntityId', 'productEntityId', 'variantEntityId', 'sku', 'name', 'brand', 'quantity', 'isTaxable', 'isShippingRequired', 'path', 'discounts', 'discountedAmount', 'discountedAmountInDisplayCurrency', 'couponAmount', 'couponAmountInDisplayCurrency', 'listPrice', 'listPriceInDisplayCurrency', 'originalPrice', 'originalPriceInDisplayCurrency', 'salePrice', 'salePriceInDisplayCurrency', 'extendedListPrice', 'extendedListPriceInDisplayCurrency', 'extendedSalePrice', 'extendedSalePriceInDisplayCurrency', 'giftWrapping', 'image'], 'properties': {'sku': {'type': ['null', 'string']}, 'name': {'type': 'string'}, 'path': {'type': 'string'}, 'brand': {'type': ['null', 'string']}, 'image': {'type': ['null', 'object'], 'required': ['urlOriginal', 'urlTemplate', 'altText', 'isDefault'], 'properties': {'altText': {'type': 'string'}, 'isDefault': {'type': 'boolean'}, 'urlOriginal': {'type': 'string'}, 'urlTemplate': {'type': 'string'}}, 'additionalProperties': False}, 'entityId': {'type': 'string'}, 'quantity': {'type': 'integer'}, 'discounts': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'discountedAmount', 'discountedAmountInDisplayCurrency'], 'properties': {'entityId': {'type': 'string'}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'isTaxable': {'type': 'boolean'}, 'listPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'salePrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'couponAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'giftWrapping': {'type': ['null', 'object'], 'required': ['name', 'message', 'amount', 'amountInDisplayCurrency'], 'properties': {'name': {'type': 'string'}, 'amount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'message': {'type': ['null', 'string']}, 'amountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'originalPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'parentEntityId': {'type': ['null', 'string']}, 'productEntityId': {'type': 'integer'}, 'selectedOptions': {'type': 'array', 'items': {'oneOf': [{'type': 'object', 'required': ['entityId', 'name', '__typename', 'value', 'valueEntityId', '__typename'], 'properties': {'name': {'type': 'string'}, 'value': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedCheckboxOption'}, 'valueEntityId': {'type': 'integer'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'date', '__typename'], 'properties': {'date': {'type': 'object', 'required': ['utc'], 'properties': {'utc': {'type': 'string'}}, 'additionalProperties': False}, 'name': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedDateFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'fileName', '__typename'], 'properties': {'name': {'type': 'string'}, 'entityId': {'type': 'integer'}, 'fileName': {'type': 'string'}, '__typename': {'type': 'string', 'const': 'CartSelectedFileUploadOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'text', '__typename'], 'properties': {'name': {'type': 'string'}, 'text': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedMultiLineTextFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'value', 'valueEntityId', '__typename'], 'properties': {'name': {'type': 'string'}, 'value': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedMultipleChoiceOption'}, 'valueEntityId': {'type': 'integer'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'number', '__typename'], 'properties': {'name': {'type': 'string'}, 'number': {'type': 'number'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedNumberFieldOption'}}, 'additionalProperties': False}, {'type': 'object', 'required': ['entityId', 'name', '__typename', 'text', '__typename'], 'properties': {'name': {'type': 'string'}, 'text': {'type': 'string'}, 'entityId': {'type': 'integer'}, '__typename': {'type': 'string', 'const': 'CartSelectedTextFieldOption'}}, 'additionalProperties': False}]}}, 'variantEntityId': {'type': ['null', 'integer']}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedSalePrice': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'isShippingRequired': {'type': 'boolean'}, 'listPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'salePriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'couponAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'originalPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedListPriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'extendedSalePriceInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}, 'totalQuantity': {'type': 'integer'}, 'giftCertificates': {'type': ['null', 'array'], 'items': {'type': 'object', 'required': ['entityId', 'name', 'theme', 'isTaxable', 'message', 'amount', 'amountInDisplayCurrency', 'sender', 'recipient'], 'properties': {'name': {'type': 'string'}, 'theme': {'type': 'string'}, 'amount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'sender': {'type': 'object', 'required': ['name', 'email'], 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string'}}, 'additionalProperties': False}, 'message': {'type': ['null', 'string']}, 'entityId': {'type': 'string'}, 'isTaxable': {'type': 'boolean'}, 'recipient': {'type': 'object', 'required': ['name', 'email'], 'properties': {'name': {'type': 'string'}, 'email': {'type': 'string'}}, 'additionalProperties': False}, 'amountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}}}, 'additionalProperties': False}, 'updatedAt': {'type': 'object', 'required': ['utc'], 'properties': {'utc': {'type': 'string'}}, 'additionalProperties': False}, 'baseAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'currencyCode': {'type': 'string'}, 'isTaxIncluded': {'type': 'boolean'}, 'discountedAmount': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'displayCurrencyCode': {'type': 'string'}, 'amountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'baseAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}, 'discountedAmountInDisplayCurrency': {'type': 'object', 'required': ['currencyCode', 'value', 'formatted'], 'properties': {'value': {'type': 'number'}, 'formatted': {'type': ['null', 'string']}, 'currencyCode': {'type': 'string'}}, 'additionalProperties': False}}, 'additionalProperties': False}, 'message': {'type': 'string'}, 'success': {'type': 'boolean'}}, 'additionalProperties': False}
Verlauf
Letzte Tool-Änderungen
Geändert
get_product_details
23. September 2026 02:54
Hinzugefügt
update_cart_item
17. September 2026 12:37
Hinzugefügt
search_products
17. September 2026 12:37
Hinzugefügt
remove_item_from_cart
17. September 2026 12:37
Hinzugefügt
get_product_details
17. September 2026 12:37
Hinzugefügt
create_checkout_url
17. September 2026 12:37
Hinzugefügt
add_item_to_cart
17. September 2026 12:37
Entdecken
Ähnliche MCP-Server
AgentLot Marketplace
io.agentlot/marketplace
Enables agents and users to discover, bid on, purchase, deliver, and settle paid digital services and compute work.
apex-x1
xyz.apexfaucet/apex-x1
Provides X1 and Arc token screening, liquidity and exit-risk checks, wallet and bridge data, non-custodial token operations, comm…
SpellBook Finance
com.spellbook-finance/mcp
Provides Magic: The Gathering and other trading-card market prices, buylist offers, arbitrage analysis, sealed-product EV, seller…
API Direct
io.apidirect/api-direct
Searches and retrieves data from social networks, news and Google services, while also providing Amazon product, seller, ranking,…
Digital Manager Guru
io.github.mcp-dir/guru-mcp
Provides Digital Manager Guru checkout, customer, transaction, subscription, affiliate, coupon, blocklist, and digital-product sa…
Pagar.me
io.github.mcp-dir/pagarme-mcp
Connects to Pagar.me to manage customers, cards, orders, charges, invoices, payment captures, confirmations, retries, refunds, an…
amazon-product-research-mcp
com.webotee/amazon-product-research-mcp
Researches Amazon products, brands, sellers, buy-box activity, sourcing profitability, category competition, and supplier opportu…
AgentLux
io.github.agentlux/agentlux
Operates an agent avatar marketplace with item generation, purchases, creator earnings, public profiles, social activity, and ERC…