Skip to main content
Glama
Codexpect

Adobe Commerce / Magento MCP

by Codexpect

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: Magento 2 MCP Server

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.

Categories

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.

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.

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

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
4dRelease cycle
4Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/Codexpect/adobe-commerce-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server