home / mcp / commercetools mcp essentials server
Provides an MCP server with a broad set of commercetools tools and a streamable HTTP option for integration with agents and clients.
Configuration
View docs{
"mcpServers": {
"commercetools-mcp-essentials": {
"url": "http://localhost:8888/mcp",
"headers": {
"API_URL": "YOUR_API_URL",
"AUTH_URL": "YOUR_AUTH_URL",
"CLIENT_ID": "YOUR_CLIENT_ID",
"PROJECT_KEY": "YOUR_PROJECT_KEY",
"ACCESS_TOKEN": "YOUR_ACCESS_TOKEN",
"CLIENT_SECRET": "YOUR_CLIENT_SECRET"
}
}
}
}You run a Commercetools MCP Essentials server to expose a broad set of Commerce tools to MCP clients and agent frameworks. It supports both a local (stdio) server you boot up directly and a remote, streamable HTTP server that clients can connect to over HTTP. This guide shows practical steps to start the server, connect clients, and configure common options so you can access products, carts, orders, and more through MCP tooling.
Start with the local stdio MCP server to boot a complete MCP environment on your machine. This server runs via Node tooling and exposes a set of tools that you can enable for your MCP clients. If you prefer remote access over HTTP, you can launch the Streamable HTTP MCP server and connect clients to the HTTP endpoint. Use the standard credentials flow or a pre-existing access token to authorize the server and define which actions your MCP clients may perform.
Prerequisites you need before starting: Node.js 18 or later.
npm install -g npm@latest
node -vInstall and run the local stdio MCP server using the npx command shown here. Replace the placeholder values with your actual credentials and endpoints.
npx -y @commercetools/mcp-essentials \
--tools=all \
--clientId=CLIENT_ID \
--clientSecret=CLIENT_SECRET \
--projectKey=PROJECT_KEY \
--authUrl=AUTH_URL \
--apiUrl=API_URL \
--dynamicToolLoadingThreshold=30If you want to explicitly use client_credentials as the authentication type (optional since default), include it in the command.
To load all tools with admin privileges, you can pass --isAdmin=true in the same command (when applicable). If you want to restrict to read-only tools, switch to --tools=all.read.
You can also run a Streamable HTTP MCP server. This starts a remote HTTP server listening on a TCP port and exposes the MCP API over HTTP. Use the remote mode with a port such as 8888.
npx -y @commercetools/mcp-essentials \
--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=8888Clients can then connect to the HTTP endpoint at http://localhost:8888/mcp using a configuration similar to the one shown for Claude Desktop, which references the remote server.
Dynamic tool loading helps optimize performance when you enable many tools. By default, the system switches to dynamic loading when the number of enabled tools exceeds 30. You can adjust this with --dynamicToolLoadingThreshold or by exporting DYNAMIC_TOOL_LOADING_THRESHOLD in your environment.
See how you can integrate MCP Essentials with agent frameworks such as LangChain or Vercel AI SDK by obtaining the tool set from the server and wiring them into your agent’s tooling pipeline.
Enable all available MCP tools (read, create, and update operations)
Enable all read-only MCP tools
Read product information
Create product information
Update product information
Read project information
Search products
Read category information
Create category
Update category information
Read channel information
Create channel
Update channel information
Read product selection
Create product selection
Update product selection
Read order information
Create order (from cart, quote, import)
Update order information
Read cart information
Create cart
Update cart information
Read customer information
Create customer
Update customer information
Read customer group
Create customer group
Update customer group
Read quote information
Create quote
Update quote information
Read quote request
Create quote request
Update quote request
Read staged quote
Create staged quote
Update staged quote
Read standalone price
Create standalone price
Update standalone price
Read product discount
Create product discount
Update product discount
Read cart discount
Create cart discount
Update cart discount
Read discount code information
Create discount code
Update discount code information
Read product type
Create product type
Update product type
Create entities in bulk
Update entities in bulk
Read inventory information
Create inventory
Update inventory information
Read store
Create store
Update store
Read business unit
Create business unit
Update business unit
Read payment information
Create payment
Update payment information
Read tax category information
Create tax category
Update tax category information
Read shipping method information
Create shipping method
Update shipping method information
Read zone information
Create zone
Update zone information
Read recurring order information
Create recurring order
Update recurring order information
Read shopping list information
Create shopping list
Update shopping list information
Read extension information
Create extension
Update extension information
Read subscription information
Create subscription
Update subscription information
Read payment method information
Create payment method
Update payment method information
Read product tailoring information
Create product tailoring
Update product tailoring information
Read custom object information
Create custom object
Update custom object information
Read type information
Create type
Update type information