How do I use Adobe Commerce / Magento MCP?

1. Click on "Deploy Server". 2. Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state. 3. In the chat, type @ followed by the MCP server name and your instructions, e.g., "@Adobe Commerce / Magento MCP search for products with 'shirt' in name" That's it! The server will respond to your query, and you can continue using it as needed. Here is a step-by-step guide with screenshots.

Adobe Commerce / Magento MCP

by Codexpect

Overview Schema Source Related Servers Discussions Admin

TypeScript

Remote

Adobe Commerce / Magento MCP

A Model Context Protocol (MCP) tool for integrating with the Magento REST API. No direct SQL or server access required.

Supported Editions

This MCP tool is compatible with:

Adobe Commerce (formerly Magento): Enterprise-grade eCommerce platform with advanced features and support.
Magento Open Source: The free, open-source edition of Magento, suitable for small to medium businesses.

All features are implemented using the official Magento REST API, ensuring compatibility and security for both editions. No direct database or server access is required—just API credentials from your Magento instance.

Related MCP server: commercetools MCP Essentials

Available Tools

All registered MCP tools are organized by resource type below:

Products

Tool ID	Description
search-products	Search for products in Adobe Commerce with flexible search filters.
create-product	Create a new product in Adobe Commerce with the specified attributes.
update-product	Update an existing product in Adobe Commerce with new attributes.
get-product-by-sku	Retrieve a specific product from Adobe Commerce by its SKU.
delete-product	Delete a product from Adobe Commerce by its SKU.
assign-product-to-website	Assign a product to a website by SKU and website ID.
remove-product-from-website	Remove a product from a website by SKU and website ID.

Product Attributes

Tool ID	Description
search-products-attributes	Search for products attributes in Adobe Commerce with flexible search filters.
create-product-attribute	Create a new product attribute in Adobe Commerce. Supports all attribute types.
get-product-attribute-by-code	Get a single product attribute by its attribute code.
update-product-attribute	Update an existing product attribute by its attribute code.
delete-product-attribute	Delete a product attribute by its attribute code.
get-product-attribute-options	Get all options for a specific product attribute.
add-product-attribute-option	Add a new option to a product attribute.
update-product-attribute-option	Update an existing option of a product attribute.
delete-product-attribute-option	Delete an option from a product attribute.

Attribute Sets

Tool ID	Description
search-attribute-sets	Search for attribute sets in Adobe Commerce with flexible search filters.
create-attribute-set	Create a new attribute set in Adobe Commerce. Only attribute_set_name and sort_order needed.
get-attribute-set-by-id	Get details of an attribute set by its ID.
get-attributes-from-set	Get all attributes from an attribute set by its ID.
delete-attribute-set	Delete an attribute set by its ID.
update-attribute-set	Update an attribute set by its ID. Only provide fields you want to update.
delete-attribute-from-set	Delete an attribute from an attribute set by set ID and attribute code.
assign-attribute-to-set-group	Assign an attribute to an attribute set and group in Adobe Commerce.

Attribute Groups

Tool ID	Description
search-attribute-groups	Search for attribute groups in an attribute set in Adobe Commerce.
create-attribute-group	Create a new attribute group in an attribute set in Adobe Commerce.
delete-attribute-group	Delete an attribute group by its ID.
update-attribute-group	Update an attribute group by its ID in a given attribute set.

Configurable Products

Tool ID	Description
add-configurable-product-option	Define which attribute and options are used in a configurable product. Creates framework for product variants.
link-configurable-child	Link a child product to a configurable product by SKU. The child product becomes a variant of the parent.
unlink-configurable-child	Unlink a child product from a configurable product by SKU. The child product remains but is no longer a variant.
get-configurable-product-children	Retrieve all child products for a configurable product by SKU.
get-configurable-product-options-all	Retrieve all configurable options for a configurable product by SKU.
get-configurable-product-option-by-id	Retrieve a specific configurable option for a configurable product by SKU and option ID.
update-configurable-product-option	Update an existing configurable option for a configurable product by SKU and option ID.
delete-configurable-product-option	Remove a configurable option from a configurable product by SKU and option ID.

Pricing

Tool ID	Description
set-base-prices	Set base prices for multiple products efficiently.
get-base-prices	Retrieve base prices for multiple products.
set-special-prices	Set special prices with date ranges for multiple products.
delete-special-prices	Delete special prices for multiple products.
get-special-prices	Retrieve special prices for multiple products.
set-tier-prices	Set tier prices for quantity-based discounts on multiple products.
replace-tier-prices	Replace all existing tier prices with new ones for multiple products.
delete-tier-prices	Delete specific tier prices for multiple products.
get-tier-prices	Retrieve tier prices for multiple products.
set-costs	Set cost values for multiple products.
delete-costs	Delete cost values for multiple products.
get-costs	Retrieve cost values for multiple products.

Customers

Tool ID	Description
search-customers	Search for customers in Adobe Commerce with flexible search filters.

Orders

