adobe-commerce-dev-mcp

Adobe Commerce Dev MCP Server

20 stars TypeScriptDeveloper Kits Updated Oct 26, 2025

adobe-commercemagentomcp-server

Documentation

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:

json

{
  "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:

json

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

Method	Example	When to use
`env` in MCP config	`"ADOBE_COMMERCE_VERSION": "2.4.7"`	Claude Desktop, Cursor, production
CLI argument	`ADOBE_COMMERCE_VERSION=2.4.7` in the Arguments field	MCP Inspector

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

Tool	Description
`introspect_admin_graphql_schema`	Search the Adobe Commerce GraphQL schema for types, queries, and mutations matching a keyword
`introspect_admin_rest_schema`	Search the Adobe Commerce REST API (OpenAPI 2.0) schema for endpoints and definitions matching a keyword

Both tools use the schema for the configured `ADOBE_COMMERCE_VERSION`.

Available prompts

Prompt	Parameters	Description
`adobe_commerce_api`	`query` (required), `api_type: graphql \	rest \	auto` (optional, default `auto`)	Helps you write a GraphQL operation or REST request. When `api_type` is `auto` the AI picks the best API for the use case and explains why.
`validate_adobe_commerce_implementation`	`code` (required), `context` (optional)	Validates an existing GraphQL query, REST call, or integration snippet against the configured Adobe Commerce version. Reports each type, field, argument, and endpoint as ✅ valid, ⚠️ deprecated, or ❌ invalid, and provides a corrected version of the code when needed.

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:

bash

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:

bash

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

bash

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:

json

{
  "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:

bash

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

Frequently asked questions

What is adobe-commerce-dev-mcp?

adobe-commerce-dev-mcp is Adobe Commerce Dev MCP Server

How do I install adobe-commerce-dev-mcp?

Open the GitHub repository and follow its README. Most MCP servers are added to your client's MCP config, then called by your agent.

Is adobe-commerce-dev-mcp open source?

Yes — it is hosted on GitHub at https://github.com/rafaelstz/adobe-commerce-dev-mcp and has 20 stars.

Related MCP tools

activepieces

AI Agents & MCPs & AI Workflow Automation • (~400 MCP servers for AI agents) • AI Automation / AI Agent with MCPs • AI Workflows & AI Agents • MCPs for AI Ag...

18,776 TypeScript

ai-agentai-agent-toolsai-agents+10

typescript-sdk

The official TypeScript SDK for Model Context Protocol servers and clients Trusted by 10500+ developers. Trusted by 10500+ developers.

10,586 TypeScript

inspector

Visual testing tool for MCP servers TypeScript-based implementation. Trusted by 7300+ developers. Trusted by 7300+ developers.

7,373 TypeScript

magic-mcp

It's like v0 but in your Cursor/WindSurf/Cline. 21st dev Magic MCP server for working with your frontend like Magic TypeScript-based implementation.

3,887 TypeScript

mcp-server-chart

🤖 A visualization mcp contains 25+ visual charts using @antvis. Using for chart generation and data analysis. TypeScript-based implementation.

3,016 TypeScript

antvllmmcp+2

mobile-mcp

Model Context Protocol Server for Mobile Automation and Scraping (iOS, Android, Emulators, Simulators and Real Devices) TypeScript-based implementation.

2,382 TypeScript

agentandroidemulator+6

Run your own MCP server? See who uses it and what to fix.

Measure it with TrackMCP