Sitecore Community MCP

This repository contains the source code for the Sitecore Community MCP server — an

open-source Model Context Protocol server that gives AI

agents direct read/write access to Sitecore, so you stop copy-pasting between your agent

and the Content Editor.

• 121 tools across search, query, create, read, update, delete, media, PowerShell, logging, security and presentation
• Three guides — `guide://compose-page`, `guide://bulk-update` and `guide://diagnose-connection` — resources an agent can read mid-task: two common, complex workflows that you'd want to use this MCP for, plus a connection issue self diagnosis helper.
• Covers four Sitecore API surfaces: the Authoring and Management GraphQL API, the Item Service, GraphQL Edge and Sitecore PowerShell Extensions
• Works with SitecoreAI and Sitecore XM/XP (all versions), from any MCP-compatible client
• Implements MCP protocol revision 2026-07-28, and answers the older `initialize` handshake from the same tool registrations — negotiating down to any revision from `2025-11-25` to `2024-10-07`, so a client on either era sees the same tools
• Reported impact: 5× faster Figma-to-Sitecore workflows and ~70% less manual scaffolding (case study)
• Three ways to run it: npm, Docker, or from source

Getting started with Sitecore Community MCP

To run the Sitecore Community MCP server, you need:

• Node — the latest long-term support (LTS) release.
• A Sitecore XM, XP or SitecoreAI instance. Which parts you enable decides which tools

work: the `authoring.*` groups need only the Authoring and Management API (normally

already on in the cloud) plus a token, while the Item Service and SPE Remoting are off by

default and need a config patch. Preparing your Sitecore instance

covers all three and how to verify each.

Adding the server to your MCP client

Add the entry below to your client's server map — `mcpServers` in Cursor, Claude Code and

most other clients, `servers` in VS Code — and fill in your own endpoints and credentials:

{
  "mcpServers": {
    "sitecore-mcp": {
      "type": "stdio",
      "command": "npx",
      "args": ["@antonytm/mcp-sitecore-server@latest"],
      "env": {
        "TRANSPORT": "stdio",
        "GRAPHQL_ENDPOINT": "https://xmcloudcm.localhost/sitecore/api/graph/",
        "GRAPHQL_SCHEMAS": "edge",
        "GRAPHQL_API_KEY": "{6D3F291E-66A5-4703-887A-D549AF83D859}",
        "GRAPHQL_HEADERS": "",
        "ITEM_SERVICE_DOMAIN": "sitecore",
        "ITEM_SERVICE_USERNAME": "admin",
        "ITEM_SERVICE_PASSWORD": "b",
        "ITEM_SERVICE_SERVER_URL": "https://xmcloudcm.localhost/",
        "POWERSHELL_DOMAIN": "sitecore",
        "POWERSHELL_USERNAME": "admin",
        "POWERSHELL_PASSWORD": "b",
        "POWERSHELL_SERVER_URL": "https://xmcloudcm.localhost/",
        "AUTHORING_CLIENT_ID": "",
        "AUTHORING_CLIENT_SECRET": "",
        "TOOL_PROFILE": ""
      }
    }
  }
}

`TOOL_PROFILE` takes a comma-separated list of presets, and unions what each one hides.

Every preset names something absent or unwanted rather than a platform. Four name an API

surface your instance does not serve — `no-spe`, `no-item-service`,

`no-edge-graphql` and `no-authoring-api` — so an instance missing two of them can

say so. `no-account-management` is the one that is not about a missing surface: it

hides the twelve tools that create or edit an account on the CM, for a deployment that

would rather an agent could not do that at all (item security, and reading accounts and

roles, are untouched):

TOOL_PROFILE=no-spe,no-item-service

`no-spe` is the big one: without SPE installed and its `remoting` service enabled, roughly

three quarters of this server's tools cannot run, and hiding them is schema an agent no

longer pays for on every turn. An unknown name is reported on stderr and ignored, leaving

the rest of the list in force.

Every setting is documented in Configuration. Agents have a limit

on how many tools they can hold, so before you get far, read

Tool selection and trim the surface with `TOOL_PROFILE`,

`TOOL_GROUPS` and `DISABLED_TOOLS`.

To run the server in a container or from source instead, see

Running the server.

How this compares to the Sitecore Marketer MCP

Sitecore's own Marketer MCP is a hosted service aimed

at marketers on SitecoreAI. This server is the developer-grade counterpart, and on that

ground it is the stronger tool:

They are complementary rather than exclusive: the Marketer MCP carries the cloud marketing

features this server has no API for (briefs, brand kits, personalization variants, A/B

tests), and nothing stops a client from connecting both. For building, migrating, auditing

and operating Sitecore solutions, this server is the one with the depth.

Documentation and community resources

• Preparing your Sitecore instance — SPE Remoting, the Item Service, GraphQL keys, and the config patch that enables them
• Running the server — npm, Docker, from source, and the two transports
• Tool reference — every tool, grouped by API surface
• Configuration — environment variables, transports, timeouts and TLS
• Tool selection — `TOOL_GROUPS`, `DISABLED_TOOLS` and `TOOL_PROFILE`
• Guides — the `guide://compose-page`, `guide://bulk-update` and `guide://diagnose-connection` resources, and when each is offered
• Docker images — the published Linux and Windows images
• Changelog — what's new in 2.0 and its breaking changes

Community resources:

• Model Context Protocol specification
• Sitecore PowerShell Extensions documentation
• Sitecore Stack Exchange
• Sitecore Community Slack
• Sitecore Community Forum

Contributions

We are very grateful to the community for contributing bug fixes and improvements. We

welcome all efforts to evolve and improve this server; read below to learn how to

participate in those efforts.

Contributing Guide

Read our contributing guide to learn about our development process, how

to propose bug fixes and improvements, and how to build, debug and test your changes.

License

Sitecore Community MCP is using the Apache 2.0 license.

Support

This is a community project and is not supported by Sitecore.

• Issues, bugs and feature requests: open an issue at

Antonytm/mcp-sitecore-server/issues.

• Questions about Sitecore itself: Sitecore Stack Exchange

or the Sitecore Community Slack will serve you better

than a GitHub issue.