rafaelstz/adobe-commerce-dev-mcp

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