# commercetools MCP for AI Agents AI Agent Connect

> commercetools is a headless e-commerce platform that gives your AI agent direct access to your commerce data. Use it to manage products, track orders, and handle customer profiles without leaving your chat interface. It connects your backend to your agent so you can handle routine commerce tasks through plain English.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Endpoint:** https://edge.vinkius.com/vk_preview_oPleaiJX6EobE0vlBkJlkEtMx4fmqUiHd5W940VT/ai-agent-connect
- **Tags:** composable-commerce, cloud-native, product-catalog, order-management, api-driven, enterprise-ecommerce

## Description

This Connector lets you talk directly to your commercetools backend to handle the heavy lifting of running an online store. Instead of jumping between different tabs in a merchant dashboard, you can just ask your agent to find a specific order, update a product's status, or pull a list of recent customers. It's about getting answers and making changes in the flow of your work without the friction of manual navigation. You can use it to pull up customer profiles, check what's in stock, or see how your project is configured across different regions. It handles the technical details of the API so you don't have to worry about headers, authentication, or complex query structures every time you need a piece of data. Since Vinkius makes it easy to manage hundreds of these connections in one place, you can keep your commerce stack organized while your agent does the digging. It turns your commerce engine into a conversational interface where you can manage your entire catalog and order history without the usual data entry headaches. You can quickly see what's happening in your store right now, from active carts to completed purchases, all by asking a simple question. It bridges the gap between your commerce data and your daily communication, making it easier to stay on top of your inventory and sales.

## Tools

### get_order
Get every detail for a specific order. It helps you see exactly what a customer bought and where it stands.

### get_project_settings
See your general commercetools project configuration. It shows your supported languages and currencies.

### list_active_carts
See a list of all currently active shopping carts. This helps you track what people are looking at right now.

### list_customers
Pull a list of all customers in your store. This is great for high-level account auditing.

### list_orders
See all orders in your system. You can use this to get a bird's eye view of your recent sales.

### get_product
Pull up the full details for a single product. Use this to check specific attributes or pricing.

### list_categories
Get a list of all product categories. Use this to see how your catalog is structured.

### list_products
Get a list of every product in your catalog. Use this to quickly scan your inventory.

### search_orders_by_number
Find a specific order using its unique number. It's the fastest way to look up a customer's purchase.

### search_product_by_key
Find a specific product by its unique key. This is perfect for looking up internal items quickly.

## Prompt Examples

**Prompt:** 
```
Show me the first 20 products in my store.
```

**Response:** 
```
I've pulled the first 20 items from your commercetools catalog. Here they are:

| Product Name | Status | Price |
| :--- | :--- | :--- |
| Classic T-Shirt | In Stock | $25.00 |
| Denim Jeans | Low Stock | $80.00 |
| Running Sneakers | In Stock | $120.00 |

Would you like to see the details for any of these?
```

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

**Response:** 
```
Order **#10452** is currently marked as **Shipped**. It was placed on July 10th and is heading to the customer now.
```

**Prompt:** 
```
Which currencies does my store support?
```

**Response:** 
```
Your commercetools project is currently set up to accept payments in **USD** and **EUR**.
```

## Capabilities

### List all products in your catalog
Get a full overview of your current inventory items instantly.

### Find a specific order by its number
Locate any purchase details using the customer's unique order ID.

### Update order statuses in real-time
Change the progress of an order without manual dashboard clicks.

### Pull up customer profiles and details
Access customer records and configurations through a simple chat prompt.

### Check project settings like currency and language
See how your store is configured for different global markets.

### View all active shopping carts
Monitor what customers are currently looking at in your store.

### Get details on specific product categories
See how your catalog is organized and structured across the site.

## Use Cases

### Finding a lost order
A support agent asks the AI to find order #10452. The agent uses search_orders_by_number and reports the status immediately.

### Bulk catalog audit
An e-commerce manager wants to see all categories. The agent uses list_categories to show the full structure.

### Checking store config
A developer needs to see which currencies are active. The agent uses get_project_settings to pull the list.

### Inventory check
A manager asks for the first 20 products. The agent uses list_products to show the current stock.

## Benefits

- Stop digging through the Merchant Center. Use list_orders and search_orders_by_number to find data instantly.
- Get faster support responses. Support teams can use list_customers and get_order to verify info in seconds.
- Skip the curl scripts. Developers can use get_project_settings to see API responses without manual testing.
- Keep your catalog organized. Use list_categories and list_products to audit your store structure quickly.
- Monitor live shopping activity. Use list_active_carts to see what's happening in the store right now.

## How It Works

The bottom line is you get a conversational interface for your commerce backend.

1. Enter your commercetools Client ID and Secret into your Connector client.
2. Connect your commerce project to the Vinkius catalog.
3. Start asking your agent to fetch orders or manage products.

## Frequently Asked Questions

**What can I do with the commercetools MCP?**
You can use your AI agent to manage your entire commerce backend. This includes listing products, checking order statuses, and viewing customer profiles through natural conversation.

**Can I use this to manage my product catalog?**
Yes. You can ask your agent to list all products, show you specific categories, or find items by their unique keys to check details.

**How does this help with order processing?**
It allows you to retrieve order details and update statuses instantly. You can find specific orders by number without leaving your chat window.

**Can my support team use the commercetools MCP?**
Absolutely. Support agents can use it to verify customer info and check order history in seconds to provide faster assistance to shoppers.

**Does this Connector work with my existing commercetools project?**
Yes, it connects directly to your existing commercetools project. You just need to provide your API credentials to get started.

**Can I check my store settings with this?**
Yes. You can ask your agent to pull up your project settings, including supported languages and currencies, to see how your store is configured.

**How do I find my Client ID and Secret?**
You can create API Clients in the commercetools Merchant Center under Settings > Developer Settings > API Clients.

**What regions are supported?**
Common regions include us-central1.gcp, eu-central-1.aws, and others. Check your Merchant Center URL to find yours.

**Do I need a specific scope?**
This server typically requires 'manage_project' or equivalent read/write permissions to interact with products and orders.