cart_add_item
InactiveTool of ComOS Federation Gateway
Add a product to the shopping cart. If the product is already in the cart, its quantity will be increased. REQUIRED: cartId must be provided on every call for cart persistence. Use customer email for authenticated users or a consistent ID like "guest-abc123" for guests. Also requires tenant_id. FRESHNESS: Catalog data may change between turns. Before calling this tool, call federation_catalog_version({tenant_id}) and compare to the catalog_version in your last catalog_search _meta block. If they differ, re-fetch the catalog first — do not act on a stale productId. On SKU_NOT_FOUND, the response includes a current catalog inline; pick a new product from it rather than retrying the same productId.
Parameters schema
{
"type": "object",
"$schema": "http://json-schema.org/draft-07/schema#",
"required": [
"tenant_id",
"cartId",
"productId"
],
"properties": {
"cartId": {
"type": "string",
"description": "REQUIRED for cart persistence. Use customer email for authenticated users, or a consistent ID like \"guest-abc123\" for guests. Without this, cart items will NOT persist between calls."
},
"quantity": {
"type": "number",
"description": "Quantity to add (default 1)"
},
"productId": {
"type": "string",
"description": "Product ID to add to cart"
},
"tenant_id": {
"type": "string",
"description": "Target tenant ID (required). Use federation_list_tenants() to see available tenants."
},
"auth_token": {
"type": "string",
"description": "JWT auth token for authenticated operations (cart, orders). Get from api_call POST /v1/auth/login."
}
},
"additionalProperties": false
}No endpoints wrapped at confidence ≥ 0.70.
Parent server
ComOS Federation Gateway
https://github.com/ronrey/comos-federation
2/7 registries