# Cloudcart — how to use (mcp.ai)

Connect your Cloudcart account and use 150 tools for ecommerce straight from your AI agent. Connect with your own API key. CloudCart is an e-commerce platform that enables businesses to create and manage online stores efficiently.

## Option A — via MCP (recommended)
Remote MCP endpoint (HTTP, streamable): `https://api.mcp.ai/p_cloudcart?ms=1787291520000`
Add it as a custom/remote MCP connector in your client (Claude, Cursor, VS Code…), then authenticate when prompted. Once connected, ask the agent to use the server's tools (e.g. `cloudcart_add_category_properties`).

## Option B — via direct REST API
Base URL: `https://api.mcp.ai/api/cloudcart`
Auth: `Authorization: Bearer sk_live_…` — create a workspace API key at https://mcp.ai/settings/api-keys
Discover endpoints: `GET https://api.mcp.ai/api/cloudcart/_endpoints`

### Endpoints
- `POST https://api.mcp.ai/api/cloudcart/add/category/properties` — Tool to add properties to a category relationship. Use when you need to associate one or more properties with a category for filtering or organization purposes.
  - body: { category_id: string, property_ids: string[] }
- `POST https://api.mcp.ai/api/cloudcart/add/to/cart` — Tool to add an item to the cart. Use after confirming a product selection with desired quantity.
  - body: { quantity: integer, product_id: integer }
- `POST https://api.mcp.ai/api/cloudcart/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.
- `POST https://api.mcp.ai/api/cloudcart/create/blog/category` — Tool to create a new blog category in CloudCart. Use when you need to organize blog posts into categories. Requires a category name and optionally accepts an image URL for visual representation.
  - body: { name: string }
- `POST https://api.mcp.ai/api/cloudcart/create/blog/post` — Tool to create a new blog post in CloudCart. Use when you need to publish blog content to your store. Requires post title, content, blog ID, and author ID.
  - body: { name: string, blog_id: string, content: string, tag_ids?: string[], author_id: string, image_url?: string }
- `POST https://api.mcp.ai/api/cloudcart/create/blog/tags` — Tool to create a new blog tag in CloudCart. Use when you need to add tags for organizing blog content. Tags help categorize and filter blog posts for better content discovery.
  - body: { data: object }
- `POST https://api.mcp.ai/api/cloudcart/create/category` — Tool to create a new category. Use when you need to add organizational structure to your product catalog.
  - body: { title: string, position?: integer, meta_title?: string, description?: string, meta_keywords?: string, meta_description?: string }
- `POST https://api.mcp.ai/api/cloudcart/create/customer` — Tool to create a new customer in CloudCart. Use when you need to register a new customer profile. Provide validated customer details (first name, last name, email, and password). Returns the created c
  - body: { email: string, password: string, last_name: string, first_name: string, alternative_phone?: string }
- `POST https://api.mcp.ai/api/cloudcart/create/customer/billing/address` — Tool to create a new customer billing address. Use when you need to add a billing address for an existing customer. Requires customer ID and address details (name, country, city, street).
  - body: { phone?: string, city_name: string, last_name: string, post_code?: string, first_name: string, customer_id: string, street_name: string, country_iso2: string, street_number?: string, phone_country_iso2?: string }
- `POST https://api.mcp.ai/api/cloudcart/create/customer/groups` — Tool to create a new customer group in CloudCart. Use when you need to organize customers into categories or segments for targeted marketing, pricing, or permissions. The group name must be unique.
  - body: { data: object }
