Adobe Commerce KB MCP

MCP server that gives AI assistants (Claude, Cursor, Cline, Windsurf) instant access to the Adobe Commerce Support Knowledge Base.

The Commerce KB is the official Adobe troubleshooting library for Adobe Commerce and Magento — covering patches (MDVA / ACP2E), troubleshooting guides, how-to articles, FAQs, best practices, performance fixes, and Cloud/on-prem support tools. This MCP makes the entire KB searchable from your AI assistant.

Tools

| Tool | Description | |---|---| | search_commerce_kb | BM25-ranked full-text search across all KB articles | | get_kb_article_content | Fetch an article's full markdown content | | list_kb_categories | List KB categories with article counts | | get_kb_article_toc | Get table of contents for an article | | get_kb_code_examples | Extract code/command examples from an article | | get_related_kb_articles | Find related articles in the same category | | lookup_commerce_issue | Search + auto-fetch the top KB article | | refresh_kb_index | Force-refresh the KB index |

Prompts

| Prompt | Description | |---|---| | commerce-kb-diagnose | Diagnose a Commerce issue using the Knowledge Base | | commerce-kb-patch-lookup | Find patches and fixes for a specific issue |

Resources

| Resource | Description | |---|---| | commerce-kb://sections | All categories with article counts | | commerce-kb://stats | Server uptime and index stats | | commerce-kb://category/{section} | Browse articles by category |

Quick Setup — Cursor

npx adobe-commerce-kb-mcp

Or add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "adobe-commerce-kb": {
      "command": "npx",
      "args": ["-y", "adobe-commerce-kb-mcp"]
    }
  }
}

Quick Setup — Claude Desktop

Add to ~/Library/Application Support/Claude/claude_desktop_config.json (macOS):

{
  "mcpServers": {
    "adobe-commerce-kb": {
      "command": "npx",
      "args": ["-y", "adobe-commerce-kb-mcp"]
    }
  }
}

HTTP Mode

npx adobe-commerce-kb-mcp --http
# Runs on http://localhost:3000

KB Categories

| Category | Description | |---|---| | troubleshooting | Step-by-step fixes for known Commerce issues | | how-to | Guides for specific tasks and configurations | | faq | Frequently asked questions | | announcements | Platform updates and security patches | | support-tools | Managed alerts, Site-Wide Analysis Tool, etc. |

Example Queries

• "Why is my Commerce checkout throwing a 500 error?"
• "How do I fix a stuck cron job in Adobe Commerce Cloud?"
• "Find patches for Commerce 2.4.6 Elasticsearch issues"
• "How do I flush the Magento cache via CLI?"
• "My indexer keeps going invalid — what's the fix?"

Related MCPs

• adobe-commerce-docs-mcp — Adobe Commerce merchant & admin docs (experienceleague.adobe.com)
• adobe-commerce-dev-docs-mcp — Adobe Commerce developer docs (developer.adobe.com/commerce)
• aem-live-docs-mcp — AEM / Edge Delivery Services docs (aem.live)
• adobe-app-builder-docs-mcp — Adobe App Builder — serverless, I/O Runtime, Commerce extensibility
• adobe-api-mesh-docs-mcp — Adobe API Mesh — GraphQL gateway & source handlers
• adobe-io-events-docs-mcp — Adobe I/O Events — webhooks, journaling & event providers

License

CC BY-NC 4.0 © 2026 Jigar Karangiya · LinkedIn