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. 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.

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 table lists all available tools you can enable in your Commerce MCP server. In the Description column, you can find links to the respective API endpoint used by Commerce MCP to perform the task.

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

Tool	Description
`all`	Enables all available tools, including read, create, and update operations.
`read_all`	Enables all read-only tools.
`create_applications`	Create Application
`read_applications`	Query Applications
`update_applications`	Update Application
`create_attribute_groups`	Create attribute group
`read_attribute_groups`	Read attribute group
`update_attribute_groups`	Update attribute group
`create_bulk`	Create entities in bulk.
`update_bulk`	Update entities in bulk.
`create_business_units`	Create business unit
`read_business_units`	Read business unit
`update_business_units`	Update business unit
`create_cart_discounts`	Create cart discount
`read_cart_discounts`	Read cart discount
`update_cart_discounts`	Update cart discount
`create_carts`	Create cart
`read_carts`	Read cart information
`update_carts`	Update cart information
`replicate_carts`	Replicate cart
`create_categories`	Create category
`read_categories`	Read category information
`update_categories`	Update category
`create_channels`	Create channel
`read_channels`	Read channel information
`update_channels`	Update channel information
`create_custom_objects`	Create custom objects
`read_custom_objects`	Read custom objects
`update_custom_objects`	Update custom objects
`create_customer_groups`	Create customer group
`read_customer_groups`	Read customer group
`update_customer_groups`	Update customer group
`read_customer_search`	Search Customers
`create_customers`	Create customer
`read_customers`	Read customer information
`update_customers`	Update customer information
`create_discount_codes`	Create discount code
`read_discount_codes`	Read discount code information
`update_discount_codes`	Update discount code information
`create_extensions`	Create extensions
`read_extensions`	Read extensions
`update_extensions`	Update extensions
`create_inventory`	Create inventory
`read_inventory`	Read inventory information
`update_inventory`	Update inventory information
`read_messages`	Read messages
`create_orders`	Create order (from cart, quote, import)
`read_orders`	Read order information
`update_orders`	Update order information
`create_payment_integrations`	Create PaymentIntegration
`read_payment_integrations`	Query PaymentIntegrations
`update_payment_integrations`	Update PaymentIntegration
`update_payment_intents`	Manage payment intents
`create_payment_methods`	Create payment method
`read_payment_methods`	Read payment method
`update_payment_methods`	Update payment method
`create_payments`	Create payment
`read_payments`	Read payment
`update_payments`	Update payment
`create_product_discounts`	Create product discount
`read_product_discounts`	Read product discount
`update_product_discounts`	Update product discount
`read_product_projections`	Read product projection
`read_product_search`	Search products
`create_product_selections`	Create product selection
`read_product_selections`	Read product selection
`update_product_selections`	Update product selection
`create_product_tailoring`	Create product tailoring
`read_product_tailoring`	Read product tailoring
`update_product_tailoring`	Update product tailoring
`create_product_types`	Create product type
`read_product_types`	Read product type
`update_product_types`	Update product type
`create_products`	Create product information
`read_products`	Read product information
`update_products`	Update product information
`read_project`	Read project information
`update_project`	Update project
`create_quote_requests`	Create quote request
`read_quote_requests`	Read quote request
`update_quote_requests`	Update quote request
`create_quotes`	Create quote
`read_quotes`	Read quote information
`update_quotes`	Update quote information
`create_recurring_orders`	Create recurring order
`read_recurring_orders`	Read recurring order
`update_recurring_orders`	Update recurring order
`create_reviews`	Create review
`read_reviews`	Read review
`update_reviews`	Update review
`create_shipping_methods`	Create shipping method
`read_shipping_methods`	Read shipping method
`update_shipping_methods`	Update shipping method
`create_shopping_lists`	Create shopping list
`read_shopping_lists`	Read shopping list
`update_shopping_lists`	Update shopping list
`create_staged_quotes`	Create staged quote
`read_staged_quotes`	Read staged quote
`update_staged_quotes`	Update staged quote
`create_standalone_prices`	Create standalone price
`read_standalone_prices`	Read standalone price
`update_standalone_prices`	Update standalone price
`create_states`	Create State
`read_states`	Read State
`update_states`	Update State
`create_stores`	Create store
`read_stores`	Read store
`update_stores`	Update store
`create_subscriptions`	Create subscription
`read_subscriptions`	Read subscription
`update_subscriptions`	Update subscription
`create_tax_categories`	Create tax category
`read_tax_categories`	Read tax category
`update_tax_categories`	Update tax category
`create_transactions`	Create transaction
`read_transactions`	Read transaction
`create_types`	Create type
`read_types`	Read type
`update_types`	Update type
`create_zones`	Create zone
`read_zones`	Read zone
`update_zones`	Update zone

