Cloudcart

Tools

• Add to Cart

  Tool to add an item to the cart. use after confirming a product selection with desired quantity.

• Clear Cart

  Tool to remove all items from the specified cart. use when you need to empty the cart before adding new items or starting over.

• Create Category

  Tool to create a new category. use when you need to add organizational structure to your product catalog.

• Create Customer

  Tool to create a new customer in cloudcart. use when you need to register a new customer profile. provide validated customer details (name, email, and password).

• Create Order

  Tool to create a new order. use after assembling customer id, cart items, and optional addresses/payment info.

• Create Product

  Tool to create a new product. use when you have all details and want to add it to cloudcart.

• Create Variant

  Tool to create a new product variant for a given product. use when you need to add a variant with specific sku, price, and options.

• Create Variant Option

  Tool to create a new variant option for a specific product variant. use when you need to add an option (e.g., 'large') with an optional price adjustment to an existing variant.

• Create Variant Parameter

  Tool to create a new variant parameter for a product variant. use when you need to add custom attributes (e.g., color, size) after a variant is created.

• Create Vendor

  Tool to create a new vendor via cloudcart api. use when adding a new brand or partner entity to your store.

• Delete Category

  destructive

  Tool to delete a category by its id. use after confirming the correct id to permanently remove it.

• Delete Customer

  destructive

  Tool to delete a customer. use when you need to remove a customer by their id. example: "delete customer with id 123".

• Delete Order

  destructive

  Tool to delete an order. use after confirming the order exists.

• Delete Product

  destructive

  Tool to delete a product by its id. use after confirming the product exists to permanently remove it from the catalog.

• Delete Vendor

  destructive

  Tool to delete a vendor by its id. use when removing an obsolete vendor from the store.

• Get Cart

  Tool to retrieve the current shopping cart. use when you need to view or verify the cart contents before checkout.

• Get Categories

  Tool to retrieve a list of all categories. use when you need to list available categories for selection.

• Get Customers

  Tool to retrieve a list of all customers. use when you need to display or process multiple customer profiles. note: the response is paginated; use page[number] and page[size] to control pagination.

• Get Orders

  Tool to retrieve a list of all orders. use when you need to collect orders for processing. returns json api order resources including id, type, and attributes. ensure authentication before calling.

• Get Payment Methods

  Tool to retrieve all available payment methods. use when you need to list supported payment options before checkout.

• Get Products

  Tool to retrieve a list of products with optional filters. use when you need a paginated catalog of products (e.g., by page, category, price range).

• Get Product With Relations

  Tool to retrieve a product with related entities. use when detailed product information is needed after obtaining its id.

• Get Property Options Relationship

  Tool to retrieve property options relationship for a product. use when you need to fetch which property options are assigned to a product after confirming it exists.

• Get Shipping Methods

  Tool to retrieve all available shipping methods. use when you need to list shipping options before checkout.

• Get Vendor

  Tool to retrieve details of a specific vendor. use when you have the vendor id.

• List Order Payment

  Tool to retrieve a list of order payments. use when you need to view payments for orders, optionally filtered by order id or status. useful after creating or updating orders to inspect their payment history.

• List Vendors

  Tool to retrieve a list of all vendors. use when you need a paginated list of vendors or filter by name/status. example: "list active vendors on page 2."

• Remove from Cart

  destructive

  Tool to remove an item from the cart. use after confirming the product exists in the cart to delete it.

• Update Cart Item

  Tool to update the quantity of an item in the cart. use when you need to adjust item quantities in the cart before checkout.

• Update Category

  Tool to update an existing category. use when you need to modify category details after reviewing its current values.

• Update Customer

  Tool to update an existing customer. use when modifying customer details like name, email, or address.

• Update Order

  Tool to update an existing order. use when you need to modify order details after creation (e.g., change status or addresses). provide only the fields you wish to change.

• Update Product

  Tool to update an existing product's details. use when you need to modify product information after confirming the product id.

• Update Vendor

  Tool to update an existing vendor. use when vendor details change and need saving. call after confirming the vendor id.

Works well with

How Switchy teams use it

Starter prompts

@Cloudcart add product SKU-7829 with quantity 2 to the cart for customer ID 4501. Confirm the cart total after adding.

@Cloudcart create a new variant for product ID 203 with SKU 'TEE-BLK-L', price $24.99, and option 'Large'. Set stock to 50 units.

@Cloudcart create a new customer with name 'Jordan Lee', email 'jordan@example.com', and password 'Welcome2024'. Include phone number if available.

@Cloudcart create an order for customer ID 3402 with items from cart 8821. Use billing address '123 Main St, Austin TX 78701' and mark payment as pending.

@Cloudcart clear all items from cart ID 9104. Confirm the cart is empty and ready for new items.

Example outputs

Illustrative - representative of the model's voice and quality, not literal recordings.

Use-case deep-dives

Frequently asked