add_to_cart
ActiveTool of Kifly — Agentic Commerce & Payments
Requires `checkout:write` scope. Add a product variant to an existing cart. Use the variant_id from search_products results. Returns full cart state including item_ids you can use with update_cart_item. **Max quantity per item and max cart total are enforced — call `get_platform_limits` to check the current limits before building a large cart.** Exceeding the per-item limit returns 400 `QUANTITY_EXCEEDS_LIMIT`; exceeding the cart total returns 400 `CART_TOTAL_EXCEEDS_LIMIT` at checkout. `cart.kifly_purchasable` (and `cart.fulfillment`) carries the same non-transactable signal as create_cart's `seller` field — check it before telling the buyer this is a real purchase.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"cart_id",
"variant_id"
],
"properties": {
"cart_id": {
"type": "string",
"description": "Cart ID from create_cart"
},
"quantity": {
"type": "integer",
"default": 1,
"minimum": 1,
"description": "Quantity to add"
},
"variant_id": {
"type": "string",
"description": "Product variant ID from search_products results"
}
},
"additionalProperties": false
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
Kifly — Agentic Commerce & Payments
1/7 registries