Input Schema

{
    "type": "object",
    "required": [
        "agent_id",
        "merchant_domain",
        "line_items"
    ],
    "properties": {
        "buyer": {
            "type": "object",
            "required": [],
            "properties": {
                "email": {
                    "type": "string",
                    "description": "Buyer email for cart contact if already provided; omit when unknown."
                }
            },
            "description": "Optional buyer contact summary for cart creation; never include payment data.",
            "additionalProperties": false
        },
        "context": {
            "type": "object",
            "required": [],
            "properties": {
                "intent": {
                    "type": "string",
                    "description": "Natural-language shopping context or buyer intent; do not include secrets or payment data."
                },
                "currency": {
                    "type": "string",
                    "description": "ISO 4217 currency code such as 'USD'."
                },
                "language": {
                    "type": "string",
                    "description": "Preferred language or locale such as 'en' or 'en-US'."
                },
                "postal_code": {
                    "type": "string",
                    "description": "Buyer-provided destination postal code; omit when unknown."
                },
                "address_region": {
                    "type": "string",
                    "description": "Buyer-provided state, province, or region code/name; omit when unknown."
                },
                "address_country": {
                    "type": "string",
                    "description": "ISO 3166-1 alpha-2 country code. Use 'US', not 'USA'."
                }
            },
            "description": "Optional buyer/search context for catalog, cart, or checkout tools.",
            "additionalProperties": false
        },
        "agent_id": {
            "type": "string",
            "description": "Registered UCP Gateway UUID returned by register_ucp_profile; required for every Shopping tool."
        },
        "line_items": {
            "type": "array",
            "items": {
                "type": "object",
                "required": [
                    "item",
                    "quantity"
                ],
                "properties": {
                    "item": {
                        "type": "object",
                        "required": [
                            "id"
                        ],
                        "properties": {
                            "id": {
                                "type": "string",
                                "description": "Provider variant ID returned by shopping_product_get or search results. The current adapter returns Shopify ProductVariant GIDs."
                            }
                        },
                        "description": "Selected provider item reference.",
                        "additionalProperties": false
                    },
                    "quantity": {
                        "type": "integer",
                        "maximum": 99,
                        "minimum": 1,
                        "description": "Integer quantity from 1 to 99, confirmed by the buyer/operator."
                    }
                },
                "description": "Cart or checkout line item.",
                "additionalProperties": false
            },
            "maxItems": 50,
            "minItems": 1,
            "description": "Selected provider variant line items confirmed by the buyer/operator."
        },
        "merchant_domain": {
            "type": "string",
            "description": "Merchant host such as 'outboundpower.com' or 'example.myshopify.com'. Do not include a URL scheme, localhost, private IP, file URL, or ftp URL."
        },
        "client_action_id": {
            "type": "string",
            "description": "Optional UUID generated once for an explicit buyer/operator-confirmed cart or checkout mutation. Reuse only when retrying the same confirmed action."
        }
    },
    "description": "Arguments for creating a cart.",
    "additionalProperties": false
}