SendaMeal Storefront MCP Server

Add products to shopping cart with automatic cart creation Add products and gift certificates to your shopping cart. If no cart exists, this tool will automatically create a new cart and add the items to it. Perfect for starting a new shopping session or adding more items to an existing cart. Use this tool when customers want to: - Add new products to their cart - Start shopping by adding their first item - Add gift certificates to their purchase - Add multiple items in a single operation Features: - Automatic cart creation if none exists - Support for both regular products and gift certificates - Multi-currency and multi-locale support - Batch operations for adding multiple items at once - Handles product variants, quantities, and custom properties 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 'create_checkout_url' tool to generate a checkout URL for the 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.

Modify existing items in your shopping cart Update the details of items already in your shopping cart, including changing quantities, modifying product properties, or updating item-specific configurations. Use this tool when customers need to: - Change the quantity of items in their cart - Update product variants (size, color, etc.) - Modify custom properties or configurations - Adjust item-specific details before checkout Features: - Granular control over individual cart items - Quantity adjustments (increase or decrease) - Product variant and property modifications - Maintains cart integrity during 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 'update_cart_item' tool to updatem item in the cart eq. quantity - Call 'create_checkout_url' tool to generate a checkout URL for the cart. Requires an existing cart with items to modify.

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.

Get product details (variants, options and images) by product ID(s). Arguments: productIds - array of product IDs to get details for (from 'search_products'). [IMPORTANT] Request only the products the user needs. A server-configured limit applies (default 20); requests over the limit are rejected with an error (retry with fewer IDs). option_values - resolve a specific variant by option/value IDs. Only valid with a SINGLE productId, and applied on the B2C storefront catalog. B2B buyers instead receive every variant (each with its option/value IDs) and pick the desired one from the returned list. channelId - optional; scopes the B2B catalog. Defaults to the channel resolved from the request. Returns: - products: array of products, each with: - variants: each carrying entityId, SKU, and options (optionId, optionLabel, valueId, valueLabel). - For B2B buyers, variants also include price, inventoryLevel, purchaseable, and bulkPricing. - Products not found are omitted from the array. Flow: - Call 'search_products' to get product IDs. - Call this tool with the product IDs to get variants, options and images. - Call 'add_item_to_cart' with results of 'search_products' and 'get_product_details' (variant) tools. - [IMPORTANT] If a product has variants you must specify which variant to add.

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. 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