Sitecore MCP Server: Release 1.0.0

Anton Tishchenko
Anton Tishchenko
Cover Image for Sitecore MCP Server: Release 1.0.0

We are happy to announce a huge milestone for Sitecore Model Context Protocol Server: the release of 1.0.0 version. It will not be the dry release notes, but more like a retrospective. If you want the list of available tools in this release, please scroll to the bottom.

What was done?

We implemented MCP tools for all APIs that are publicly available on both on-prem and cloud Sitecore versions. It includes Item Service REST API, GraphQL API, and all suitable PowerShell commands.

The total number of tools is 102! 2 tools for GraphQL, 11 tools for Item Service API, 89 tools for PowerShell commands.

It was a very interesting project. We gave LLMs the ability to translate Sitecore content. We reverse-engineered the Sitecore PowerShell communication protocol and allowed calling PowerShell commands as a tool. We added the ability to manage Sitecore security. Ability to read Sitecore logs made LLM agents capable of fixing bugs by themself. Search tools made LLMs capable of easily finding items not only by ID or path. Running in Docker and basic authorization allowed secure usage with remote environments. Presentation tools made it possible to add renderings to the page. And finally, we integrated AI agents reinforced with Sitecore MCP Servers into Jira. We made it possible to manage content tasks(translation, content creation, etc.) for AI agents and people in the same interface!

Plans

The next phase will be improvements.

Tools usage quality. Not everything works great. For example, GraphQL tools work only with large language models that have a big context window, like Google Gemini, due to the size of the Sitecore GraphQL introspection schema. The goal is to make all tools work with all models.

Quantity. Also, 100+ tools are too many. We covered all possible APIs for testing purposes. We wanted to understand how LLMs will behave with all of them. Not all of them are equally beneficial. e.g., we have many security tools. They work great. But will you use them in day-to-day work? Probably not. That is why some tools will be disabled by default, and some might be deleted.

Naming of tools and parameters. We followed the naming used in the API. But that is not always the best choice for AI. Some tools will be renamed, and some parameters will be renamed. All to make AI agents work better with our tools.

Use cases. There are already tons of use cases, how the Sitecore MCP server can speed up your Sitecore work. But we still will be working on adding more and more: code generation, presentation setup, bulk data processing.

Presentations. Unfortunately, my Sitecore Symposium talk about the Sitecore MCP server was not selected. So, I will present the Sitecore MCP server somewhere else.

The new tools are coming! There will be two additional groups of tools. One will be RAG-like tools that provide documentation. Second will be composite tools that join a few tool calls together into one call.

Experience

During the implementation of the Sitecore MCP server in EXDST, we gained experience in integrating AI into complex systems, like Sitecore. Now, we understand what is possible, what is not possible. What will work in 100% of cases, what will work in 50% of cases, and what will not work at all. Also, we got an understanding of the differences among all top-tier LLMs. If you want to integrate AI into your workflow, we are ready to help. Contact us!

And finally, release notes

