# CloudCart MCP MCP

> CloudCart lets you manage your entire e-commerce backend directly through natural conversation. Track products, monitor order fulfillment status, audit abandoned carts, and view customer history without ever opening the CloudCart dashboard. You get a complete operational picture of your store from any AI agent.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** online-store, product-catalog, order-processing, sku-management, e-commerce-platform, customer-orders

## Description

Managing an online store means jumping between inventory dashboards, order tracking pages, and customer databases. This MCP connects all that data to your natural language workflow. Instead of clicking through multiple tabs to see what products are selling or if those abandoned carts need a follow-up email, you just ask. You can list every product in stock, check the status of large batches of orders, and look up specific customer details instantly. It gives you full command over everything from listing store brands to checking out old shopping baskets. If your AI workflow runs through Vinkius, this MCP ensures you have deep visibility into all your e-commerce operations, letting you focus on strategy instead of data retrieval.

## Tools

### get_abandoned_carts
Pulls a list of shopping carts that were started but never completed by a customer.

### get_order_store_details
Retrieves full, specific details for one particular order ID.

### get_product_store_details
Gets the detailed information for any single product in your catalog.

### list_store_brands
Lists every product brand that is currently configured and used in your store.

### list_store_categories
Lists all the organizational categories you use to sort products on your site.

### list_store_customers
Retrieves a list of every registered customer profile in your store database.

### list_store_orders
Lists all customer orders placed in the store, giving you an overview of recent activity.

### list_store_products
Lists every product currently available in your entire store catalog.

## Prompt Examples

**Prompt:** 
```
List all products in my CloudCart store.
```

**Response:** 
```
Retrieving your product catalog... I found 5 items: 'Smartphone X' (SKU: SPX-01), 'Laptop Pro' (SKU: LP-2026), and 3 others. Would you like to see the inventory for any of these?
```

**Prompt:** 
```
Show me the last 5 orders.
```

**Response:** 
```
Checking recent orders... You have 5 new orders today. #1001 (Processing), #1002 (Shipped), #1003 (Paid), and 2 others. Total revenue from these is $850.00.
```

**Prompt:** 
```
What is the status of order ID 'order_98765'?
```

**Response:** 
```
Retrieving details for order 98765... The order is currently 'Shipped' and was picked up by the courier yesterday. The customer has been notified.
```

## Capabilities

### Get Order Status
Retrieves complete details for any specific order ID, including items and fulfillment status.

### Audit Shopping Carts
Pulls a list of shopping carts that were started but never completed by the customer.

### Manage Product Inventory Data
Lists all items in your entire catalog, giving you SKUs and pricing details.

### Track Customer History
Accesses registered customer profiles along with a history of their interactions with the store.

### Organize Store Content
Lists all available product categories and brands used throughout your catalog.

## Use Cases

### Investigating low sales volume
A marketing analyst notices a sudden dip in revenue for 'Electronics'. They ask their agent to use `list_store_products` and filter by category, then cross-reference the results with `get_abandoned_carts` to see if product visibility or pricing is the issue.

### Handling a high-value support call
A customer calls demanding status on their recent order. Instead of asking for an ID, the agent asks the system to `list_store_orders` by last name, finds the correct order ID, and then uses `get_order_store_details` to confirm shipping status instantly.

### Pre-launch catalog check
An inventory manager needs to ensure a new line of 'Outdoor Gear' is properly categorized. They run `list_store_categories`, verify the structure, and then use `list_store_brands` to confirm all necessary brands are present before adding stock.

### Identifying customer trends
A store owner wants to know who bought similar items recently. They first run `list_store_customers`, and then use that data in conjunction with the order history (`list_store_orders`) to build a segmentation list for email marketing.

## Benefits

- Instantly audit abandoned carts. Instead of manually sifting through backend reports, you can use `get_abandoned_carts` to see exactly which customers left items behind, letting your team follow up immediately.
- Deep dive into any specific sale. If a customer asks about Order #12345, the agent uses `get_order_store_details` to provide instant status updates without you leaving the chat window.
- Keep track of who's buying what. By using `list_store_products` and then `get_product_store_details`, you can verify product metadata (like pricing or SKU) against your current marketing plan in seconds.
- Maintain catalog structure visibility. You can quickly run `list_store_categories` or `list_store_brands` to ensure all new products are slotted into the right place before launch, preventing organizational debt.
- Support agents gain instant knowledge. They use `list_store_customers` to pull up a client's full history and associated orders (`list_store_orders`) in one smooth interaction.

## How It Works

The bottom line is that you tell your AI client what you need in plain English, and it handles the complex API calls to get the exact data back.

1. Subscribe to this MCP, then provide your CloudCart Client ID, Client Secret, and Store Domain.
2. Your AI client connects using those credentials, granting it read access to your store's core data.
3. You prompt your agent with natural language requests, like 'List all products priced over $50.' The MCP executes the query and returns structured results.

## Frequently Asked Questions

**Can I use list_store_products to check if a product is in the correct category?**
No, `list_store_products` only lists the items. To see what categories they belong to, you should run `list_store_categories` first and then manually verify the relationship. The tool doesn't cross-reference them.

**How do I get details for a specific order using get_order_store_details?**
You provide the unique, identifying order ID in your prompt. The agent then uses `get_order_store_details` to pull back everything related to that transaction—items purchased, final price, and status.

**Is list_store_customers enough for marketing segmentation?**
No. While `list_store_customers` gives you the profile name, it doesn't give purchase history. For that, you must combine this tool with `list_store_orders` to build a complete customer view.

**Can I check product details using get_product_store_details if I only have an SKU?**
Yes. The tool accepts the specific product identifier, like an SKU or unique ID. It then returns all associated metadata, including price and brand information.

**How do I use `get_abandoned_carts` to find specific customers who haven't purchased in 7 days?**
The tool returns a list of all abandoned carts. You process this data outside the chat environment, filtering for cart age and associated customer IDs to generate your follow-up list.

**When I run `list_store_brands`, does it include brands that are no longer active in the catalog?**
It lists all configured product brands. The tool shows you every brand associated with your store, so you can verify which ones need to be marked inactive manually.

**Does `list_store_categories` help me map out my entire product taxonomy structure?**
Yes, it retrieves all defined categories. The output helps visualize the hierarchy of your store's organization, letting you see parent and sub-categories at a glance.

**If I use `list_store_orders` to check bulk order data, are there rate limits or pagination options?**
The MCP handles large datasets by paginating results. If you query an excessive volume of orders in one request, the system will prompt you to continue fetching data in batches.

**Can I see a list of abandoned carts through the agent?**
Yes! Use the `get_abandoned_carts` tool. The agent will return all recent shopping sessions that were not completed, allowing you to plan recovery campaigns.

**How do I check the stock status or SKU for a product?**
Use the `list_store_products` tool to see a summary, or `get_product_store_details` with the product ID for detailed inventory information.

**Where do I find my CloudCart API credentials?**
Log in to your CloudCart admin panel, navigate to **Settings**, and select **API Keys**. You can generate a new Client ID and Client Secret there.