Commerce MCP

Enable AI agents and assistants to integrate with your Project through standardized tool calling.

Commerce MCP (formerly referred to as Essentials MCP) lets AI tools interact with your Project using natural language prompts. Supported tools include Visual Studio Code, Claude Desktop, LangChain, and AI SDK by Vercel.

With Commerce MCP, agents can perform tasks on your Project, including retrieving product information, managing carts and orders, and handling customer data.

You can configure which tools the MCP server can use, and filter or redact fields. This gives you full control over your agent's permissions, from read-only access to read-and-write access for advanced use cases.

Commerce MCP is available as part of the Managed MCP Servers offering and as a self-hosted executable package. You can also integrate the self-hosted package into agent frameworks or extend it with custom tools. The Managed Commerce MCP is configured in the Merchant Center. Both variants offer the same tools and field filtering, so you can migrate between them. If you do not have a preference, start with the Managed Commerce MCP.

To set up the self-hosted Commerce MCP server in your IDE or AI client (Visual Studio Code, Cursor, Claude, JetBrains IDEs, Codex, or any other MCP-compatible client), see Get started on the Self-hosted Commerce MCP page. You can also configure its transport protocol, control data transformation, and enable logging for debugging purposes.

Available tools

Tools represent the operations on various resources that Commerce MCP can perform. The AI agent finds the tool that best fits your natural language request. It can invoke these tools to interact with your Project through the API Client you provide.

The following tables list all available tools you can enable in your Commerce MCP server. The Action column links to the respective API endpoint used by Commerce MCP to perform the task. Self-hosted Commerce MCP versions 1 to 3 use a resource.action format, such as products.read, for the --tools argument. From version 4, self-hosted Commerce MCP uses the read_products format listed in the tables. A dash in the Tool in previous versions column indicates that the tool has no equivalent in versions 1 to 3. In versions 1 to 3, the all tool also requires setting --isAdmin=true.

For best security and performance, configure your Commerce MCP server to include only the specific tools required for your use case.

Global

Action	Tool	Tool in previous versions
Enable all available tools, including read, create, and update operations. In versions 1 to 3, also set `--isAdmin=true`.	`all`	`all`
Enable all read-only tools.	`read_all`	`all.read`

Application

Action	Tool	Tool in previous versions
Create Application	`create_applications`	-
Query Applications	`read_applications`	-
Update Application	`update_applications`	-

Attribute Group

Action	Tool	Tool in previous versions
Create Attribute Group	`create_attribute_groups`	-
Read Attribute Group	`read_attribute_groups`	-
Update Attribute Group	`update_attribute_groups`	-

Bulk

Action	Tool	Tool in previous versions
Create entities in bulk.	`create_bulk`	`bulk.create`
Update entities in bulk.	`update_bulk`	`bulk.update`

Business Unit

Action	Tool	Tool in previous versions
Create Business Unit	`create_business_units`	`business-unit.create`
Read Business Unit	`read_business_units`	`business-unit.read`
Update Business Unit	`update_business_units`	`business-unit.update`

Cart Discount

Action	Tool	Tool in previous versions
Create Cart Discount	`create_cart_discounts`	`cart-discount.create`
Read Cart Discount	`read_cart_discounts`	`cart-discount.read`
Update Cart Discount	`update_cart_discounts`	`cart-discount.update`

Cart

Action	Tool	Tool in previous versions
Create Cart	`create_carts`	`cart.create`
Read Cart information	`read_carts`	`cart.read`
Update Cart information	`update_carts`	`cart.update`
Replicate Cart	`replicate_carts`	-

Action	Tool	Tool in previous versions
Create Category	`create_categories`	`category.create`
Read Category information	`read_categories`	`category.read`
Update Category	`update_categories`	`category.update`

Channel

Action	Tool	Tool in previous versions
Create Channel	`create_channels`	`channel.create`
Read Channel information	`read_channels`	`channel.read`
Update Channel information	`update_channels`	`channel.update`

Custom Object

Action	Tool	Tool in previous versions
Create Custom Object	`create_custom_objects`	`custom-objects.create`
Read Custom Object	`read_custom_objects`	`custom-objects.read`
Update Custom Object	`update_custom_objects`	`custom-objects.update`

