add_cart_item
Add quantity units of a product selected with get_product to the consenting buyer's basket. Quantity is an increment; use update_cart_item with an item_id from get_cart for an absolute final quantity. Do not retry an uncertain add blindly; read get_cart to reconcile. Does not create an order. OAuth scopes: cart:write. Changes buyer or order state.
Tool call template
Replace each placeholder with a value matching the input schema. Only required parameters are included; add optional parameters as needed.
{
"id": 1,
"jsonrpc": "2.0",
"method": "tools/call",
"params": {
"arguments": {
"product_id": "<product_id>",
"quantity": "<quantity>"
},
"name": "add_cart_item"
}
}Input Schema
| Name | Required | Description | Default |
|---|---|---|---|
| quantity | Yes | Number of units to ADD to the existing basket quantity, not the desired final quantity. Do not blindly retry an uncertain add. | |
| product_id | Yes | Internal numeric Vesremont product ID returned by catalog search or a product response, not the SKU/article or a basket item ID. |
Output Schema
| Name | Required | Description | Default |
|---|---|---|---|
| empty | Yes | ||
| items | Yes | ||
| currency | Yes | ||
| subtotal | Yes | ||
| orderable | Yes | ||
| total_quantity | Yes |