# commercetools MCP

> The commercetools MCP lets you manage your entire e-commerce backend—products, orders, and customers—right through natural conversation with your AI client. Stop clicking through dashboards or writing cURL commands for routine data lookups. This connector gives your agent direct access to the composable commerce infrastructure, letting you get specific product details, list recent orders, track customer accounts, and even view project settings instantly.

## Overview
- **Category:** industry-titans
- **Price:** Free
- **Tags:** composable-commerce, cloud-native, product-catalog, order-management, api-driven, enterprise-ecommerce

## Description

Managing a modern online store means juggling complex data: product catalogs, fluctuating order statuses, and thousands of unique customer profiles. Instead of logging into the Merchant Center only to click through five different tabs just to find an invoice number or check inventory, this MCP connects your AI agent directly to that core commerce engine.

With this connection, you talk to your client—Claude, Cursor, or any other compatible service—and it handles the heavy lifting. You ask questions like, 'What were the three last orders from Customer X?' and get the full details back immediately. It’s about moving beyond manual lookups. When using Vinkius, this MCP lets you manage everything programmatically through chat, making your agent an integrated part of your day-to-day operations. You can pull product lists to check availability or inspect project settings without ever opening a browser tab.

## Tools

### get_order
Retrieves all the detailed information for one specific order number or ID.

### get_product
Pulls deep details about a single, named product from your catalog.

### get_project_settings
Gathers general configurations for the entire commerce platform setup.

### list_active_carts
Provides a current list of all shopping carts that are still open or active on your site.

### list_categories
Returns an overview listing every product category you have set up in the system.

### list_customers
Generates a list of all registered customer accounts within commercetools.

### list_orders
Grabs an overview and list of multiple recent order transactions.

### list_products
Returns a bulk list of all products available in your e-commerce catalog.

### search_orders_by_number
Specifically finds an order using only the customer-facing order number.

### search_product_by_key
Looks up a product immediately using its unique, system-defined internal key.

## Prompt Examples

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

**Response:** 
```
I've fetched the first 20 products from your catalog. The list includes 'Classic T-Shirt', 'Denim Jeans', and 'Running Sneakers'. Would you like the SKU details for any of these?
```

**Prompt:** 
```
List the last 10 orders in CommerceTools.
```

**Response:** 
```
Here are your latest 10 orders. Order #10452 is 'Confirmed', Order #10451 is 'Shipped', and the rest are 'Complete'. The total revenue from these orders is $1,250.
```

**Prompt:** 
```
Show the current settings and languages for my CommerceTools project.
```

**Response:** 
```
Your commercetools project 'my-store-prod' is currently configured to support 3 languages: English (en), Spanish (es), and Portuguese (pt). Supported currencies are USD and EUR.
```

## Capabilities

### Retrieve Product Details
Get specific information about any product using the get_product tool.

### Manage Order Records
Find and retrieve detailed records for individual orders, or list multiple recent transactions.

### Track Customer Accounts
List customer profiles to verify details or check general account status.

### Inspect Catalog Structure
List available product categories and retrieve a list of all current products.

### Check Store Configuration
View the global settings for your commerce project, including supported languages and currencies.

## Use Cases

### Investigating a Missing Order
A support agent gets a call from an upset customer. Instead of asking the user for account numbers and then manually searching, they simply ask their agent to search_orders_by_number using the number provided by the caller. The agent instantly retrieves the full order record, resolving the issue in seconds.

### Checking Catalog Consistency
A developer needs to know if a new product line was added correctly. They use list_products and then get_product for specific items, comparing the API response data against what they remember from the backend UI without writing any code.

### Pre-launch Site Audit
An operations manager needs to verify that all required store settings are configured before going live. They use get_project_settings to check supported languages and currencies in one chat command, confirming the site's readiness.

### Analyzing Abandoned Carts
A marketing specialist wants to run a campaign on cart abandoners. They ask their agent to list_active_carts, getting a clean list of IDs they can use immediately for targeted follow-up emails.

## Benefits

- Instead of navigating multiple admin dashboards to check product availability, you ask your agent directly. You can use list_products or search_product_by_key to confirm inventory status in seconds.
- You don't need Postman for simple checks anymore. Asking the agent to get_order or search_orders_by_number pulls complex order data—like shipment tracking and line items—directly into your chat window.
- Support teams can verify customer details instantly by calling list_customers, providing accurate information without having to manually look up accounts in a separate CRM system.
- Need to know what languages or currencies are supported? Calling get_project_settings immediately tells you the current global parameters for your store setup.
- If you're managing live sales, you can use list_active_carts to see which shoppers have abandoned their carts, letting your team follow up faster.

## How It Works

The bottom line is you stop using complex web interfaces for simple queries, and start talking directly to your commerce system via chat.

1. Subscribe to this MCP on Vinkius and supply your unique commercetools Client ID and Secret credentials.
2. Your AI client authenticates the connection and grants your agent access to your commerce backend tools.
3. You prompt your agent with a natural language request (e.g., 'List all orders from last week'), and it executes the necessary tool calls to pull the data.

## Frequently Asked Questions

**How do I use commercetools MCP to find a customer's order?**
You have two options: list_orders for general browsing, or search_orders_by_number if you know the specific public order number. If you need details on that single transaction, always follow up by using get_order.

**Can commercetools MCP list all products?**
Yes, use list_products to retrieve a comprehensive overview of everything in your catalog. You can then pinpoint specifics with search_product_by_key if you know the exact key.

**Is get_project_settings useful for support teams?**
It helps confirm basic operational parameters, like which currencies or languages are supported by your store setup. This is useful when a customer asks about international billing options.

**What is the difference between list_orders and search_orders_by_number using commercetools MCP?**
list_orders provides an overview of multiple recent transactions, while search_orders_by_number is designed to find a single order using only its external customer-facing number.

**Do I need API keys for the commercetools MCP?**
Yes. When you subscribe to this MCP, you must provide your commercetools Client ID and Secret credentials so your agent can authenticate with your live commerce backend.