The full list of available commands:

  • introspection-grahpql-{schema}: returns the GraphQL schema
  • query-graphql-{schema}: executes a GraphQL query
  • item-service-get-item: returns an item by ID
  • item-service-get-item-children: returns the children of an item by ID
  • item-service-get-item-by-path: returns an item by path
  • item-service-create-item: creates an item by providing a template ID and parent path.
  • item-service-edit-item: edits an item by ID
  • item-service-delete-item: deletes an item by ID
  • item-service-search-items: searches for items
  • item-service-run-stored-query: runs a stored query
  • item-service-run-stored-search: runs a stored search
  • item-service-get-languages: returns Sitcore languages in the instance
  • item-service-get-item-descendants: returns the descendants of an item by ID
  • security-get-current-user: returns the current user
  • security-get-user-by-identity: returns a user by name
  • security-get-user-by-filter: returns a user by filter
  • security-new-domain: creates a new domain
  • security-new-user: creates a new user
  • security-new-role: creates a new role
  • security-remove-domain: removes a domain
  • security-remove-user: removes a user
  • security-remove-role: removes a role
  • security-get-domain: returns a domains
  • security-get-domain-by-name: returns a domain by name
  • security-get-role-by-identity: returns a role by name
  • security-get-role-by-filter: returns a role by filter
  • security-get-role-member: returns members of a role
  • security-enable-user: enables a user
  • security-disable-user: disables a user
  • security-set-user-password: changes a user's password
  • security-lock-item-by-id: locks an item by ID
  • security-unlock-item-by-id: unlocks an item by ID
  • security-lock-item-by-path: locks an item by path
  • security-unlock-item-by-path: unlocks an item by path
  • security-protect-item-by-id: protects an item by ID
  • security-protect-item-by-path: protects an item by path
  • security-unprotect-item-by-id: unprotects an item by ID
  • security-unprotect-item-by-path: unprotects an item by path
  • security-test-acccount: tests an account
  • security-unlock-user: unlocks a user
  • security-add-role-member: adds a member to a role
  • security-remove-role-member: removes a member from a role
  • security-test-item-acl-by-id: tests an item ACL by ID
  • security-test-item-acl-by-path: tests an item ACL by path
  • security-add-item-acl-by-id: adds an item ACL by ID
  • security-add-item-acl-by-path: adds an item ACL by path
  • security-clear-item-acl-by-id: clears an item ACL by ID
  • security-clear-item-acl-by-path: clears an item ACL by path
  • security-set-item-acl-by-id: sets an item ACL by ID
  • security-set-item-acl-by-path: sets an item ACL by path
  • provider-get-item-by-id: returns an item by ID
  • provider-get-item-by-path: returns an item by path
  • provider-get-item-by-query: returns an item by query
  • provider-get-item-by-path: returns an item by path
  • presentation-get-layout-by-id: returns item presentation layout by ID
  • presentation-get-layout-by-path: returns item presentation layout by path
  • presentation-set-layout-by-id: sets item presentation layout by ID
  • presentation-set-layout-by-path: sets item presentation layout by path
  • presentation-reset-layout-by-id: resets item presentation layout by ID
  • presentation-reset-layout-by-path: resets item presentation layout by path
  • presentation-merge-layout-by-id: Merges final and shared layouts by item Id
  • presentation-merge-layout-by-path: Merges final and shared layouts by item path
  • presentation-get-layout-device: Gets the layout for the device specified
  • presentation-get-default-layout-device: Gets the default layout
  • presentation-get-rendering-by-id: Gets rendering definition by item id
  • presentation-get-rendering-by-path: Gets rendering definition by item path
  • presentation-remove-rendering-by-path: Removes renderings from an item by owners item path
  • presentation-remove-rendering-by-id: Removes renderings from an item by owners item ID
  • presentation-add-rendering-by-path: Adds a rendering to presentation of an item specified by path
  • presentation-add-rendering-by-id: Adds a rendering to presentation of an item specified by item ID
  • presentation-set-rendering-by-path: Updates rendering specified by item path with new values
  • presentation-set-rendering-by-id: Updates rendering specified by item ID with new values
  • presentation-switch-rendering-by-id: Switches an existing rendering specified by item ID with an alternate one for the item specified by item ID
  • presentation-switch-rendering-by-path: Switches an existing rendering specified by path with an alternate one for the item specified by path
  • presentation-switch-rendering-by-unique-id: Switches an existing rendering specified by unique ID with an alternate one for the item specified by item ID
  • presentation-get-placeholder-setting-by-id: Gets placeholder setting assigned on the item specified by ID
  • presentation-get-placeholder-setting-by-path: Gets placeholder setting assigned on the item specified by path
  • presentation-add-placeholder-setting-by-id: Adds a placeholder setting to the item specified by ID
  • presentation-add-placeholder-setting-by-path: Adds a placeholder setting to the item specified by path
  • presentation-remove-placeholder-setting-by-id: Removes placeholder setting from the item specified by ID
  • presentation-remove-placeholder-setting-by-path: Removes placeholder setting from the item specified by path
  • presentation-get-rendering-parameter-by-id: Gets rendering parameter for the item specified by ID
  • presentation-get-rendering-parameter-by-path: Gets rendering parameter for the item specified by path
  • presentation-remove-rendering-parameter-by-id: Removes the specified rendering parameter from the rendering placed on the item specified by ID
  • presentation-remove-rendering-parameter-by-path: Removes the specified rendering parameter from the rendering placed on the item specified by path
  • presentation-set-rendering-parameter-by-id: Adds and updates the specified rendering parameter from the rendering placed on the item specified by ID
  • presentation-set-rendering-parameter-by-path: Adds and updates the specified rendering parameter from the rendering placed on the item specified by path
  • indexing-initialize-search-index: initializes one or more search indexes
  • indexing-get-search-index: returns a search index
  • indexing-find-item: finds an item in a search index
  • indexing-suspend-search-index: suspends one or more running search indexes
  • indexing-stop-search-index: stops one or more running search indexes
  • indexing-resume-search-index: resumes one or more paused search indexes
  • indexing-initialize-search-index-item-by-id: rebuilds the index for a given tree with the specified root item by ID and index name
  • indexing-initialize-search-index-item-by-path: rebuilds the index for a given tree with the specified root item by path and index name
  • indexing-remove-search-index-item-by-id: removes the item with the specified ID from the search index
  • indexing-remove-search-index-item-by-path: removes the item with the specified path from the search index
  • common-add-base-template-by-id: adds a base template to a template item by ID
  • common-add-base-template-by-path: adds a base template to a template item by path
  • common-add-item-version-by-id: creates a version of the item (by its id) in a new language based on an existing language version
  • common-add-item-version-by-path: creates a version of the item (by its path) in a new language based on an existing language version
  • common-convert-from-item-clone-by-id: converts an item from a clone to a fully independent item by ID
  • common-convert-from-item-clone-by-path: converts an item from a clone to a fully independent item by path
  • common-get-archive: gets Sitecore database archives
  • common-get-archive-item: gets a list of items found in the specified archive
  • common-get-cache: gets information about Sitecore caches
  • common-get-database: gets information about Sitecore databases
  • common-get-item-field-by-id: gets item fields as either names or fields or template fields by ID
  • common-get-item-field-by-path: gets item fields as either names or fields or template fields by path
  • common-get-item-clone-by-id: gets all the clones for the specified item by ID
  • common-get-item-clone-by-path: gets all the clones for the specified item by path
  • common-get-item-reference-by-id: gets item references (where it is used) for a Sitecore item by ID
  • common-get-item-reference-by-path: gets item references (where it is used) for a Sitecore item by path
  • common-get-item-referrer-by-id: gets items referring to a Sitecore item by ID (which items reference it)
  • common-get-item-referrer-by-path: gets items referring to a Sitecore item by path (which items reference it)
  • common-get-item-template-by-id: gets template information for a Sitecore item by ID
  • common-get-item-template-by-path: gets template information for a Sitecore item by path
  • common-get-item-workflow-event-by-id: gets entries from the workflow history for the specified item by ID
  • common-get-item-workflow-event-by-path: gets entries from the workflow history for the specified item by path
  • common-get-sitecore-job: gets list of the current Sitecore jobs
  • common-invoke-workflow-by-id: executes workflow action for a Sitecore item by ID
  • common-invoke-workflow-by-path: executes workflow action for a Sitecore item by path
  • common-new-item-clone-by-id: creates a new item clone based on the item provided by ID
  • common-new-item-clone-by-path: creates a new item clone based on the item provided by path
  • common-new-item-workflow-event-by-id: creates a new entry in the workflow history for a Sitecore item by ID
  • common-new-item-workflow-event-by-path: creates a new entry in the workflow history for a Sitecore item by path
  • common-publish-item-by-id: publishes a Sitecore item by ID
  • common-publish-item-by-path: publishes a Sitecore item by path
  • common-remove-archive-item: removes items permanently from the specified archive
  • common-remove-base-template-by-id: removes a base template from a template item by ID
  • common-remove-base-template-by-path: removes a base template from a template item by path
  • common-remove-item-version-by-id: removes a version of a Sitecore item by ID
  • common-remove-item-version-by-path: removes a version of a Sitecore item by path
  • common-reset-item-field-by-id: resets item fields, specified as either names, fields or template fields by ID
  • common-reset-item-field-by-path: resets item fields, specified as either names, fields or template fields by path
  • common-restart-application: restarts the Sitecore Application pool
  • common-restore-archive-item: restores items to the original database from the specified archive
  • common-set-item-template-by-id: sets the item template by ID
  • common-set-item-template-by-path: sets the item template by path
  • common-test-base-template-by-id: checks if the item inherits from the specified template by ID
  • common-test-base-template-by-path: checks if the item inherits from the specified template by path
  • common-update-item-referrer-by-id: updates all references to the specified item (by ID) to point to a new provided in the -NewTarget or removes links to the item
  • common-update-item-referrer-by-path: updates all references to the specified item (by path) to point to a new provided in the -NewTarget or removes links to the item