SuperCheap

Show whether optional product analytics is enabled for this account.

Enable or disable optional product analytics for this account.

Clear the authenticated customer cart.

Read the authenticated customer cart and its current price quotes.

Remove one exact item/configuration line from the cart.

Set the exact cart line quantity and wholesale selection. This overwrites the quantity and wholesale setting for the same itemId/configurationId; it does not add to the quantity. Omitting wholesale uses standard pricing. Appends a new line when that itemId/configurationId is not already in the cart. For a supplier preview, first call catalog_get_product and wait for full product details; use only a configuration and buyer offer actually returned there. Current pricing and availability are re-quoted. Returns the updated cart view. Requires cart:write scope. Use cart_remove_item to remove a line.

Get product details, offer, attributes, variants, media, and a SuperCheap deep link. When opening a supplier preview, pass its collection, channel, source, and sourceSchemaVersion through this call and later cart/favorite calls. If the item is a supplier preview, this may request background supplier-detail hydration and returns its current status; retry while pending until full product details are available before choosing a configuration or adding it to a cart.

Find similar products with stable continuation across catalog and supplier sources. Use nextCursor with the same item and market for subsequent pages. A short page is not exhaustion when continuation is present. If status is pending or supplierExpansion is queued, running, or throttled, retry at retryAfter or supplierRetryAt. If supplierExpansion is failed, stop retrying that supplier search and report its failure classification. Supplier previews must be hydrated with catalog_get_product before choosing a configuration or adding to cart. Present only buyer-market offer prices, never supplier costs.

Record only products that were actually presented to the shopper. Searching alone does not mark products as viewed. This idempotent impression signal is used to demote or exclude products in later searches.

Search canonical products with category, attribute, price, provider, vendor, sorting, and bounded pagination filters. Attribute pairs are forwarded to supplier discovery as provider Pid/Vid filters when expansion is needed, so keep the exact attributeId/valueId returned by facets. When the shopper requests N products, set limit=N (1–48); leave it unset to use the default of 12 when no count is specified. Set compact=true when limit exceeds 24; compact changes card payload size, not card selection. The product-card UI displays every returned item and supplier preview, up to 24 cards per result. Do not fetch a larger page and then select fewer only in prose: those returned cards still appear in the UI. If the shopper wants only the existing catalog or says not to search suppliers, set expandSuppliers=false so previews are not added. When product-card UI is attached, do not claim product photos are unavailable solely because the text response lacks inline images; refer to the rendered cards. Set freshOnly=true to exclude products already opened or explicitly exposed to this shopper. Use nextCursor for stable exploration pages, or nextOffset when nextCursor is unavailable; keep using the same query and filters. If status is pending, wait until retryAfter and resume with nextCursor as cursor, or nextOffset as offset when no cursor is returned; never restart a pending search from the first page. Supplier discovery automatically runs in the background for missing, weak, or exhausted results unless expandSuppliers=false. A broad result withholds unconfirmed canonical cards and describes only the current page. Continue with nextCursor when present, otherwise nextOffset; zero supplier previews on a page does not mean the search is exhausted. If supplierExpansion is queued, running, or throttled, wait until supplierRetryAt and repeat the same search. If supplierExpansion is failed, stop retrying that supplier search, report the returned failure classification, and continue only with other available results or a materially different shopper request. Set waitForSupplierResults=true to have the server poll a queued supplier expansion for up to maxWaitMs before returning.

Return a bounded category subtree. Use rootCategoryId and maxDepth to avoid loading the entire taxonomy.

Find canonical SuperCheap categories using lexical and semantic matching.

After explicit user approval, use the prepared confirmation to create the hosted Stripe payment link. The confirmation is bound to the first idempotencyKey used: if creation fails, retry with the same confirmationId and exact same key; do not switch keys. Replaying after success returns the existing unpaid checkout and link through checkout idempotency without creating another Stripe session.

Read the authenticated customer checkout/payment status.

Quote the selected cart lines and prepare a short-lived confirmation in one call when the shipping option is unambiguous. The confirmation is bound to the exact selected lines, cart revision, address, selected shipping option, and currency. Server checks the supplied cartRevision and selectedLines against the live cart. If shippingOptionId is omitted and exactly one option is available, it prepares that option; if several are available, it returns the quote and options without preparing payment. After the user selects an option, call this tool again with the same address and selectedLines, the selected shippingOptionId, and the latest cartRevision returned in quote.cartRevision. Review the exact total and shipping option with the user before calling checkout_create_payment_link. This tool creates no order or charge. At payment-link creation, the confirmation is bound to one idempotencyKey: retries must use that same key, and another key is rejected. If the cart changes, payment creation is blocked and checkout must be prepared again.

Quote only the explicitly selected cart lines and available shipping before asking the user to confirm payment. Copy selectedLines and cartRevision from cart_get; unselected lines stay in the cart. If a selected price needs acceptance, this may update that cart line to the current price and advance the shared cart revision. It does not create an order or initiate a payment.

Save a delivery address. Never infer missing personal information.

Delete one saved delivery address after explicit confirmation.

List saved delivery addresses for the authenticated customer.

Update one saved delivery address. Required address fields and its default selection are overwritten; optional address line, area, and postal code values are retained when omitted.

Add one canonical product, optionally with a selected configuration, to favorites. Copy collection, channel, source, and sourceSchemaVersion from the product card when available.

List the authenticated customer favorites in most-recently-saved order.

Remove one canonical product or selected configuration from favorites. Copy collection, channel, source, and sourceSchemaVersion from the product card when available.

Find supported SuperCheap country, language, currency, and checkout availability combinations.

Confirm that an order was delivered after explicit customer confirmation.

Choose refund or replacement for an eligible order only after explicit customer confirmation.

Read one authenticated customer order.

Read normalized tracking events for one authenticated customer order.

List authenticated customer orders with bounded pagination.

Request cancellation and any applicable refund only after confirming the exact current order total and currency.

Close one customer-owned conversation after explicit confirmation.

Create a support conversation using the exact customer-approved message.

List authenticated customer support conversations.

Send the exact customer-approved message to one owned conversation.

Read messages in one customer-owned support conversation.