# OpenCart MCP for AI Agents AI Agent Connect

> OpenCart MCP connects your e-commerce store to your AI agent. Browse products, manage orders, track customers, and update fulfillment statuses through natural conversation without ever opening your admin panel.

## Overview
- **Category:** business-operations
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_EfktxooGIXXTjzAJxrwWn0FzNp6L9OZazw5HST2Y/ai-agent-connect
- **Tags:** order-management, product-catalog, inventory-tracking, customer-management, fulfillment

## Description

This Connector connects your OpenCart backend to your AI client, letting you manage your store through a natural conversation. Instead of digging through menus, you can ask your agent to find a specific order, pull up a customer's history, or see what's currently in stock. It handles the heavy lifting of navigating your product catalog and order records so you can focus on running the business. You can even push status updates like Shipped or Cancelled directly through your AI interface. Having this in your Vinkius catalog makes it easy to keep your store operations moving without the constant tab-switching. It's about turning your e-commerce backend into a command center where you just tell the agent what needs to happen next. You get direct access to your data and the ability to move orders through your pipeline as fast as you can type.

## Tools

### get_product
Pull every detail for a specific product using its unique ID. This is useful for deep-diving into a single item.

### list_orders
See a list of all orders from your store. Use this to get a high-level view of recent sales activity.

### get_order
Fetch specific details for one order using an ID. This helps you see exactly what a customer bought and where it's going.

### get_order_history
View the full history of status changes for a specific order. Use this to verify tracking logic or fulfillment steps.

### list_categories
See how your product categories are organized. Use this to understand your store's navigation structure.

### add_order_history
Mark an order as shipped or cancelled and add a comment. This tool pushes updates to your order history.

### get_cart
See what's currently in the active session cart. Use this to verify product mapping before custom checkout logic.

### list_products
Get a list of all active products including prices and stock levels. Use this to see what's currently available for sale.

### list_customers
See a list of all registered customers in your database. This helps you manage your user base quickly.

### get_customer
Pull a full profile for a customer including their address and history. This is perfect for personalized support.

## Prompt Examples

**Prompt:** 
```
What's the status of order #5521?
```

**Response:** 
```
Order **#5521** is currently in the **Processing** status. 

*   **Date Placed:** Oct 12, 2023
*   **Total:** $142.50
*   **Payment:** Paid via Stripe
*   **Notes:** Awaiting shipment.

Would you like me to update the status to Shipped?
```

**Prompt:** 
```
Is the blue ceramic vase in stock?
```

**Response:** 
```
Yes, the **Blue Ceramic Vase** is currently in stock. 

*   **Quantity:** 14 units
*   **Price:** $45.00
*   **Status:** Active

I can also pull up the full product details if you need the SEO tags or category info.
```

**Prompt:** 
```
Show me the details for customer #88.
```

**Response:** 
```
Here are the details for **Customer #88**: 

*   **Name:** Jane Doe
*   **Email:** jane.doe@example.com
*   **Newsletter:** Subscribed
*   **Default Address:** 123 Maple St, Austin, TX 78701
*   **Total Orders:** 12

Would you like to see their last order?
```

## Capabilities

### Browse your product catalog
Fetch active products with pricing, stock levels, and SEO tags.

### Fetch order details
Get full order information including totals and payment methods by ID.

### Update order statuses
Push status transitions like Shipped or Complete with custom notes.

### Look up customer profiles
Retrieve registered customer details, addresses, and newsletter status.

### View category structures
See how your product categories are organized and navigated.

### Inspect session carts
Check current API session cart contents for custom checkout workflows.

## Use Cases

### Live Support Response
A customer asks where their package is. Use get_order to find the tracking info and get_customer to see their shipping address quickly.

### Inventory Monitoring
You need to know if a hot item is out of stock. Use list_products to check current stock levels across your entire catalog.

### Bulk Fulfillment Updates
You finished a batch of shipments. Use add_order_history to mark them all as shipped with the correct tracking numbers.

### New Customer Onboarding
A new customer signs up. Use get_customer to see their profile details and check if they are subscribed to your newsletter.

## Benefits

- Faster order lookups: Use get_order to find shipment details in seconds instead of filtering through pages.
- Easier status updates: Use add_order_history to push updates without manual clicks in the admin panel.
- Better customer service: Use get_customer to see profile data and addresses instantly during a support call.
- Quick stock checks: Use list_products to see what's available in your catalog without opening the inventory tab.
- Simplified category management: Use list_categories to see your store structure at a glance.
- Streamlined cart verification: Use get_cart to check session data for custom checkout workflows.

## How It Works

The bottom line is you get a voice-activated dashboard for your OpenCart store.

1. Subscribe to the OpenCart MCP on the Vinkius marketplace.
2. Enter your OpenCart Store URL, API Username, and API Key.
3. Ask your AI client to find orders, check stock, or update shipping statuses.

## Frequently Asked Questions

**Can I use the OpenCart MCP to update shipping info?**
Yes, you can use it to push status updates like Shipped or Cancelled and add custom comments to the order history.

**Does the OpenCart MCP let me see my products?**
It allows your AI to browse your entire catalog, check current stock levels, and view pricing for any item.

**How do I connect my store to the OpenCart MCP?**
You just need to provide your store URL and your API username and key from your OpenCart admin panel.

**Can I look up customer addresses with this?**
Yes, your agent can fetch full customer profiles, including their default shipping addresses and newsletter status.

**Can the OpenCart MCP handle my entire store?**
It is designed for managing orders, products, and customers. Some administrative tasks like deleting items still require the dashboard.

**Can my AI agent update order statuses — like marking an order as shipped?**
Yes. The add_order_history tool pushes a new status entry to any order. Provide the order ID, the OpenCart status ID (e.g., 3 for Shipped), and an optional comment. The status change appears immediately in the admin panel and triggers any configured email notifications.

**Does it work with any OpenCart version?**
This integration uses the native OpenCart REST API available in OpenCart 2.x and later. If your store is running OpenCart 1.x, the API endpoints won't be available. For OpenCart 3.x and 4.x, the API user setup is the same — just ensure the API user is enabled in System > Users > API.

**What about IP restrictions — will the API reject requests?**
OpenCart's API enforces an IP whitelist by default. When creating your API user, add the IP address of your server to the 'IP Addresses' tab. If you're running through a cloud proxy, add that proxy's IP. Without this step, all API requests will be rejected with a permission error.