Sitecore MCP Server

How to use

You will connect your MCP client to the Sitecore MCP server to perform GraphQL queries, fetch and manipulate items, and run Sitecore-related operations. Use the provided stdio-based runtime configuration to launch the MCP server locally, then direct your client to the appropriate endpoints for GraphQL and item services.

Typical usage patterns include querying the GraphQL schema and executing queries, retrieving items by ID or path, creating and editing items, and running stored queries or searches. You can also manage Sitecore security and item ACLs, and leverage presentation and indexing endpoints as needed. Ensure you supply the required environment variables to enable authentication and access to your Sitecore instance.

How to install

Prerequisites: you need Node.js and npm installed on your system. Ensure you have network access to the Sitecore endpoints you will connect to.

Step 1: Install and start the MCP server as an MCP client within your environment using the provided runtime configuration.

Step 2: Configure the MCP client with the following settings to connect to Sitecore and enable the MCP features.

Configuration and usage notes

Environment variables shown in the configuration snippet control how the MCP server connects to GraphQL, Item Service, and PowerShell endpoints. You will need to supply the actual URLs, credentials, and API keys for your Sitecore instance.

{
  "Sitecore": {
    "type": "stdio",
    "command": "npx",
    "args": ["@antonytm/mcp-sitecore-server@latest"],
    "env": {
      "TRANSPORT": "stdio",
      "GRAPHQL_ENDPOINT": "https://xmcloudcm.localhost/sitecore/api/graph/",
      "GRAPHQL_SCHEMAS": "edge,master,core",
      "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/"
    }
  }
}

Security and access

Security-related MCP endpoints are included for managing domains, users, roles, ACLs, and items. You can enable or disable users, change passwords, and control item protections and ACLs as part of your Sitecore security strategy.

Docker images

If you prefer containerized deployment, you can use the Linux or Windows MCP Sitecore images to run the server in a containerized environment.

Local installation / development quick-start

1) Clone the project repository.

2) Install dependencies.

3) Build the project.

4) Start the server.

GraphQL API

Provides a GraphQL schema introspection endpoint and the ability to execute GraphQL queries against the Sitecore instance.

Item Service API

Offers operations to get, create, edit, delete, and search Sitecore items, plus stored query and stored search support.

Composite Item Service API

Aggregates languages, descendants, and extended item operations for broader Sitecore item management.

Sitecore Powershell

Runs PowerShell scripts and provides documentation for PowerShell commands (where implemented).

Security

Manages domains, users, roles, ACLs, and item protections with various security-related actions.

Provider

Retrieves items by ID, path, or query, enabling programmatic access to Sitecore items.

Presentation

Manages item presentation layouts, renderings, placeholders, and related rendering properties.

Indexing

Controls search index initialization, item indexing, and index lifecycle operations.

Common

A broad set of shared utilities for item templating, cloning, versioning, workflow, publishing, and item state management.

Logging

Retrieves Sitecore logs with filtering options.