Customer Group

Action	Tool	Tool in previous versions
Create Customer Group	`create_customer_groups`	`customer-group.create`
Read Customer Group	`read_customer_groups`	`customer-group.read`
Update Customer Group	`update_customer_groups`	`customer-group.update`

Customer

Action	Tool	Tool in previous versions
Search Customers	`read_customer_search`	-
Create Customer	`create_customers`	`customer.create`
Read Customer information	`read_customers`	`customer.read`
Update Customer information	`update_customers`	`customer.update`

Discount Code

Action	Tool	Tool in previous versions
Create Discount Code	`create_discount_codes`	`discount-code.create`
Read Discount Code information	`read_discount_codes`	`discount-code.read`
Update Discount Code information	`update_discount_codes`	`discount-code.update`

API Extension

Action	Tool	Tool in previous versions
Create API Extension	`create_extensions`	`extensions.create`
Read API Extension	`read_extensions`	`extensions.read`
Update API Extension	`update_extensions`	`extensions.update`

Inventory

Action	Tool	Tool in previous versions
Create Inventory	`create_inventory`	`inventory.create`
Read Inventory information	`read_inventory`	`inventory.read`
Update Inventory information	`update_inventory`	`inventory.update`

Message

Action	Tool	Tool in previous versions
Read Messages	`read_messages`	-

Order

Action	Tool	Tool in previous versions
Create Order from a Cart, Quote, or Order Import	`create_orders`	`order.create`
Read Order information	`read_orders`	`order.read`
Update Order information	`update_orders`	`order.update`

Payment Integration

Action	Tool	Tool in previous versions
Create Payment Integration	`create_payment_integrations`	-
Query Payment Integrations	`read_payment_integrations`	-
Update Payment Integration	`update_payment_integrations`	-

Payment Intent

Action	Tool	Tool in previous versions
Manage Payment Intents	`update_payment_intents`	`payment-intents.update`

Payment Method

Action	Tool	Tool in previous versions
Create Payment Method	`create_payment_methods`	`payment-methods.create`
Read Payment Method	`read_payment_methods`	`payment-methods.read`
Update Payment Method	`update_payment_methods`	`payment-methods.update`

Payment

Action	Tool	Tool in previous versions
Create Payment	`create_payments`	`payment.create`
Read Payment	`read_payments`	`payment.read`
Update Payment	`update_payments`	`payment.update`

Product Discount

Action	Tool	Tool in previous versions
Create Product Discount	`create_product_discounts`	`product-discount.create`
Read Product Discount	`read_product_discounts`	`product-discount.read`
Update Product Discount	`update_product_discounts`	`product-discount.update`

Product Projection

Action	Tool	Tool in previous versions
Read Product Projection	`read_product_projections`	-

Product Search

Action	Tool	Tool in previous versions
Search Products	`read_product_search`	`product-search.read`

Product Selection

Action	Tool	Tool in previous versions
Create Product Selection	`create_product_selections`	`product-selection.create`
Read Product Selection	`read_product_selections`	`product-selection.read`
Update Product Selection	`update_product_selections`	`product-selection.update`

Product Tailoring

Action	Tool	Tool in previous versions
Create Product Tailoring	`create_product_tailoring`	`product-tailoring.create`
Read Product Tailoring	`read_product_tailoring`	`product-tailoring.read`
Update Product Tailoring	`update_product_tailoring`	`product-tailoring.update`

Product Type

Action	Tool	Tool in previous versions
Create Product Type	`create_product_types`	`product-type.create`
Read Product Type	`read_product_types`	`product-type.read`
Update Product Type	`update_product_types`	`product-type.update`

Product

Action	Tool	Tool in previous versions
Create Product information	`create_products`	`products.create`
Read Product information	`read_products`	`products.read`
Update Product information	`update_products`	`products.update`

Project

Action	Tool	Tool in previous versions
Read Project information	`read_project`	`project.read`
Update Project	`update_project`	-

Quote Request

