Commerce

Commerce MCP provides a server that lets you connect commercetools APIs with various agent frameworks through function calling. It supports both local (stdio) execution and remote HTTP endpoints, enabling you to run in development or production environments with flexible authentication options.

How to use

You run the MCP server and connect it to your chosen MCP client or agent framework. Start the server in stdio mode to host a local MCP server process that your client can talk to directly. Alternatively, run a remote HTTP MCP server and point your client at its URL. In either mode you choose specific tools to enable read, create, and update operations across commercetools resources such as products, categories, carts, orders, and more. The server supports authentication via client credentials or a pre-existing access token, and you can enable dynamic tool loading to optimize performance when many tools are active.

How to install

Prerequisites: Node.js 18+ installed on your machine.

# 1) Install the MCP runtime locally (stdio mode example)
npx -y @commercetools/commerce-mcp --tools=all --clientId=CLIENT_ID --clientSecret=CLIENT_SECRET --projectKey=PROJECT_KEY --authUrl=AUTH_URL --apiUrl=API_URL

# 2) Start the server in remote/streamable HTTP mode (optional example)
npx -y @commercetools/commerce-mcp \
  --tools=all \
  --authType=client_credentials \
  --clientId=CLIENT_ID \
  --clientSecret=CLIENT_SECRET \
  --projectKey=PROJECT_KEY \
  --authUrl=AUTH_URL \
  --apiUrl=API_URL \
  --remote=true \
  --stateless=true \
  --port=8888

# 3) To connect Claude or another client to a local HTTP MCP endpoint, use the URL http://localhost:8888/mcp

Additional sections

Dynamic tool loading is available to optimize performance when many tools are enabled. The server defaults to a threshold of 30 tools; when you exceed this, the server switches to dynamic loading.

Key configuration options include authentication mode (client_credentials or auth_token), which tools to enable (for example, all tools or specific tool sets like products.read, products.create, etc.), and the remote/streamable HTTP mode for remote servers. To tailor the server for Claude or other clients, you can provide a JSON configuration that maps an MCP server name to its command and arguments.

Notes on tooling and endpoints

The MCP server exposes a comprehensive set of tools for commercetools data access, including product, category, cart, order, customer, discount, inventory, store, and many other domains. You can enable read, create, and update operations per tool. You can also run a fully read-only configuration by selecting all.read.

To connect Claude Desktop or other tooling, provide a valid configuration that points to the MCP endpoint. If you run a local HTTP MCP server, the standard endpoint URL is http://localhost:8888/mcp when you start with the example remote flag. This allows the client to send requests to the MCP server and receive structured responses for tool calls.

Available tools

all

Enable all available tools across read, create, and update operations

all.read

Enable all read-only tools for safe read access

products.read

Read product information

products.create

Create product information

products.update

Update product information

project.read

Read project information

product-search.read

Search products

category.read

Read category information

category.create

Create category

category.update

Update category information

channel.read

Read channel information

channel.create

Create channel

channel.update

Update channel information

product-selection.read

Read product selection

product-selection.create

Create product selection

product-selection.update

Update product selection

order.read

Read order information

order.create

Create order from cart, quote, or import

order.update

Update order information

cart.read

Read cart information

cart.create

Create cart

cart.update

Update cart information

customer.read

Read customer information

customer.create

Create customer

customer.update

Update customer information

customer-group.read

Read customer group information

customer-group.create

Create customer group

customer-group.update

Update customer group

quote.read

Read quote information

quote.create

Create quote

quote.update

Update quote information

quote-request.read

Read quote request

quote-request.create

Create quote request

quote-request.update

Update quote request

staged-quote.read

Read staged quote

staged-quote.create

Create staged quote

staged-quote.update

Update staged quote

standalone-price.read

Read standalone price

standalone-price.create

Create standalone price

standalone-price.update

Update standalone price

product-discount.read

Read product discount

product-discount.create

Create product discount

product-discount.update

Update product discount

cart-discount.read

Read cart discount

cart-discount.create

Create cart discount

cart-discount.update

Update cart discount

discount-code.read

Read discount code information

discount-code.create

Create discount code

discount-code.update

Update discount code information

product-type.read

Read product type

product-type.create

Create product type

product-type.update

Update product type

bulk.create

Create entities in bulk

bulk.update

Update entities in bulk

inventory.read

Read inventory information

inventory.create

Create inventory

inventory.update

Update inventory information

store.read

Read store information

store.create

Create store information

store.update

Update store information

business-unit.read

Read business unit information

business-unit.create

Create business unit

business-unit.update

Update business unit

payments.read

Read payment information

payments.create

Create payment

payments.update

Update payment information

tax-category.read

Read tax category information

tax-category.create

Create tax category

tax-category.update

Update tax category information

shipping-methods.read

Read shipping method information

shipping-methods.create

Create shipping method

shipping-methods.update

Update shipping method information

zone.read

Read zone information

zone.create

Create zone

zone.update

Update zone information

recurring-orders.read

Read recurring order information

recurring-orders.create

Create recurring order

recurring-orders.update

Update recurring order information

shopping-lists.read

Read shopping list information

shopping-lists.create

Create shopping list

shopping-lists.update

Update shopping list information

extensions.read

Read extension information

extensions.create

Create extension

extensions.update

Update extension information

subscriptions.read

Read subscription information

subscriptions.create

Create subscription

subscriptions.update

Update subscription information

payment-methods.read

Read payment method information

payment-methods.create

Create payment method

payment-methods.update

Update payment method information

product-tailoring.read

Read product tailoring information

product-tailoring.create

Create product tailoring

product-tailoring.update

Update product tailoring information

custom-objects.read

Read custom object information

custom-objects.create

Create custom object

custom-objects.update

Update custom object information

types.read

Read type information

types.create

Create type

types.update

Update type information