# CS-Cart MCP for AI Agents MCP

> CS-Cart connects your entire e-commerce or multi-vendor marketplace to any AI agent. Use this MCP to manage products, track complex orders, audit vendor accounts, and check tax rules—all through natural conversation. It gives you direct control over store operations without logging into the admin panel.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** online-store, marketplace, product-management, order-tracking, vendor-management, retail-operations

## Description

Your AI client can treat your CS-Cart platform like a conversational employee. Instead of navigating deep menu structures or copying IDs from various tabs, you just talk to it. You get full command over everything: listing inventory details, finding out why an order is stuck, or verifying if a vendor meets operational limits.

Need to know the tax structure for goods shipped to France? Ask the agent. Need to check which users have admin permissions? Ask the agent. This MCP pulls all that data together from your backend. You connect this through Vinkius and give your AI client the power it needs to run complex e-commerce checks on demand. It’s like having a real-time, searchable database of every piece of information in your store—without needing an IT person to write custom scripts.

## Tools

### list_products
Retrieves product IDs, names, prices, stock levels, and associated vendor identifiers across your store.

### get_product
Fetches full details for a single product ID, including feature options, tax rules, and pricing boundaries.

### list_orders
Generates an overview of recent orders, showing totals, payment statuses, shipping methods, and transaction timestamps.

### get_order
Retrieves detailed line items for a specific order ID, including applied taxes, shipping costs, and customer addresses.

### list_users
Lists all user accounts (Customers, Admins, Vendors), providing roles, email addresses, and account creation dates.

### list_categories
Provides a list of product categories, including their IDs, names, parent/child relationships, and SEO identifiers.

### list_vendors
Lists all registered marketplace vendors or companies, providing contact info, profiles, and current operational status.

### list_shippings
Shows available shipping methods configured in your store, along with carrier names and supported delivery regions.

### list_taxes
Retrieves a list of tax rules and rates applied to the store, including their percentage rate and geographic application details.

### list_statuses
Lists all defined order statuses used in your system, mapping human-readable names to internal code identifiers.

## Prompt Examples

**Prompt:** 
```
Show me the details and current stock levels for product ID 1024.
```

**Response:** 
```
**Product Details: Modern Desk Lamp**
*   **Price:** $45.00 (MSRP)
*   **Stock Level:** Available (Qty: 187 units)
*   **Features:** Includes LED base and USB charging port.
*   **Tax Applied:** 7% (State rate).

This item is ready to ship.
```

**Prompt:** 
```
What are the total contents and status for order #987?
```

**Response:** 
```
**Order Summary: #987**
*   **Status:** Paid (P)
*   **Total Billed:** $120.00
*   **Items:** 2 units (Item A: $50.00; Item B: $70.00)
*   **Shipping Method:** FedEx Ground ($10.00).
*   The customer's billing address is confirmed in the system.
```

**Prompt:** 
```
Who are all the active sellers and what's their status?
```

**Response:** 
```
**Active Marketplace Vendors (3 found):**
1.  TechWorld Solutions: *Status:* Active, Full Capability.
2.  Green Garden Supplies: *Status:* Restricted (Requires Tax Audit).
3.  Fashion Hub: *Status:* Dormant.
```

## Capabilities

### Product Data Lookup
Retrieve detailed product information, including current stock levels, pricing options, and feature combinations.

### Order Status Investigation
Get a complete overview of recent sales or drill down into specific order details like payment status, shipping methods, and line-item costs.

### Vendor & User Auditing
List all active marketplace vendors, check their operational statuses, or manage user accounts by listing administrators and customer roles.

### Financial Rule Verification
Look up configured tax rates, VAT rules, and available shipping carrier rates to verify compliance for any transaction.

## Use Cases

### A Support Agent Needs Order Details
A support agent needs to resolve a billing dispute for order #456. They ask their AI client, which uses get_order, and instantly receive the line-item breakdown, confirming that the tax applied was correct according to the customer's region.

### The Ops Team Checks Vendor Compliance
A marketplace operator suspects a vendor might be inactive. They run list_vendors via their agent and quickly identify all active seller companies, cross-referencing them with current operational limits to flag potential issues.

### Product Pricing Audit
The purchasing manager needs to know the full price options for a new product line. They ask the agent to use get_product, which returns not only the base price but also all associated feature combinations and tax rules.

### New User Onboarding
A team member needs to know who is allowed to perform what actions. They simply ask for a list of users via list_users, which immediately distinguishes between 'Customer', 'Admin', and 'Vendor' roles.

## Benefits

- Audit vendor lists instantly. Instead of going to the Vendor tab, you can use list_vendors to check seller statuses across thousands of storefronts using natural language.
- Handle complex order queries faster. Get a full picture of any sale by running get_order, which immediately provides line items, taxes, and shipping costs in one go.
- Stay compliant with tax rules. Never guess on pricing again; list_taxes gives you the exact percentage rate and geographic application rule needed for accurate billing.
- Simplify inventory management. Use list_products to quickly check product IDs, current stock levels, or even find out which vendor owns a specific item.
- Resolve customer issues immediately. Need to know what shipping options are available? list_shippings gives you the carrier names and rates right away.

## How It Works

The bottom line is that you set up the connection once, and then use natural language in your AI client to manage everything else.

1. Subscribe to this MCP on Vinkius. You'll need your CS-Cart Store URL, Admin Email, and API Key.
2. Enter those credentials into your preferred AI client (like Cursor or Claude).
3. Your agent can now access all the defined tools to answer complex questions about your store data.

## Frequently Asked Questions

**How does the CS-Cart MCP help with general marketplace operations?**
It centralizes all your core e-commerce data into one conversational interface. You can list active vendors, check product stock levels, and audit user roles without ever having to navigate the complex admin menus.

**Can I use this MCP to verify taxes for a new sale?**
Yes. The MCP lets you look up configured tax rules using list_taxes. You can confirm the correct percentage rate and check if any geographic restrictions apply before finalizing a quote.

**Is CS-Cart MCP only for viewing data, or can I do more?**
It is designed entirely for reading and auditing data. You can retrieve comprehensive reports on orders (get_order), inventory, and vendor details using natural language prompts.

**What if I need to find the total number of products in my store?**
You can list products to get a count and overview. The MCP pulls product IDs, names, and stock counts instantly, letting you survey your whole catalog quickly.

**Does this tool help with customer support inquiries about shipping?**
Absolutely. You can use the agent to list available shipping methods (list_shippings) or get a specific order's details to confirm which carrier and rate was applied during checkout.