Tool ID	Description
search-orders	Search for orders in Adobe Commerce with flexible search filters.

CMS

Tool ID	Description
search-cms-blocks	Search for CMS blocks in Adobe Commerce with flexible search filters.
search-cms-pages	Search for CMS pages in Adobe Commerce with flexible search filters.

Stores

Tool ID	Description
get-store-configs	Retrieve store configurations with optional store code filtering.
get-store-views	Get all store views in Adobe Commerce.
get-store-groups	Get all store groups in Adobe Commerce.
get-websites	Get all websites in Adobe Commerce.

Inventory Management (MSI - Multi-Source Inventory)

MSI Source Items

Tool ID	Description
search-msi-source-items	Search for source items with flexible filters and pagination.
create-msi-source-item	Create a new source item with product SKU, source code, and quantity.
delete-msi-source-item	Delete a source item by SKU and source code.
are-products-salable-msi	Check if multiple products are salable for given SKUs and stock ID.
are-products-salable-for-requested-qty-msi	Check if products are salable for specific requested quantities.
is-product-salable-msi	Check if a specific product is salable for a given stock.
is-product-salable-for-requested-qty-msi	Check if a product is salable for a specific requested quantity.
get-product-salable-quantity-msi	Get the salable quantity for a specific product and stock.

MSI Stocks

Tool ID	Description
search-msi-stocks	Search for stocks with flexible filters and pagination.
get-msi-stock-by-id	Get stock data by given stockId.
create-msi-stock	Save Stock data.
update-msi-stock	Save Stock data.
delete-msi-stock	Delete the Stock data by stockId.
resolve-msi-stock	Resolve Stock by Sales Channel type and code.

MSI Sources

Tool ID	Description
search-msi-sources	Find Sources by SearchCriteria.
get-msi-source-by-code	Get Source data by given code.
create-msi-source	Save Source data.
update-msi-source	Save Source data.

MSI Stock-Source Links

Tool ID	Description
search-msi-stock-source-links	Find StockSourceLink list by given SearchCriteria.
create-msi-stock-source-links	Save StockSourceLink list data.
delete-msi-stock-source-links	Remove StockSourceLink list.

MSI Source Selection

Tool ID	Description
get-msi-source-selection-algorithms	Get list of available source selection algorithms.
run-msi-source-selection-algorithm	Get source selection algorithm result.

Inventory Management (Single Stock System)

Tool ID	Description
get-single-stock-item	Get stock information for a specific product by SKU (single stock system).
update-single-stock-item	Update stock item information (quantity, status, etc.) for a product (single stock system).
get-single-low-stock-items	Get products with low inventory quantity below specified threshold (single stock system).
get-single-stock-status	Get stock status information for a specific product by SKU (single stock system).

Each tool provides a set of MCP-compatible operations for its resource type. For a full list and detailed parameters, see the source files in src/tools/.

Usage

1. Install

npm install

2. Build

npm run build

3. Configure

Create or edit your .cursor/mcp.json file and provide your Magento/Adobe Commerce instance credentials:

{
  "mcpServers": {
    "adobe-commerce-mcp": {
      "command": "node",
      "args": ["/path/to/adobe-commerce-mcp/build/index.js"],
      "env": {
        "COMMERCE_BASE_URL": "https://your-magento-instance/",
        "COMMERCE_CONSUMER_KEY": "your_consumer_key",
        "COMMERCE_CONSUMER_SECRET": "your_consumer_secret",
        "COMMERCE_ACCESS_TOKEN": "your_access_token",
        "COMMERCE_ACCESS_TOKEN_SECRET": "your_access_token_secret"
      }
    }
  }
}

4. Run

Start the MCP server as defined in your configuration. The tools will be available for use in any MCP-compatible client or workflow.

Directory Structure

adobe-commerce-mcp/
├── src/
│   ├── adobe/
│   │   ├── categories/         # Category API and types
│   │   ├── cms/                # CMS blocks and pages API and types
│   │   ├── customers/          # Customer API and types
│   │   ├── inventory/          # Inventory API, MSI, and single stock types
│   │   ├── orders/             # Order API and types
│   │   ├── products/           # Product API, attributes, sets, and types
│   │   ├── search-criteria/    # Search criteria schemas and types
│   │   ├── stores/             # Store API and types
│   │   └── types/              # Shared API response and parameter types
│   ├── tools/                  # MCP tool implementations for each resource
│   └── index.ts                # Main MCP server entry point
├── packages/
│   └── commerce-sdk-auth/      # Authentication SDK for Adobe Commerce
├── tests/                      # Test suites and mocks
├── package.json
├── tsconfig.json
└── README.md

Testing

Prerequisites

To run the test suite, you need access to a Magento/Adobe Commerce instance with the following configuration:

Required Website Structure

The test environment requires a multi-website setup with the following structure:

Websites:

Website ID 0: admin - Admin website
Website ID 1: base - Main Website (default)
Website ID 2: second_website - Second website for testing

Store Groups:

