UBOS Asset Marketplace: Supercharge Sitecore with the Model Context Protocol (MCP) Server

In the rapidly evolving landscape of digital experience management, integrating Artificial Intelligence (AI) into content management systems (CMS) is no longer a luxury but a necessity. The UBOS Asset Marketplace offers the Model Context Protocol (MCP) Server for Sitecore, a game-changing tool designed to seamlessly bridge the gap between Sitecore’s robust content management capabilities and the power of AI-driven applications. This integration empowers businesses to unlock unprecedented levels of automation, personalization, and content intelligence.

Understanding the Power of MCP and its Role in UBOS

Before diving into the specifics of the MCP Server for Sitecore, it’s crucial to understand the foundational concepts. MCP, or Model Context Protocol, is an open protocol that standardizes how applications provide context to Large Language Models (LLMs). Think of it as a universal translator, enabling AI models to understand and interact with diverse data sources and tools.

UBOS, the Full-stack AI Agent Development Platform, recognizes the pivotal role of MCP in realizing the full potential of AI Agents. UBOS is focused on democratizing AI Agent technology, bringing its power to every business department. Our comprehensive platform provides the infrastructure and tools to:

• Orchestrate AI Agents: Design and manage complex workflows involving multiple AI Agents working in concert.
• Connect to Enterprise Data: Securely integrate AI Agents with your existing data sources, unlocking valuable insights.
• Build Custom AI Agents: Tailor AI Agents to your specific needs, leveraging your own LLM models.
• Develop Multi-Agent Systems: Create sophisticated AI solutions where multiple agents collaborate to achieve complex goals.

The MCP Server within the UBOS ecosystem is a crucial component that facilitates this seamless integration, enabling AI Agents to interact intelligently with Sitecore content and functionalities.

The MCP Server for Sitecore: A Deep Dive

The MCP Server for Sitecore acts as an intermediary, enabling AI Agents to access and manipulate Sitecore content through a standardized protocol. This eliminates the need for complex custom integrations, saving time and resources while enhancing flexibility. It exposes Sitecore’s functionalities as easily accessible tools for AI Agents.

Key Features and Benefits

• Comprehensive API Coverage: The MCP Server provides a rich set of APIs, covering a wide range of Sitecore functionalities. This includes GraphQL API, Item Service API, and Sitecore PowerShell API, enabling AI Agents to perform diverse tasks within Sitecore.

• GraphQL API: Enables AI Agents to query and retrieve data from Sitecore using the powerful GraphQL query language. This provides efficient and flexible data access, allowing agents to retrieve precisely the information they need.

  • introspection-graphql-{schema}: Allows agents to understand the structure of your Sitecore GraphQL schema.
  • query-graphql-{schema}: Executes GraphQL queries against your Sitecore instance.

• Item Service API: Provides AI Agents with the ability to manage Sitecore items programmatically. This includes creating, reading, updating, and deleting items, enabling automated content management workflows.

  • item-service-get-item: Retrieves a Sitecore item by its ID.
  • item-service-get-item-children: Retrieves the child items of a given item ID.
  • item-service-get-item-by-path: Retrieves a Sitecore item based on its path.
  • item-service-create-item: Creates a new Sitecore item based on a template and parent path.
  • item-service-edit-item: Edits an existing Sitecore item by its ID.
  • item-service-delete-item: Deletes a Sitecore item by its ID.
  • item-service-search-items: Searches for Sitecore items based on specified criteria.
  • item-service-run-stored-query: Executes a pre-defined stored query within Sitecore.
  • item-service-run-stored-search: Executes a pre-defined stored search within Sitecore.
  • item-service-get-languages: Retrieves the languages configured within the Sitecore instance.
  • item-service-get-item-descendants: Retrieves all descendant items of a given item ID.