Tool names in previous versions

Self-hosted Commerce MCP versions 1 to 3 used a different format for the --tools argument. Tool names followed a resource.action format, such as products.read, instead of the current read_products format. From version 4, self-hosted Commerce MCP uses the format listed in Available tools.

The following table lists the tool names used in versions 1 to 3:

Tool	Description
`all`	Enables all available tools, including read, create, and update operations. Requires setting `--isAdmin=true`.
`all.read`	Enables all read-only tools.
`bulk.create`	Create entities in bulk.
`bulk.update`	Update entities in bulk.
`business-unit.create`	Create business unit
`business-unit.read`	Read business unit
`business-unit.update`	Update business unit
`cart.create`	Create cart
`cart.read`	Read cart information
`cart.update`	Update cart information
`cart-discount.create`	Create cart discount
`cart-discount.read`	Read cart discount
`cart-discount.update`	Update cart discount
`category.create`	Create category
`category.read`	Read category information
`category.update`	Update category
`channel.create`	Create channel
`channel.read`	Read channel information
`channel.update`	Update channel information
`custom-objects.create`	Create custom objects
`custom-objects.read`	Read custom objects
`custom-objects.update`	Update custom objects
`customer.create`	Create customer
`customer.read`	Read customer information
`customer.update`	Update customer information
`customer-group.create`	Create customer group
`customer-group.read`	Read customer group
`customer-group.update`	Update customer group
`discount-code.create`	Create discount code
`discount-code.read`	Read discount code information
`discount-code.update`	Update discount code information
`extensions.create`	Create extensions
`extensions.read`	Read extensions
`extensions.update`	Update extensions
`inventory.create`	Create inventory
`inventory.read`	Read inventory information
`inventory.update`	Update inventory information
`order.create`	Create order (from cart, quote, import)
`order.read`	Read order information
`order.update`	Update order information
`payment.create`	Create payment
`payment.read`	Read payment
`payment.update`	Update payment
`payment-intents.update`	Manage payment intents
`payment-methods.create`	Create payment method
`payment-methods.read`	Read payment method
`payment-methods.update`	Update payment method
`product-discount.create`	Create product discount
`product-discount.read`	Read product discount
`product-discount.update`	Update product discount
`product-search.read`	Search products
`product-selection.create`	Create product selection
`product-selection.read`	Read product selection
`product-selection.update`	Update product selection
`product-tailoring.create`	Create product tailoring
`product-tailoring.read`	Read product tailoring
`product-tailoring.update`	Update product tailoring
`product-type.create`	Create product type
`product-type.read`	Read product type
`product-type.update`	Update product type
`products.create`	Create product information
`products.read`	Read product information
`products.update`	Update product information
`project.read`	Read project information
`quote.create`	Create quote
`quote.read`	Read quote information
`quote.update`	Update quote information
`quote-request.create`	Create quote request
`quote-request.read`	Read quote request
`quote-request.update`	Update quote request
`recurring-orders.create`	Create recurring order
`recurring-orders.read`	Read recurring order
`recurring-orders.update`	Update recurring order
`reviews.create`	Create review
`reviews.read`	Read review
`reviews.update`	Update review
`shipping-methods.create`	Create shipping method
`shipping-methods.read`	Read shipping method
`shipping-methods.update`	Update shipping method
`shopping-lists.create`	Create shopping list
`shopping-lists.read`	Read shopping list
`shopping-lists.update`	Update shopping list
`staged-quote.create`	Create staged quote
`staged-quote.read`	Read staged quote
`staged-quote.update`	Update staged quote
`standalone-price.create`	Create standalone price
`standalone-price.read`	Read standalone price
`standalone-price.update`	Update standalone price
`store.create`	Create store
`store.read`	Read store
`store.update`	Update store
`subscriptions.create`	Create subscription
`subscriptions.read`	Read subscription
`subscriptions.update`	Update subscription
`tax-category.create`	Create tax category
`tax-category.read`	Read tax category
`tax-category.update`	Update tax category
`transactions.create`	Create transaction
`transactions.read`	Read transaction
`types.create`	Create type
`types.read`	Read type
`types.update`	Update type
`zones.create`	Create zone
`zones.read`	Read zone
`zones.update`	Update zone

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

Tool names in previous versions.css-c0cbbx{display:inline-block;}.css-c0cbbx >:disabled{pointer-events:none;}

Available tools

Tool names in previous versions