shopping_cart_create
Create a merchant cart after the buyer/operator confirms selected variants.
1verified stores declare the shopping_cart_create tool
0%of the verified stores we check
By store platform
Custom or not identified 100%
By release
Each store has its own status page. To find more, search the directory.
Input schema
inputSchema
{
"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
}