• Sitecore PowerShell API: Enables AI Agents to execute Sitecore PowerShell scripts, providing access to a wide range of administrative and content management functionalities. This includes security management, provider access, presentation control, indexing, common tasks, and logging.

  • Security: A comprehensive suite of tools for managing users, roles, and permissions within Sitecore.

    • security-get-current-user: Returns the currently logged-in user.
    • security-get-user-by-identity: Retrieves a user by their name.
    • security-get-user-by-filter: Retrieves users based on a 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: Retrieves a list of domains.
    • security-get-domain-by-name: Retrieves a domain by its name.
    • security-get-role-by-identity: Retrieves a role by its name.
    • security-get-role-by-filter: Retrieves roles based on a filter.
    • security-get-role-member: Retrieves the members of a role.
    • security-enable-user: Enables a user account.
    • security-disable-user: Disables a user account.
    • security-set-user-password: Changes a user’s password.
    • security-lock-item-by-id: Locks a Sitecore item by its ID.
    • security-unlock-item-by-id: Unlocks a Sitecore item by its ID.
    • security-lock-item-by-path: Locks a Sitecore item by its path.
    • security-unlock-item-by-path: Unlocks a Sitecore item by its path.
    • security-protect-item-by-id: Protects a Sitecore item by its ID.
    • security-protect-item-by-path: Protects a Sitecore item by its path.
    • security-unprotect-item-by-id: Unprotects a Sitecore item by its ID.
    • security-unprotect-item-by-path: Unprotects a Sitecore item by its path.
    • security-test-acccount: Tests a user account.
    • security-unlock-user: Unlocks a user account.
    • 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 the access control list (ACL) of a Sitecore item by its ID.
    • security-test-item-acl-by-path: Tests the access control list (ACL) of a Sitecore item by its path.
    • security-add-item-acl-by-id: Adds an access control entry (ACE) to a Sitecore item by its ID.
    • security-add-item-acl-by-path: Adds an access control entry (ACE) to a Sitecore item by its path.
    • security-clear-item-acl-by-id: Clears the access control list (ACL) of a Sitecore item by its ID.
    • security-clear-item-acl-by-path: Clears the access control list (ACL) of a Sitecore item by its path.
    • security-set-item-acl-by-id: Sets the access control list (ACL) of a Sitecore item by its ID.
    • security-set-item-acl-by-path: Sets the access control list (ACL) of a Sitecore item by its path.

  • Provider: Tools for accessing Sitecore items through providers.

    • provider-get-item-by-id: Retrieves a Sitecore item by its ID using a provider.
    • provider-get-item-by-path: Retrieves a Sitecore item by its path using a provider.
    • provider-get-item-by-query: Retrieves Sitecore items by a query using a provider.

  • Presentation: Tools for managing the presentation layer of Sitecore items.

    • presentation-get-layout-by-id: Retrieves the layout of a Sitecore item by its ID.
    • presentation-get-layout-by-path: Retrieves the layout of a Sitecore item by its path.
    • presentation-set-layout-by-id: Sets the layout of a Sitecore item by its ID.
    • presentation-set-layout-by-path: Sets the layout of a Sitecore item by its path.

  • Indexing: Tools for managing Sitecore search indexes.

    • indexing-initialize-search-index: Initializes one or more search indexes.
    • indexing-get-search-index: Retrieves 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: Tools for accessing common Sitecore functionalities.

    • common-get-database: Returns information about Sitecore databases
    • common-get-cache: Returns information about Sitecore caches
    • common-get-item-template-by-id: Returns template information for a Sitecore item by ID
    • common-get-item-template-by-path: Returns template information for a Sitecore item by path
    • common-get-item-reference-by-id: Returns item references (where it is used) for a Sitecore item by ID
    • common-get-item-reference-by-path: Returns item references (where it is used) for a Sitecore item by path
    • common-get-item-referrer-by-id: Returns items referring to a Sitecore item by ID (which items reference it)
    • common-get-item-referrer-by-path: Returns items referring to a Sitecore item by path (which items reference it)

  • Logging: Tools for retrieving Sitecore logs.

    • logging-get-logs: retrieves Sitecore logs from the log directory with filtering options

• Simplified Installation and Configuration: The MCP Server is designed for easy installation and configuration. It leverages environment variables for flexible customization, allowing you to tailor the server to your specific Sitecore environment. See the installation example below.

• Extensibility and Customization: The MCP Server is built with extensibility in mind. Developers can easily extend the server with custom tools and functionalities to meet specific business requirements.

• Enhanced Security: The MCP Server supports secure authentication and authorization mechanisms, ensuring that AI Agents can only access and manipulate Sitecore content with appropriate permissions.

Use Cases

The MCP Server for Sitecore opens up a wide range of exciting use cases for AI-powered content management:

