Skip to main content
Adds a product to the cart at a linked merchant, using the product id from buy_search_products.
Not advertised in tools/list by default — the buy tool covers this conversationally. Expert integrations can still call it by name.

​
Parameters

ParameterTypeRequiredDescription
merchantstringYesThe linked merchant slug.
product_idstringYesThe product id from buy_search_products.
quantitynumberNoHow many to add. Defaults to 1.

​
Returns

The updated cart: a line per item with quantity, name, and price, then the subtotal, plus the total including fees, tax, and delivery when it differs. Failures return a short error message.

​
Example

{ "name": "buy_add_to_cart", "arguments": { "merchant": "goodeggs", "product_id": "prod_84h2", "quantity": 2 } }