Adobe Commerce Dev MCP Server

This project implements a Model Context Protocol (MCP) server that interacts with Adobe Commerce. It provides tools to search the GraphQL and REST API schemas, and prompts to help write and validate API integrations.

Usage with MCP Server via NPM Package

You can use this MCP server directly without downloading or hosting anything yourself. Simply configure your MCP client (such as Cursor or Claude Desktop) to use the NPM package:

{
  "mcpServers": {
    "adobe-commerce-dev-mcp": {
      "command": "npx",
      "args": ["-y", "@rafaelcg/adobe-commerce-dev-mcp@latest"],
      "env": {
        "ADOBE_COMMERCE_VERSION": "2.4.8"
      }
    }
  }
}

• Replace the server name (adobe-commerce-dev-mcp) as you wish.
• The npx command will always use the latest version of the MCP server from NPM.
• Set ADOBE_COMMERCE_VERSION to match your store (2.4.7 or 2.4.8). Defaults to 2.4.8.
• No need to install or host anything locally or remotely.

On Windows, you might need to use this alternative configuration:

{
  "mcpServers": {
    "adobe-commerce-dev-mcp": {
      "command": "cmd",
      "args": ["/k", "npx", "-y", "@rafaelcg/adobe-commerce-dev-mcp@latest"],
      "env": {
        "ADOBE_COMMERCE_VERSION": "2.4.8"
      }
    }
  }
}

Version configuration

The ADOBE_COMMERCE_VERSION setting controls which schema files are loaded by both tools and which version is referenced in prompts.

Supported versions: 2.4.7, 2.4.8 (default).

REST schema fallback: if the REST schema file for the configured version is not found, the server falls back to 2.4.8 and includes a note in the tool response.

Available tools

Both tools use the schema for the configured ADOBE_COMMERCE_VERSION.

Available prompts

Getting the GraphQL schema for your local store

Run an introspection query against your local store and save the result as a gzipped file in the data/ folder:

curl -s https://magento.test/graphql \
  -X POST \
  -H "Content-Type: application/json" \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  --insecure \
  -d '{"query":"fragment FullType on __Type { kind name description fields(includeDeprecated: true) { name description args { ...InputValue } type { ...TypeRef } isDeprecated deprecationReason } inputFields { ...InputValue } interfaces { ...TypeRef } enumValues(includeDeprecated: true) { name description isDeprecated deprecationReason } possibleTypes { ...TypeRef } } fragment InputValue on __InputValue { name description type { ...TypeRef } defaultValue } fragment TypeRef on __Type { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name ofType { kind name } } } } } } } } query IntrospectionQuery { __schema { queryType { name } mutationType { name } subscriptionType { name } types { ...FullType } directives { name description locations args { ...InputValue } } } }"}' \
  | gzip > data/schema_2-4-8.json.gz

Get an admin token first if needed:

curl -s -X POST https://magento.test/rest/V1/integration/admin/token \
  --insecure \
  -H "Content-Type: application/json" \
  -d '{"username":"admin","password":"YOUR_PASSWORD"}'

Getting the REST API schema for your local store

curl -s "https://magento.test/rest/all/schema?services=all" \
  --insecure \
  -H "Authorization: Bearer YOUR_ADMIN_TOKEN" \
  | gzip > data/rest_schema_2-4-8_admin.json.gz

Development

The server is built using the MCP SDK and communicates with Adobe Commerce.

1. npm install
2. Modify source files
3. Run npm run build to compile
4. Run npm test to run tests
5. Add an MCP server pointing to the built file (see below)

Local MCP config:

{
  "mcpServers": {
    "adobe-commerce-dev-mcp": {
      "command": "node",
      "args": ["/absolute/path/to/adobe-commerce-dev-mcp/dist/index.js"],
      "env": {
        "ADOBE_COMMERCE_VERSION": "2.4.8"
      }
    }
  }
}

MCP Inspector:

npm run inspector

Then set ADOBE_COMMERCE_VERSION=2.4.7 (or any supported version) in the Arguments field to switch schemas without restarting.

License

ISC