# Commerce Layer MCP

> The Commerce Layer MCP manages your entire global e-commerce backend through natural conversation. Connect to your store's data to manage everything from listing products and checking inventory levels to creating draft orders and tracking shipments across multiple international markets. It puts full control of complex transactional workflows directly into your AI agent.

## Overview
- **Category:** ecommerce
- **Price:** Free
- **Tags:** headless-commerce, sku-management, order-lifecycle, inventory-tracking, global-shopping, api-first

## Description

This connector lets you take over your global e-commerce operations without writing a single line of API code. Instead of digging through complex dashboards or building multi-step JSON queries, you just talk to your agent. Your AI acts as a dedicated commerce architect, coordinating data points like customer profiles, current prices across different regions, and real-time inventory levels. Need to know if an order is ready? You ask the agent, and it checks the fulfillment status. Want to update product pricing for a new market? The agent handles that coordination for you. By connecting this MCP through Vinkius, your AI client gains immediate access to all transactional data needed to manage everything from initial cart creation to final payment processing. It turns your complex, multi-system backend into simple, conversational commands.

## Tools

### create_order
Generates a new draft shopping cart that a user can populate with items.

### get_order
Retrieves the specific details and status for an existing order ID.

### list_addresses
Pulls a list of all registered organizational addresses associated with your account.

### list_customers
Provides a directory listing of every customer registered in the system.

### list_markets
Shows all available global markets and regional settings for your business.

### list_orders
Lists a comprehensive overview of every sales order ever placed through the platform.

### list_payment_methods
Retrieves all supported payment types available for checkout in any given market.

### list_prices
Fetches and lists the current selling prices associated with specific SKUs.

### list_promotions
Lists all currently active promotional rules or discount codes that can be applied to orders.

### list_shipments
Provides the current tracking and status details for various shipped orders.

### list_skus
Generates a complete directory listing of all sellable products (SKUs) in your catalog.

### list_webhooks
Lists and summarizes the active system webhooks that handle automated data flow.

## Prompt Examples

**Prompt:** 
```
List all sellable SKUs in my organization.
```

**Response:** 
```
I've retrieved your SKU directory. You currently have 5 active products, including 'Standard-Tee' (ID: sku_1) and 'Premium-Hoodie'. Would you like the current prices for these items across your markets?
```

**Prompt:** 
```
Show the details and status for order ID 'ord_123'.
```

**Response:** 
```
Fetching order ord_123... The status is currently 'Placed' and awaiting fulfillment. The total is $125.00 for 'customer@example.com'. Shall I check the assigned shipment status?
```

**Prompt:** 
```
Create a new draft order for 'jane@example.com'.
```

**Response:** 
```
Draft order created! I've initialized a new cart for Jane Doe (ID: ord_456). She can now add items to this session. Would you like me to list the available payment methods for her market?
```

## Capabilities

### Manage the full order lifecycle
Create draft shopping carts and track an order's status from placement through fulfillment and payment.

### Check current inventory and pricing
See which products are available, check their sellable SKUs, and list the active prices across various markets.

### Identify customers and locations
Retrieve complete customer profiles, save addresses, and view all organizational sites in different markets.

### Handle logistics and promotions
Monitor active shipments or manage promotional rules and discounts for sales operations.

### Automate webhooks management
View and manage the list of automated system hooks without leaving your workspace.

## Use Cases

### Checking if a product price changed in another region.
An E-commerce Manager needs to know the current cost of 'Product X' for Germany. Instead of checking three separate market dashboards, they ask their agent. The agent uses `list_prices` and `list_markets` combined to give one accurate answer.

### Tracking a high-value order that is stuck.
A customer calls about an old purchase. Instead of requiring the customer to provide an ID, the agent uses `get_order` by finding the user's email address, immediately showing them the status and next steps.

### Setting up a new temporary promotion.
An Ops Engineer wants to test a 20% discount for one day. They ask the agent to check `list_promotions` first, ensuring no conflicts with existing rules before setting up a new deal.

### Reviewing all customer accounts that need follow-up.
A Customer Success Team member needs to see every user who signed up in the last month. They ask the agent to use `list_customers`, getting a clean, actionable list for immediate outreach.

## Benefits

- Stop manually checking order status. You can use the `get_order` tool to instantly pull up any specific order's details, including its current payment and fulfillment state.
- Keep your catalog accurate across regions. The agent uses `list_skus` and `list_prices` together so you always know what products are available and how much they cost right now.
- Coordinate complex checkouts effortlessly. By asking the agent to draft a cart, it handles the setup using `create_order`, saving you from having to manually build out checkout data.
- Understand your global footprint. You can use `list_markets` to see every region you operate in and what currencies are supported without navigating multiple backend settings pages.
- Manage logistics visibility. Checking active shipments is simple; the agent uses `list_shipments` to give you real-time tracking updates, eliminating status guesswork.

## How It Works

The bottom line is that you get full control over complex e-commerce data using simple chat commands, not code.

1. First, subscribe to this MCP on Vinkius.
2. Next, grab your Client ID, Client Secret, and Organization Slug from your Commerce Layer dashboard settings.
3. Finally, give those credentials to any MCP-compatible client—Claude, Cursor, or Windsurf—and start managing transactions conversationally.

## Frequently Asked Questions

**How can I check inventory using the Commerce Layer MCP?**
You list available products and their stock levels by calling `list_skus`. This gives you a full, accurate snapshot of every sellable item in your catalog.

**Does Commerce Layer MCP help with multiple currencies?**
Yes. By listing markets using `list_markets`, the agent understands regional settings and can retrieve prices and track transactions across different global currencies for you.

**Can I see all past orders in the Commerce Layer MCP?**
Absolutely. The `list_orders` tool provides a comprehensive overview of every single sales order that has ever passed through your platform.

**What if I need to create an initial cart using Commerce Layer MCP?**
You simply ask the agent to create it, triggering the `create_order` tool. It initializes a new draft shopping cart that you can then populate with items.

**How do I get payment options for a customer's region?**
Use the `list_payment_methods` tool. This retrieves all accepted ways to pay, ensuring your checkout experience is perfectly coordinated for that specific market.