Action	Tool	Tool in previous versions
Create Quote Request	`create_quote_requests`	`quote-request.create`
Read Quote Request	`read_quote_requests`	`quote-request.read`
Update Quote Request	`update_quote_requests`	`quote-request.update`

Quote

Action	Tool	Tool in previous versions
Create Quote	`create_quotes`	`quote.create`
Read Quote information	`read_quotes`	`quote.read`
Update Quote information	`update_quotes`	`quote.update`

Recurring Order

Action	Tool	Tool in previous versions
Create Recurring Order	`create_recurring_orders`	`recurring-orders.create`
Read Recurring Order	`read_recurring_orders`	`recurring-orders.read`
Update Recurring Order	`update_recurring_orders`	`recurring-orders.update`

Review

Action	Tool	Tool in previous versions
Create Review	`create_reviews`	`reviews.create`
Read Review	`read_reviews`	`reviews.read`
Update Review	`update_reviews`	`reviews.update`

Shipping Method

Action	Tool	Tool in previous versions
Create Shipping Method	`create_shipping_methods`	`shipping-methods.create`
Read Shipping Method	`read_shipping_methods`	`shipping-methods.read`
Update Shipping Method	`update_shipping_methods`	`shipping-methods.update`

Shopping List

Action	Tool	Tool in previous versions
Create Shopping List	`create_shopping_lists`	`shopping-lists.create`
Read Shopping List	`read_shopping_lists`	`shopping-lists.read`
Update Shopping List	`update_shopping_lists`	`shopping-lists.update`

Staged Quote

Action	Tool	Tool in previous versions
Create Staged Quote	`create_staged_quotes`	`staged-quote.create`
Read Staged Quote	`read_staged_quotes`	`staged-quote.read`
Update Staged Quote	`update_staged_quotes`	`staged-quote.update`

Standalone Price

Action	Tool	Tool in previous versions
Create Standalone Price	`create_standalone_prices`	`standalone-price.create`
Read Standalone Price	`read_standalone_prices`	`standalone-price.read`
Update Standalone Price	`update_standalone_prices`	`standalone-price.update`

State

Action	Tool	Tool in previous versions
Create State	`create_states`	-
Read State	`read_states`	-
Update State	`update_states`	-

Store

Action	Tool	Tool in previous versions
Create Store	`create_stores`	`store.create`
Read Store	`read_stores`	`store.read`
Update Store	`update_stores`	`store.update`

Subscription

Action	Tool	Tool in previous versions
Create Subscription	`create_subscriptions`	`subscriptions.create`
Read Subscription	`read_subscriptions`	`subscriptions.read`
Update Subscription	`update_subscriptions`	`subscriptions.update`

Tax Category

Action	Tool	Tool in previous versions
Create Tax Category	`create_tax_categories`	`tax-category.create`
Read Tax Category	`read_tax_categories`	`tax-category.read`
Update Tax Category	`update_tax_categories`	`tax-category.update`

Transaction

Action	Tool	Tool in previous versions
Create Transaction	`create_transactions`	`transactions.create`
Read Transaction	`read_transactions`	`transactions.read`

Type

Action	Tool	Tool in previous versions
Create Type	`create_types`	`types.create`
Read Type	`read_types`	`types.read`
Update Type	`update_types`	`types.update`

Zone

Action	Tool	Tool in previous versions
Create Zone	`create_zones`	`zones.create`
Read Zone	`read_zones`	`zones.read`
Update Zone	`update_zones`	`zones.update`

Available tools.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Global.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Application.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Attribute Group.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Bulk.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Business Unit.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Cart Discount.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Cart.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Category.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Channel.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Custom Object.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Customer Group.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Customer.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Discount Code.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

API Extension.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Inventory.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Message.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Order.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Payment Integration.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Payment Intent.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Payment Method.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Payment.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Product Discount.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Product Projection.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Product Search.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Product Selection.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Product Tailoring.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Product Type.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Product.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Project.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Quote Request.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Quote.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Recurring Order.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Review.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Shipping Method.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Shopping List.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Staged Quote.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Standalone Price.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

State.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Store.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Subscription.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Tax Category.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Transaction.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Type.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Zone.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}