- `POST https://api.mcp.ai/api/cloudcart/create/customer/shipping/address` — Tool to create a customer shipping address in CloudCart. Use when you need to add a new delivery address for an existing customer. Requires customer ID and complete address details (name, phone, count
  - body: { note?: string, phone: string, city_name: string, last_name: string, post_code: string, first_name: string, customer_id: string, street_name: string, country_iso2: string, street_number: string, phone_country_iso2: string }
- `POST https://api.mcp.ai/api/cloudcart/create/customer/tags` — Tool to create a new customer tag in CloudCart. Use when you need to add tags for organizing and categorizing customers. Tags can be used for filtering, grouping, or marketing purposes.
  - body: { tag: string }
- `POST https://api.mcp.ai/api/cloudcart/create/discount` — Tool to create a new discount in CloudCart. Use when you need to add promotional discounts, sales, or special offers. Supports various discount types (fixed, percent, flat, shipping) and flexible targ
  - body: { code?: string, name: string, active?: string, target: object, date_end?: string, max_uses?: integer, date_start: string, order_over?: integer, type_value: integer, discount_type: string }
- `POST https://api.mcp.ai/api/cloudcart/create/discount/code` — Create a new discount code in CloudCart. Use when you need to add promotional discount codes to the store. The value represents the discount percentage multiplied by 100 (e.g., 1500 = 15% off).
  - body: { code: string, value: integer, active: integer }
- `POST https://api.mcp.ai/api/cloudcart/create/images` — Tool to create a new image for a product. Use when you need to add an image to an existing product by providing the image URL and product ID.
  - body: { src: string, product_id: string }
- `POST https://api.mcp.ai/api/cloudcart/create/linked/products` — Tool to create linked product relationships in CloudCart. Use when you need to associate related products together, such as complementary items or product bundles. Supports bidirectional linking where
  - body: { product_id: string, linked_products: object[] }
- `POST https://api.mcp.ai/api/cloudcart/create/order` — Tool to create a new order. Use after assembling customer ID, cart items, and optional addresses/payment info.
  - body: { items: object[], currency?: string, customer_id: integer, payment_method?: string, billing_address?: object, shipping_address?: object }
- `POST https://api.mcp.ai/api/cloudcart/create/product` — Creates a new product in CloudCart catalog. Requires product name, price, and at least one category ID. Supports optional fields like SKU, description (HTML allowed), quantity, weight, barcode, status
  - body: { sku?: string, name: string, tags?: string[], price: number, images?: string[], status?: string, vendor?: string, weight?: number, barcode?: string, quantity?: integer, categories: integer[], description?: string }
- `POST https://api.mcp.ai/api/cloudcart/create/product/to/discount` — Tool to create a product to discount relationship in CloudCart. Use when you need to associate a product variant with a discount and optionally set a discounted price.
  - body: { price?: number, product_id: string, variant_id: string, discount_id: string }
- `POST https://api.mcp.ai/api/cloudcart/create/products/property/options` — Tool to add property options to a product relationship. Use when you need to associate one or more property options with a product for configuration or customization purposes.
  - body: { product_id: string, property_option_ids: string[] }
- `POST https://api.mcp.ai/api/cloudcart/create/properties` — Tool to create a new property in CloudCart. Properties are attributes that can be assigned to products (e.g., color, size, material). Use when you need to define new product characteristics or attribu
  - body: { name: string, sort?: integer, active?: integer, is_visible?: integer, url_handle?: string, display_type: string }
- `POST https://api.mcp.ai/api/cloudcart/create/property/option` — Tool to create a new property option. Use when you need to add a new option value to a product property (e.g., adding "Red" to a "Color" property or "Large" to a "Size" property).
  - body: { sort?: integer, value: string, seo_title?: string, url_handle: string, description?: string, property_id: string, seo_description?: string }
- `POST https://api.mcp.ai/api/cloudcart/create/redirects` — Create a new URL redirect in CloudCart. Supports five redirect types: 'manual' for custom paths, 'external' for external URLs, and 'product', 'category', or 'vendor' to link to specific store items. U
  - body: { item?: object, new_url?: string, old_url: string, redirect_type: string }
- `POST https://api.mcp.ai/api/cloudcart/create/subscribers` — Tool to create a new subscriber in CloudCart. Use when you need to add a subscriber to the mailing list. Provide the subscriber's first name, last name, and two-letter country code.
  - body: { country: string, last_name: string, first_name: string }
- `POST https://api.mcp.ai/api/cloudcart/create/subscribers/channels` — Tool to create a new subscriber channel in CloudCart. Use when you need to add a communication channel (email or phone) for a subscriber. Provide the subscriber ID, channel type, contact identifier, a
  - body: { bounced: string, channel: string, verified: string, marketing: string, subscriber_id: string, channel_identifier: string }
- `POST https://api.mcp.ai/api/cloudcart/create/subscribers/tags` — Tool to create a new subscriber-tag association in CloudCart. Use when you need to associate a tag with a subscriber for organizing, categorizing, or filtering subscribers.
  - body: { tag_id: string, subscriber_id: string }
- `POST https://api.mcp.ai/api/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.
  - body: { sku: string, price: number, weight?: number, quantity?: integer, product_id: string, option_values?: object[] }
- `POST https://api.mcp.ai/api/cloudcart/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.
  - body: { name: string, price?: number, position?: integer, is_default?: boolean, product_id: integer, variant_id: integer }
- `POST https://api.mcp.ai/api/cloudcart/create/variant/options` — Tool to create a new variant option. Use when you need to add a new option (e.g., 'Medium', 'Blue') to an existing variant parameter.
  - body: { name: string, sort?: integer, color?: string, visible?: integer, parameter_id: string }
- `POST https://api.mcp.ai/api/cloudcart/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.
  - body: { name: string, type?: string, value: string, productId: string, variantId: string }
- `POST https://api.mcp.ai/api/cloudcart/create/variant/parameters` — Tool to create a new variant parameter definition. Use when you need to define a new product attribute type (e.g., Size, Color, Material) that can be used across products.
  - body: { name: string, display_type: string }
- `POST https://api.mcp.ai/api/cloudcart/create/vendor` — Create a new vendor in your CloudCart store. Vendors represent brands, manufacturers, or suppliers. The image_url is optional - if not provided, a default placeholder will be used. If provided, it mus
  - body: { data: object }
- `POST https://api.mcp.ai/api/cloudcart/create/webhooks` — Tool to create a new webhook subscription in CloudCart. Use when you need to register a webhook URL for receiving real-time event notifications (e.g., order.created, order.updated). CloudCart will sen
  - body: { url: string, event: string, headers?: object, new_version?: integer }
- `POST https://api.mcp.ai/api/cloudcart/delete/blog/category` — Tool to delete a blog category by its ID. Use after confirming the correct ID to permanently remove it.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/blog/post` — Tool to delete a blog post by its ID. Use after confirming the correct ID to permanently remove the blog post.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/blog/tag` — Tool to delete a blog tag by its ID. Use after confirming the correct ID to permanently remove the tag. The API returns 204 No Content on successful deletion.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/category` — Tool to delete a category by its ID. Use after confirming the correct ID to permanently remove it.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/customer` — Tool to delete a customer. Use when you need to remove a customer by their ID. Example: "Delete customer with ID 123".
  - body: { customer_id: integer }
- `POST https://api.mcp.ai/api/cloudcart/delete/customer/billing/address` — Tool to delete a customer billing address by its ID. Use when you need to remove a billing address from a customer's account.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/customer/group` — Tool to delete a customer group by its ID. Use when you need to permanently remove a customer group from the store.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/customer/shipping/address` — Tool to delete a customer shipping address. Use when you need to remove a customer's shipping address by its ID.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/cloudcart/delete/customer/tag` — Tool to delete a customer tag by its ID. Use after confirming the tag exists to permanently remove it.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/discount` — Tool to delete a discount by its ID. Use after confirming the discount exists to permanently remove it from the store.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/discount/code` — Tool to delete a discount code by its ID. Use after confirming the discount code exists to permanently remove it from the store.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/image` — Tool to delete an image by its ID. Use when you need to remove an image permanently from the CloudCart store.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/order` — Tool to delete an order. Use after confirming the order exists.
  - body: { order_id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/product` — Tool to delete a product by its ID. Use after confirming the product exists to permanently remove it from the catalog.
  - body: { product_id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/product/to/discount` — Tool to delete a product-to-discount relationship by its ID. Use to remove the association between a product and a discount.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/products/linked/products` — Tool to delete linked product relationships in CloudCart. Use when you need to remove associations between related products. This removes the link but does not delete the products themselves.
  - body: { product_id: string, linked_products: object[] }
- `POST https://api.mcp.ai/api/cloudcart/delete/property` — Tool to delete a property by its ID. Use after confirming the correct property ID to permanently remove it from the store.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/property/options` — Tool to delete a property option by its ID. Use when you need to remove obsolete property options or clean up test data.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/redirect` — Tool to delete a redirect by its ID. Use this when you need to remove obsolete redirects or clean up redirect rules in the CloudCart store.
  - body: { redirect_id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/subscriber` — Tool to delete a subscriber by their ID. Use when you need to remove a subscriber from the mailing list.
  - body: { subscriber_id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/subscribers/channel` — Tool to delete a subscriber channel by ID. Use when you need to remove a subscriber channel from the system. The API returns 204 No Content on successful deletion.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/subscribers/tag` — Tool to delete a subscriber tag by its ID. Use after confirming the tag exists to permanently remove it.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/variant` — Tool to delete a variant by its ID. Use when you need to permanently remove a product variant from the catalog.
  - body: { variant_id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/variant/option` — Tool to delete a variant option by its ID. Use when you need to permanently remove a variant option from a product variant in the CloudCart store.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/variant/parameter` — Tool to delete a variant parameter by its ID. Use when you need to permanently remove a variant parameter from the CloudCart store. The API returns 204 No Content on successful deletion.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/vendor` — Delete a vendor by its ID from the CloudCart store. This operation permanently removes the vendor record. The API returns 204 No Content on successful deletion. Use this tool when you need to remove o
  - body: { vendor_id: string }
- `POST https://api.mcp.ai/api/cloudcart/delete/webhook` — Tool to delete a webhook by its ID from the CloudCart store. Use when you need to remove webhooks that are no longer needed or to clean up webhook subscriptions.
  - body: { webhook_id: string }
- `POST https://api.mcp.ai/api/cloudcart/generate/discount/codes` — Tool to generate multiple discount codes with a specified discount percentage. Use when you need to create multiple promotional codes with the same discount value. The discount value is multiplied by 
  - body: { count: integer, value: integer }
- `POST https://api.mcp.ai/api/cloudcart/get/blog/author` — Tool to retrieve details of a specific blog author by ID. Use when you need information about a blog author.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/get/blog/category` — Tool to retrieve details of a specific blog category by ID. Use when you need information about a particular blog category.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/get/blog/post` — Tool to retrieve a single blog post by its ID. Use when you need detailed information about a specific blog post including title, content, author, publish date, and images.
  - body: { id: string, fields?: string[] }
- `POST https://api.mcp.ai/api/cloudcart/get/blog/tag` — Tool to retrieve details of a specific blog tag by ID. Use when you need to fetch information about a particular tag.
  - body: { id: string, fields?: string[] }
- `POST https://api.mcp.ai/api/cloudcart/get/cart` — Tool to retrieve the current shopping cart. Use when you need to view or verify the cart contents before checkout.
  - body: { cart_id?: string }
- `POST https://api.mcp.ai/api/cloudcart/get/categories` — Tool to retrieve a list of all categories. Use when you need to list available categories for selection. Returns numeric category IDs; use these IDs directly (not names or slugs) when setting categori
- `POST https://api.mcp.ai/api/cloudcart/get/categories/properties` — Tool to retrieve properties relationship for a category. Use when you need to get the list of properties assigned to a specific category.
  - body: { id: integer }
- `POST https://api.mcp.ai/api/cloudcart/get/category` — Tool to retrieve details of a specific category by ID. Use when you need information about a single category.
  - body: { category_id: string }
- `POST https://api.mcp.ai/api/cloudcart/get/customer` — Tool to retrieve details of a specific customer by ID. Use when you need information about a single customer.
  - body: { id: string, fields?: string, include?: string }
- `POST https://api.mcp.ai/api/cloudcart/get/customer/billing/address` — Tool to retrieve a specific customer billing address by its ID. Use when you need to fetch details of a particular billing address including country, state, city, street information, and contact detai
  - body: { id: string, fields?: string, include?: string }
- `POST https://api.mcp.ai/api/cloudcart/get/customer/group` — Tool to retrieve details of a specific customer group by ID. Use when you need to fetch information about a particular customer group.
  - body: { customer_group_id: string }
- `POST https://api.mcp.ai/api/cloudcart/get/customer/groups/customers` — Tool to retrieve customers from a specific customer group. Use when you need to list all customers belonging to a particular group.
  - body: { id: integer, sort?: string, page_size?: integer }
- `POST https://api.mcp.ai/api/cloudcart/get/customer/shipping/address` — Tool to retrieve a single customer shipping address by ID. Use when you need details about a specific shipping address. Optionally include related customer data or filter specific fields to return onl
  - body: { fields?: string[], include?: string, address_id: string }
- `POST https://api.mcp.ai/api/cloudcart/get/customer/tag` — Tool to retrieve details of a specific customer tag. Use when you have the customer tag ID and need to get its details.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/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.
  - body: { sort?: string, page_size?: integer, page_number?: integer, filter_email?: string }
- `POST https://api.mcp.ai/api/cloudcart/get/image` — Tool to retrieve details of a specific image by ID. Use when you need information about a single image including its dimensions, URLs, thumbnails, and related product.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/get/orders` — Retrieve a paginated list of orders from your CloudCart store. Returns order details including order ID, status, total amount, currency, and creation/update timestamps. Supports pagination through pag
  - body: { page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/cloudcart/get/payment/methods` — Tool to retrieve all available payment methods. Use when you need to list supported payment options before checkout.
- `POST https://api.mcp.ai/api/cloudcart/get/product/with/relations` — Retrieves detailed information about a specific product including its relationships (category, vendor, variants). Use this action when you need comprehensive product details after obtaining a product 
  - body: { product_id: string }
- `POST https://api.mcp.ai/api/cloudcart/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).
  - body: { page?: integer, limit?: integer, search?: string, brand_id?: integer, max_price?: number, min_price?: number, category_id?: integer, with_hidden?: boolean }
- `POST https://api.mcp.ai/api/cloudcart/get/products/linked/product` — Tool to retrieve linked products for a specific product. Use when you need to get related or complementary products that are associated with a main product.
  - body: { id: string, page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/cloudcart/get/products/linked/products` — Tool to retrieve linked products for a specific product. Use when you need to find products that are associated or related to a given product, such as complementary items or product recommendations.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/get/property` — Tool to retrieve details of a specific property by ID. Use when you need information about a single property.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/get/property/option` — Tool to retrieve details of a specific property option by ID. Use when you need information about a single property option.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/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.
  - body: { product_id: integer }
- `POST https://api.mcp.ai/api/cloudcart/get/shipping/methods` — Tool to retrieve all available shipping methods. Use when you need to list shipping options before checkout.
- `POST https://api.mcp.ai/api/cloudcart/get/subscriber` — Tool to retrieve details of a specific subscriber by ID. Use when you need information about a single subscriber including their engagement metrics and subscription details.
  - body: { id: string, fields?: string, include?: string }
- `POST https://api.mcp.ai/api/cloudcart/get/subscribers/channel` — Tool to retrieve a single subscriber channel by its ID. Use when you need details about a specific subscriber's communication channel. Returns channel information including type, identifier, verificat
  - body: { id: string, fields?: string, include?: string }
- `POST https://api.mcp.ai/api/cloudcart/get/subscribers/tag` — Tool to retrieve details of a specific subscriber tag by ID. Use when you need to get information about a subscriber tag association.
  - body: { id: string, fields?: string, include?: string }
- `POST https://api.mcp.ai/api/cloudcart/get/variant` — Tool to retrieve details of a specific variant by ID. Use when you need information about a single product variant.
  - body: { variant_id: string }
- `POST https://api.mcp.ai/api/cloudcart/get/variant/option` — Tool to retrieve a specific variant option by its ID. Use when you need details about a particular variant option such as its name, sort order, color, visibility, or associated parameter.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/get/variant/parameter` — Tool to retrieve details of a specific variant parameter by ID. Use when you need information about a single variant parameter.
  - body: { id: string }
- `POST https://api.mcp.ai/api/cloudcart/get/vendor` — Tool to retrieve details of a specific vendor. Use when you have the vendor ID.
  - body: { vendor_id: string }
- `POST https://api.mcp.ai/api/cloudcart/get/webhook` — Tool to retrieve details of a specific webhook by ID. Use when you need information about a webhook configuration.
  - body: { id: string, fields?: string, include?: string }
- `POST https://api.mcp.ai/api/cloudcart/list/blog/categories` — Tool to retrieve all blog categories with optional pagination, sorting, and filtering. Use when you need to list blog categories or get blog category information for content organization.
  - body: { sort?: string, fields?: string, filter?: string, page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/blog/posts` — Tool to retrieve a list of all blog posts. Use when you need a paginated list of blog posts with optional filtering and sorting. Example: "List recent blog posts on page 1."
  - body: { page?: integer, sort?: string, limit?: integer, fields?: string, filter?: string, include?: string }
- `POST https://api.mcp.ai/api/cloudcart/list/blog/tags` — Tool to retrieve all blog tags from CloudCart. Use when you need to list available blog tags for filtering or selection. Supports pagination, sorting, and filtering.
  - body: { sort?: string, fields?: string[], filter?: string[], page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/customer/billing/address` — Tool to retrieve a list of all customer billing addresses. Use when you need to access billing address information for customers. The response is paginated; use page[number] and page[size] parameters 
  - body: { sort?: string, include?: string, page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/customer/groups` — Tool to retrieve all customer groups. Use when you need to display or process customer group information. The response is paginated; use page[number] and page[size] to control pagination.
  - body: { page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/customer/shipping/addresses` — Tool to retrieve a paginated list of customer shipping addresses. Use when you need to list all shipping addresses or filter by customer ID or country. Supports pagination and sorting.
  - body: { sort?: string, include?: string, page_size?: integer, page_number?: integer, filter_customer_id?: integer, filter_country_iso2?: string }
- `POST https://api.mcp.ai/api/cloudcart/list/customer/tags` — Tool to retrieve all customer tags. Use when you need to list available tags for customer categorization or filtering.
- `POST https://api.mcp.ai/api/cloudcart/list/discount/codes` — Tool to retrieve all discount codes from your CloudCart store. Use when you need to list available discount codes, check their status, or manage promotions.
  - body: { sort?: string, fields?: string, filter?: string, include?: string, page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/images` — Tool to retrieve all images from CloudCart. Use when you need a paginated list of images.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/order/billing/address` — Tool to retrieve order billing addresses (read-only). Use when you need to access billing address information associated with orders. The response is paginated; use page[number] and page[size] paramet
  - body: { sort?: string, include?: string, page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/order/payment` — Retrieve payment information from orders. Since CloudCart API does not have a dedicated payments endpoint, this action fetches orders and extracts payment-related data. Use when you need to view payme
  - body: { page?: integer, limit?: integer, order_id?: integer, payment_status?: string }
- `POST https://api.mcp.ai/api/cloudcart/list/order/payment2` — Tool to retrieve order payment data from the CloudCart order-payment endpoint. Use when you need to access payment transaction details including payment IDs, provider references, amounts, and statuses
  - body: { page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/order/products` — Retrieve all order products from your CloudCart store (read-only). Returns order product details including product ID, attributes, and relationships to orders and product options. Supports pagination 
  - body: { page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/order/products/options` — Tool to retrieve order products options (read-only). Use when you need to list custom field options associated with products in orders.
  - body: { page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/order/shipping` — Tool to retrieve order shipping data. Use when you need to list shipping information for orders.
  - body: { page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/order/shipping/address` — Tool to retrieve a paginated list of order shipping addresses. Use when you need to view shipping addresses associated with orders, filter by order ID, or export address data. Supports pagination and 
  - body: { include?: string, page_size?: integer, page_number?: integer, filter_order_id?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/order/status` — Tool to retrieve all available order statuses from CloudCart. Returns status codes, names, translations, and types (order, payment, or shipping). Use when you need to view available order statuses for
- `POST https://api.mcp.ai/api/cloudcart/list/payment/providers` — Tool to retrieve all payment providers (read-only). Use when you need to view configured payment providers in the store.
- `POST https://api.mcp.ai/api/cloudcart/list/properties` — Tool to retrieve all properties with optional pagination. Use when you need to list available properties or get property information for product configuration.
  - body: { page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/property/options` — Tool to retrieve all property options with optional filtering and pagination. Use when you need to list property options or filter by property ID.
  - body: { page_size?: integer, page_number?: integer, filter_property_id?: string }
- `POST https://api.mcp.ai/api/cloudcart/list/redirects` — Tool to retrieve all redirects from CloudCart. Use when you need to view URL redirects configured in the store.
  - body: { page?: integer, limit?: integer, item_id?: string, item_type?: string }
- `POST https://api.mcp.ai/api/cloudcart/list/shipping/providers` — Tool to retrieve all shipping providers (read-only). Use when you need to view configured shipping providers in the store.
- `POST https://api.mcp.ai/api/cloudcart/list/subscribers` — Tool to retrieve all subscribers from the store. Use when you need to display or process subscriber information with engagement metrics like open rates and click rates.
  - body: { sort?: string, page_size?: integer, page_number?: integer, filter_customer_id?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/subscribers/channels` — Tool to retrieve all subscriber channels. Use when you need to list available channels for subscriber management or filtering.
  - body: { sort?: string, fields?: string, filter?: string, include?: string, page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/subscribers/tags` — Tool to retrieve all subscriber tags. Use when you need to list tag associations for subscribers with flexible organization through customizable labeling. Supports pagination, filtering, and sorting.
  - body: { sort?: string, fields?: string, filter?: string, include?: string, page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/variant/options` — Tool to retrieve all variant options. Use when you need to list available variant options with optional pagination.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/variant/parameters` — Tool to retrieve all variant parameters with pagination support. Use when you need to list product variant configuration options like size, color, or other custom attributes.
  - body: { page?: integer, limit?: integer }
- `POST https://api.mcp.ai/api/cloudcart/list/variants` — Tool to retrieve all product variants with optional pagination and filtering. Use when you need to list variants across products or filter by specific item ID or SKU.
  - body: { sku?: string, page?: integer, limit?: integer, item_id?: integer }
- `POST https://api.mcp.ai/api/cloudcart/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."
  - body: { page?: integer, limit?: integer, search?: string, status?: string }
- `POST https://api.mcp.ai/api/cloudcart/list/webhooks` — Tool to retrieve all webhooks. Use when you need to view configured webhooks, check webhook events, or manage webhook subscriptions.
  - body: { sort?: string, fields?: string, filter?: string, include?: string, page_size?: integer, page_number?: integer }
- `POST https://api.mcp.ai/api/cloudcart/remove/from/cart` — Tool to remove an item from the cart. Use after confirming the product exists in the cart to delete it.
  - body: { product_id: integer }
- `POST https://api.mcp.ai/api/cloudcart/update/blog/category` — Tool to update an existing blog category. Use when you need to modify blog category details such as name, SEO settings, or image.
  - body: { id: string, name?: string, image?: string, comments?: string, seo_title?: string, url_handle?: string, seo_description?: string }
- `POST https://api.mcp.ai/api/cloudcart/update/blog/post` — Tool to update an existing blog post. Use when you need to modify the title or content of a blog post. Requires the blog post ID and at least one field to update (name or content).
  - body: { id: string, name?: string, content?: string }
- `POST https://api.mcp.ai/api/cloudcart/update/blog/tag` — Tool to update an existing blog tag. Use when you need to modify a blog tag's name or label.
  - body: { id: string, tag: string }
- `POST https://api.mcp.ai/api/cloudcart/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.
  - body: { quantity: integer, product_id: integer }
- `POST https://api.mcp.ai/api/cloudcart/update/category` — Tool to update an existing category. Use when you need to modify category details after reviewing its current values.
  - body: { id: string, title?: string, position?: integer, meta_title?: string, description?: string, meta_keywords?: string, meta_description?: string }
- `POST https://api.mcp.ai/api/cloudcart/update/customer` — Updates an existing customer's information in CloudCart. You can modify customer details such as first name, last name, email, password, and alternative phone number. All update fields are optional - 
  - body: { email?: string, password?: string, last_name?: string, first_name?: string, customer_id: integer, alternative_phone?: string }
- `POST https://api.mcp.ai/api/cloudcart/update/customer/billing/address` — Tool to update an existing customer billing address in CloudCart. Use when you need to modify billing address details such as phone, location, or contact information. All update fields are optional - 
  - body: { id: string, note?: string, phone?: string, city_name?: string, last_name?: string, post_code?: string, first_name?: string, company_vat?: string, street_name?: string, company_name?: string, country_iso2?: string, phone_country_iso2?: string }
- `POST https://api.mcp.ai/api/cloudcart/update/customer/group` — Tool to update an existing customer group's name. Use when you need to modify a customer group's details after reviewing its current values.
  - body: { id: string, name: string }
- `POST https://api.mcp.ai/api/cloudcart/update/customer/shipping/address` — Tool to update an existing customer shipping address in CloudCart. Use when you need to modify address details such as phone, name, or location fields. All update fields are optional - only provide th
  - body: { id: string, note?: string, phone?: string, city_name?: string, last_name?: string, post_code?: string, first_name?: string, street_name?: string, country_iso2?: string, street_number?: string, phone_country_iso2?: string }
- `POST https://api.mcp.ai/api/cloudcart/update/customer/tag` — Tool to update an existing customer tag in CloudCart. Use when you need to rename or modify a customer tag's label.
  - body: { id: string, tag: string }
- `POST https://api.mcp.ai/api/cloudcart/update/discount/code` — Tool to update an existing discount code in CloudCart. Use when you need to modify discount code properties such as the code value, discount amount, or activation status. At least one optional field m
  - body: { id: string, code?: string, value?: integer, active?: integer }
- `POST https://api.mcp.ai/api/cloudcart/update/linked/product` — Updates linked product relationships for a specific product in CloudCart. This replaces all existing linked products with the provided list. Use when you need to establish product recommendations or c
  - body: { product_id: string, linked_products: object[] }
- `POST https://api.mcp.ai/api/cloudcart/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.
  - body: { order_id: string, attributes: object }
- `POST https://api.mcp.ai/api/cloudcart/update/product` — Updates an existing product in CloudCart. Provide the product_id and at least one field to update. Returns updated product details. For variant-based products, price and stock are managed at the varia
  - body: { name?: string, price?: number, stock?: integer, images?: string[], product_id: string, description?: string }
- `POST https://api.mcp.ai/api/cloudcart/update/property` — Tool to update an existing property. Use when you need to modify property details such as display type, name, or visibility settings.
  - body: { id: string, name?: string, sort?: integer, active?: boolean, is_visible?: boolean, url_handle?: string, display_type?: string }
- `POST https://api.mcp.ai/api/cloudcart/update/property/option` — Tool to update an existing property option. Use when you need to modify an option value of a product property (e.g., changing "Red" to "Crimson Red" in a "Color" property).
  - body: { id: string, sort?: integer, value: string, seo_title?: string, url_handle: string, description?: string, seo_description?: string }
- `POST https://api.mcp.ai/api/cloudcart/update/subscriber` — Tool to update an existing subscriber in CloudCart. Use when you need to modify subscriber details like first name, last name, or country code. Provide the subscriber ID and the updated attributes.
  - body: { country: string, last_name: string, first_name: string, subscriber_id: string }
- `POST https://api.mcp.ai/api/cloudcart/update/subscriber/tag` — Tool to update an existing subscriber tag association in CloudCart. Use when you need to modify which subscriber or tag is associated in a subscribers-tags relationship.
  - body: { id: string, tag_id: string, subscriber_id: string }
- `POST https://api.mcp.ai/api/cloudcart/update/subscribers/channel` — Tool to update an existing subscriber channel in CloudCart. Use when you need to modify a subscriber's communication channel details such as contact information, marketing preferences, or verification
  - body: { id: string, bounced?: string, channel?: string, verified?: string, marketing?: string, subscriber_id?: string, channel_identifier?: string }
- `POST https://api.mcp.ai/api/cloudcart/update/variant` — Tool to update an existing product variant. Use when you need to modify variant details such as quantity, price, SKU, or other attributes.
  - body: { id: string, v1?: string, v2?: string, v3?: string, sku?: string, price?: integer, v1_id?: integer, v2_id?: integer, v3_id?: integer, weight?: integer, barcode?: string, item_id?: integer, minimum?: integer, unit_id?: integer, quantity?: integer, status_id?: integer, unit_value?: number, delivery_price?: integer, out_of_stock_id?: integer }
- `POST https://api.mcp.ai/api/cloudcart/update/variant/option` — Tool to update an existing variant option. Use when you need to modify a variant option's name, sort order, color, or visibility.
  - body: { id: integer, name?: string, sort?: integer, color?: string, visible?: integer }
- `POST https://api.mcp.ai/api/cloudcart/update/variant/parameter` — Tool to update an existing variant parameter for a product variant. Use when you need to modify attributes like display_type, name, sort order, or visibility.
  - body: { id: string, name?: string, sort?: integer, visible?: boolean, display_type?: string }
- `POST https://api.mcp.ai/api/cloudcart/update/vendor` — Updates an existing vendor's information in CloudCart. Use this to modify a vendor's name or image URL. You can update one or both fields. Requires a valid vendor ID - obtain this from Create Vendor o
  - body: { data: object }
- `POST https://api.mcp.ai/api/cloudcart/update/webhook` — Tool to update an existing webhook configuration in CloudCart. Use when you need to modify the webhook URL or custom request headers for webhook notifications. At least one optional field (url or requ
  - body: { id: string, url?: string, request_headers?: object }

## Example prompts
- "What can I do in Cloudcart?"
- "Show me a summary of my Cloudcart account"

## More
- Page: https://mcp.ai/cloudcart
- Agent spec (llms.txt): https://mcp.ai/cloudcart/llms.txt
- Postman collection: https://mcp.ai/cloudcart/postman.json