Group ID 0: Default - Default store group
Group ID 1: Main Website Store - Main website store group
Group ID 2: Second Store - Second store group

Store Views:

Store ID 0: admin - Admin store view
Store ID 1: default - Default store view
Store ID 2: second_store_view_pl - Second store view (PL)
Store ID 3: second_store_view_en - Second store view (EN)

Configuration Requirements

Pricing Scope: Set to "Website" based pricing
API Access: Valid REST API credentials with appropriate permissions
Test Data: Clean test environment with sample products, categories, and attributes

Running Tests

# Run all tests
npm test

# Run tests with coverage
npm run test:coverage

# Run specific test suites
npm test -- --testPathPattern=products
npm test -- --testPathPattern=categories

Test Structure

Tests are organized in the tests/ directory:

tests/tools/ - Tool-specific test suites
tests/utils/ - Test utilities and mocks
tests/fixtures/ - Test data fixtures

Environment Setup

Create a .env.test file based on tests/env.test.example:

cp tests/env.test.example .env.test

Then configure your test environment variables in .env.test.

TODO

config

IS MSI enabled?
can manage stock?
if you update stock of simple, update in stock for config
simple of configurable should be not visible

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityInactive

ResponsivenessNo issues

Resources

GitHub Repository

Need Help?

Related Servers

Related MCP Connectors

mcp
com.api2cart
Unified MCP server for 70+ eCommerce platforms: products, orders, customers, and more.
E-commerce & Retail CRM
1
Product Management Mcp D
io.github.varvararatta
MCP server for Product Management
Product Management Project Management
2
Ecommerce Mcp A
io.github.varvararatta
MCP server for E-Commerce
E-commerce & Retail Payments & Billing
2
SeekOnMe Product Discovery
me.seekon.fast
Remote MCP server for product discovery catalog and retrieving product details.
E-commerce & Retail Search
2

Related MCP Servers

Magento 2 MCP Server
E-commerce & Retail Databases
boldcommerce
A
license
B
quality
D
maintenance
A Model Context Protocol server that connects to a Magento 2 REST API, allowing Claude and other MCP clients to query product information, customer data, and order statistics from a Magento store.
Updated a year ago (2025-04-22 07:23 UTC)
14
59
GPL 3.0
commercetools MCP Essentialsofficial
E-commerce & Retail Databases Developer Tools
commercetools
A
license
Not graded
quality
C
maintenance
An MCP server that enables AI agents to interact with the commercetools Composable Commerce platform. It provides tools for managing products, categories, orders, carts, and customer data through secure read and write operations.
Updated a month ago (2026-08-17 15:19 UTC)
13
MIT
WooCommerce MCP Server
lockon-n
A
license
Not graded
quality
D
maintenance
An MCP server that provides access to WooCommerce REST API functionality, enabling product, order, customer, and coupon management.
Updated a year ago (2025-10-16 06:24 UTC)
418 npm
1
MIT
Freento MCP Server for Magento
E-commerce & Retail CRM
Freento
F
license
Not graded
quality
A
maintenance
Freento MCP is a native Magento 2 extension that implements the Model Context Protocol (MCP) — an open standard for connecting AI assistants to external data sources. This server acts as a secure, direct bridge between your Adobe Commerce / Magento 2 store and LLM-powered assistants (like Claude, ChatGPT, and others), allowing you to manage and audit your store using natural language.
Updated 2 months ago (2026-07-14 11:24 UTC)
15
-

Tool ID	Description
search-categories	Search for categories in Adobe Commerce with flexible search filters.
get-category-tree	Retrieve the category tree structure with optional root category and depth parameters.
get-category-by-id	Retrieve a specific category by its ID.
create-category	Create a new category in Adobe Commerce.
update-category	Update an existing category in Adobe Commerce.
delete-category	Delete a category by its ID.
move-category	Move a category to a new parent category.
get-category-attributes	Retrieve category attributes with optional search criteria.
get-category-attribute-by-code	Retrieve a specific category attribute by its code.
get-category-attribute-options	Retrieve options for a specific category attribute.
get-category-products	Retrieve products assigned to a specific category.
assign-product-to-category	Assign a product to a specific category.
update-product-in-category	Update a product's assignment in a category.
remove-product-from-category	Remove a product from a specific category.

Adobe Commerce / Magento MCP

Supported Editions

Available Tools

Products

Product Attributes

Attribute Sets

Attribute Groups

Configurable Products

Pricing

Categories

Customers

Orders

CMS

Stores

Inventory Management (MSI - Multi-Source Inventory)

MSI Source Items

MSI Stocks

MSI Sources

MSI Stock-Source Links

MSI Source Selection

Inventory Management (Single Stock System)

Usage

1. Install

2. Build

3. Configure

4. Run

Directory Structure

Testing

Prerequisites

Required Website Structure

Configuration Requirements

Running Tests

Test Structure

Environment Setup

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

Magento 2 MCP Server

commercetools MCP Essentialsofficial

WooCommerce MCP Server

Freento MCP Server for Magento