# OpenCart MCP

> OpenCart MCP connects your entire e-commerce backend to your AI agent. Manage orders, check inventory levels, look up customer profiles, and update fulfillment statuses—all through natural conversation without ever having to log into the admin panel.

## Overview
- **Category:** business-operations
- **Price:** Free
- **Tags:** order-management, product-catalog, inventory-tracking, customer-management, fulfillment

## Description

Managing an online store shouldn't require juggling logins and clicking through dozens of tabs. This MCP turns your OpenCart e-commerce system into a conversational command center for your AI client. Instead of navigating complex dashboards, you just ask your agent what you need. You can list all products to check stock levels, get detailed information on specific orders by ID, or pull up full customer profiles instantly. Need to update an order status? Simply tell your agent to mark it as shipped and add a tracking number. This capability lets support teams quickly look up past purchases during live chat or allows fulfillment staff to process multiple status changes without clicking through forms. By connecting this MCP via the Vinkius catalog, you give any compatible AI client immediate access to these core functions, letting your agent handle everything from checking product category structures to running basic cart inspections for custom orders.

## Tools

### list_products
Retrieves metadata for active OpenCart products, including prices, stock status, and SEO tags.

### get_product
Fetches all detailed information for a single product using its unique ID.

### list_orders
Retrieves a list of current OpenCart orders, including totals and payment methods.

### get_order
Gets the complete details for an open cart order using its explicit ID.

### get_order_history
Retrieves the full status history of an order, useful for tracking fulfillment changes or verifying shipments.

### list_customers
Lists all registered customers who have accounts in OpenCart.

### get_customer
Retrieves the full profile details for a single customer using their explicit ID.

### list_categories
Displays the current product category hierarchy and navigation structure for your store.

### add_order_history
Updates an order’s status history, allowing you to mark shipments as complete or cancel orders.

### get_cart
Checks the contents of the current shopping cart session for programmatic checkout testing.

## Prompt Examples

**Prompt:** 
```
Show me all orders placed this week with their totals.
```

**Response:** 
```
Found 23 orders this week totaling $4,850. Top order: #1247 — $620 (3 items, paid via Stripe, status: Processing). 18 orders are Complete, 3 Processing, and 2 Pending. Want me to pull the details for the pending ones?
```

**Prompt:** 
```
Mark order #1052 as shipped with tracking number TRK-9876.
```

**Response:** 
```
Done. Order #1052 status updated to 'Shipped' with comment: 'Tracking: TRK-9876'. The customer will receive an email notification if your store has that enabled. Want me to check the other pending orders?
```

**Prompt:** 
```
Look up customer #42 and show me their full profile.
```

**Response:** 
```
Customer #42: Sarah Johnson (sarah@example.com). Registered: Jan 15, 2024. Newsletter: subscribed. Default address: 456 Oak Ave, Portland, OR 97201. 12 orders placed, total lifetime value: $2,340. Last order: March 28 (#1241). Want me to pull that order's details?
```

## Capabilities

### Check and list products
Fetch lists of active inventory items or retrieve the full details for a single product by ID.

### Manage customer data
List all registered users or pull up complete profiles, including addresses and purchase history.

### Review order specifics
Get a list of current orders with totals and payment methods, or retrieve the full details for one specific order.

### Track shipment status changes
Update an order's history to mark it as complete, canceled, or shipped, adding required comments.

### Examine product organization
View the entire structure of your product categories and navigation hierarchy.

## Use Cases

### Investigating an unusual shipment delay.
A customer reports their order hasn't moved. You ask your agent to check the order history using `get_order_history` for that specific ID. The agent immediately shows you if the status changed from 'Processing' to 'Shipped' but never sent a tracking number, letting you reply instantly.

### Auditing inventory before a major sale.
You need to know which product lines are running low. You ask your agent to run `list_products`, getting back the stock status and pricing for every item, allowing you to quickly identify bottlenecks across multiple categories.

### Handling a bulk cancellation request.
A customer needs to cancel three different pending orders. You ask your agent to run `get_order` on all three IDs and then use the `add_order_history` tool to update their status to 'Cancelled' in one go.

### Validating a custom checkout workflow.
Before writing new code, you need to verify what products are currently in an API session cart. You use the `get_cart` tool, which instantly shows you exactly what items and quantities are mapped for programmatic checkout.

## Benefits

- Check daily sales and product stock without logging into the admin panel. You can list all products or use `get_product` to check a specific item's details, keeping your focus on conversation.
- Support teams gain instant access to customer data; instead of asking for credentials, you just ask your agent to run `get_customer` and pull up their full profile, including addresses and newsletter status.
- Fulfillment staff can manage inventory updates in bulk. Use the MCP to call `add_order_history` and push a 'Shipped' or 'Complete' status update with comments, all via text chat.
- Quickly understand product organization by using `list_categories`. You get an immediate view of your entire site structure without clicking through every menu item.
- Avoid manual data entry. The MCP lets you query multiple datasets—like listing orders and then getting the detailed line items for a specific ID via `get_order`—in one seamless conversation.

## How It Works

The bottom line is that your AI client talks directly to OpenCart using these tools; you never touch a dashboard.

1. Subscribe to this MCP, providing your OpenCart Store URL, API Username, and API Key.
2. Connect the credentials to your preferred AI client (like Claude or Cursor).
3. Tell your agent what you need—for example, 'Show me all orders placed last week with their totals.' — and it executes the necessary calls.

## Frequently Asked Questions

**Can I use OpenCart MCP to check product stock levels?**
Yes. You can run the `list_products` tool to get a list of all active products and their current stock status, or use `get_product` for just one item.

**How do I update an order's shipping status with OpenCart MCP?**
You must use the `add_order_history` tool. This function allows you to push status transitions, like marking it 'Shipped,' and include a comment or tracking number.

**Does OpenCart MCP give me access to customer addresses?**
Yes. You can run `get_customer` by ID, which returns the full details including their registered default address and custom fields.

**Can I list all products and their SEO tags using OpenCart MCP?**
The `list_products` tool fetches metadata for active products. This includes pricing, stock status, and basic SEO tags mapped in the product repository.

**What is the difference between list_orders and get_order with OpenCart MCP?**
`list_orders` gives you a summary of multiple orders (totals, payment methods). `get_order` requires an explicit ID and returns all the comprehensive details for just that single order.