Adobe Commerce Docs MCP Server

An MCP (Model Context Protocol) server that gives AI assistants direct access to the official Adobe Commerce / Magento documentation. It indexes the Adobe Experience League sitemap and provides tools, resources, and prompts to search, browse, and read documentation pages — all from within your AI coding assistant.

Features

• 10 tools — search, read pages, browse sections, fetch one section of a long page, find related docs, extract code examples, get page TOC, lookup errors, multi-query search, and refresh
• Structured tool output — every tool returns typed structuredContent (JSON Schema outputSchema) alongside human-readable markdown, so clients can parse results programmatically
• Tool annotations — all tools declare readOnlyHint/openWorldHint/idempotentHint so MCP clients can reduce confirmation friction for safe, read-only operations
• MCP Resources — browsable commerce:// URIs for sections and doc pages, capped at 300 entries per section read to stay context-safe
• MCP Prompts — reusable workflows for troubleshooting, code review, upgrades, and concept explanation
• BM25 search — relevance-ranked results with IDF weighting and document-length normalization
• Synonym expansion — graphql also matches gql, cloud matches ece, module matches extension, and 40+ more
• Fuzzy matching — tolerates typos like chekout → checkout, catlog → catalog
• Smart truncation — cuts at heading boundaries instead of mid-sentence
• Instant cold start — indexes from a sitemap snapshot bundled with the package, then refreshes live in the background — no blocking on a live sitemap fetch to answer your first query
• Persistent cache — disk cache for both sitemap (24h) and page content (7 days), survives restarts
• HTTP transport — --http flag for remote/team deployment via Streamable HTTP
• Docker ready — multi-stage Dockerfile for containerized deployment
• Configurable — all settings tunable via environment variables
• Zero config — just add one line to your MCP config and go

Tools

search_adobe_commerce_docs

BM25-ranked search with synonym expansion and fuzzy matching.

get_doc_content

Fetch the full content of a documentation page as clean markdown.

get_code_examples

Extract only the code blocks from a documentation page. Returns fenced code snippets without surrounding prose — much more token-efficient than fetching the full page.

get_page_toc

Get the heading hierarchy (table of contents) of a page. Useful for understanding structure before fetching the full content.

... View full README on GitHub