• Automated Content Generation: AI Agents can automatically generate content based on predefined templates and data sources, significantly reducing content creation time and costs.
• Intelligent Content Personalization: AI Agents can analyze user behavior and preferences to personalize content in real-time, enhancing user engagement and conversion rates.
• Automated Content Moderation: AI Agents can automatically moderate user-generated content, ensuring compliance with content policies and regulations.
• AI-Powered Content Optimization: AI Agents can analyze content performance data to identify areas for improvement, optimizing content for search engines and user engagement.
• Automated Workflow Management: AI Agents can automate content approval workflows, streamlining content publishing processes.
• AI-Driven Search and Discovery: Improve search accuracy and relevance within Sitecore using AI-powered search algorithms.
• Automated Security Management: Leverage AI agents to automate security tasks such as user provisioning, role assignment, and access control list (ACL) management.

Installation Guide

Integrating the MCP Server with your AI Agent development platform (such as Cursor, VS Code, or Claude) is straightforward. Simply add the following configuration snippet to your platform’s settings:

"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/",
    }
}

Important: Replace the placeholder values with your actual Sitecore environment details. Refer to the Environment Variables Description section for more details on each setting.

Environment Variables Explained

Understanding the environment variables is crucial for configuring the MCP Server correctly:

• TRANSPORT: Specifies the transport protocol for communication. Use stdio for standard input/output.
• GRAPHQL_ENDPOINT: The URL of your Sitecore GraphQL endpoint.
• GRAPHQL_SCHEMAS: A comma-separated list of GraphQL schemas to use (e.g., edge,master,core).
• GRAPHQL_API_KEY: The API key required to access the GraphQL endpoint.
• GRAPHQL_HEADERS: Additional headers to include in GraphQL requests (optional).
• ITEM_SERVICE_DOMAIN: The domain for Item Service authentication (default: sitecore).
• ITEM_SERVICE_USERNAME: The username for Item Service authentication.
• ITEM_SERVICE_PASSWORD: The password for Item Service authentication.
• ITEM_SERVICE_SERVER_URL: The base URL of your Sitecore instance for Item Service.
• POWERSHELL_DOMAIN: The domain for PowerShell Remoting authentication (default: sitecore).
• POWERSHELL_USERNAME: The username for PowerShell Remoting authentication.
• POWERSHELL_PASSWORD: The password for PowerShell Remoting authentication.
• POWERSHELL_SERVER_URL: The base URL of your Sitecore instance for PowerShell Remoting.

Optimizing AI Agent Performance through Tool Selection

AI Agents often have limitations on the number of tools they can effectively utilize. To optimize performance and reduce costs, it’s crucial to disable any tools within the MCP Server that are not required for a specific agent’s task. This targeted approach ensures that your agents operate efficiently and economically.

Getting Started with Local Development

For developers who wish to contribute to the MCP Server or customize it for their specific needs, a local development environment is readily achievable:

1. Clone the Repository: Begin by cloning the MCP Server repository from its source.
2. Install Dependencies: Navigate to the project directory in your terminal and execute npm install to install all necessary dependencies.
3. Build the Project: Run npm run build to compile the project and generate the necessary build artifacts.
4. Start the Server: Finally, execute npm start to launch the MCP Server locally.

Contributing to the Project

We encourage community contributions to the MCP Server. If you’re interested in contributing, please review our CONTRIBUTING.md file for guidelines and best practices.

Conclusion

The UBOS Asset Marketplace’s MCP Server for Sitecore is a pivotal tool for organizations seeking to leverage the power of AI within their Sitecore environments. By providing a standardized and secure interface for AI Agents to interact with Sitecore’s functionalities, the MCP Server unlocks new possibilities for automation, personalization, and content intelligence. Embrace the future of content management with UBOS and the MCP Server for Sitecore, and transform your digital experiences.

With the UBOS platform and the MCP Server, you can now build AI Agents that:

• Dynamically personalize website content based on user behavior.
• Automate content creation workflows, from initial draft to final publication.
• Proactively identify and mitigate security vulnerabilities within your Sitecore environment.
• Optimize search engine rankings through AI-driven content analysis and optimization.

Don’t just manage your content; empower it with AI. Explore the UBOS Asset Marketplace and discover how the MCP Server for Sitecore can revolutionize your digital experience.