1. Integrating Sitecore with agentic platforms

Sitecore Marketer MCP server

Description

The Sitecore Marketer MCP server enables AI agents to interact with SitecoreAI using natural language. It translates user prompts into secure, executable actions such as creating pages, managing content, and optimizing campaigns.

Built on the Model Context Protocol (MCP), it connects AI clients (for example, Claude Desktop, Cursor IDE) to SitecoreAI tools through the Agent API, providing secure access across the entire digital experience lifecycle.

As part of Sitecore's interoperability with agentic platforms, it enables marketers and AI agents to work together more effectively, simplifying workflows, automating tasks, and connecting digital experiences.

Marketers can simply ask an AI agent to create pages, add components, or update content using natural language. The server interprets the request, invokes the appropriate SitecoreAI tools, and completes the task without requiring users to navigate the interface or manage API calls.

Features

The Marketer MCP server supports the following capabilities:

  • Site management - retrieve and manage websites, including structure and associated pages for better visibility and control.

  • Page management - create, update, and organize pages, components, and layouts to maintain consistent digital experiences.

  • Content management - manage structured content items, including creation, updates, deletion, and retrieval across systems.

  • Component management - browse available components and configure their datasources for dynamic content delivery.

  • Asset management - search, upload, and manage digital assets and their metadata for efficient media handling.

  • Personalization - create and manage personalized content variants and targeting rules to improve user engagement.

  • Brand kits - retrieve and manage brand kits to ensure consistency across campaigns and channels.

  • Briefs - create, refine, and save marketing briefs to support campaign planning and execution.

Setup

The Marketer MCP server can be connected from any compatible MCP client.

Before you begin

Before connecting, make sure you have:

  • A compatible MCP client (for example, Claude Desktop, Cursor IDE, or Copilot Studio).

  • An Admin role in the SitecoreAI app.

Each client requires specific configuration to communicate with the Marketer MCP server. Follow the instructions below for your specific client.

Note

The previous MCP server URL https://edge-platform.sitecorecloud.io/mcp/marketer-mcp-prod is still supported but is being deprecated. Use the updated URL https://marketer.sitecorecloud.io/mcp/marketer-mcp-prod for new configurations.

Claude Desktop

In Claude Desktop, you connect the Marketer MCP server as a custom connector.

To set up a connection:

  1. Open Claude Desktop.

  2. Click your profile name in the left sidebar, then select Settings.

  3. In Settings, go to Connectors.

  4. Click Add custom connector.

  5. In the Add custom connector dialog, enter the following details:

    • Name - the server name: Marketer MCP.

    • Remote MCP server URL - the URL of the remote MCP server:

      https://marketer.sitecorecloud.io/mcp/marketer-mcp-prod

  6. Click Add. The Marketer MCP appears under your list of connectors.

  7. Click Connect to launch the authorization page in your browser.

  8. In the Marketer MCP server authorization request dialog, click Allow Access.

  9. Select the organization and tenant you want to use when interacting with the MCP server.

  10. When prompted, click Open Claude to complete the setup.

  11. To verify the connection, enter a simple prompt such as: List all available sites. If the connection is successful, the server returns a list of sites for your tenant.

You can now start using prompts to interact with SitecoreAI. See example prompts and the Marketer MCP tool reference for guidance.

Cursor IDE

In Cursor IDE, you add the Marketer MCP server as a custom MCP server.

To set up a connection:

  1. Open Cursor IDE.

  2. Go to Settings > MCP.

  3. Click New MCP Server.

  4. Copy and paste the following configuration into your mcp.json file, then save it:

    {
  "mcpServers": {
    "marketer": {
      "url": "https://marketer.sitecorecloud.io/mcp/marketer-mcp-prod",
      "auth": {
        "type": "external"
      }
    }
  }
}

  5. The Marketer MCP now appears in your list of available tools. Click Connect.

    Cursor will prompt you to confirm opening an external website.

  6. Click Open to launch the authorization page in your browser.

  7. In the Marketer MCP server authorization request dialog, click Allow Access.

  8. Select the organization and tenant you want to use when interacting with the MCP server.

  9. When prompted, click Open Cursor to complete the setup.

  10. To verify the connection, enter a simple prompt such as: List all available sites. If the connection is successful, the server returns a list of sites for your tenant.

You can now start using prompts to interact with SitecoreAI. See example prompts and the Marketer MCP tool reference for guidance.

Copilot Studio

In Microsoft Copilot Studio, you connect your agent to the Marketer MCP server as a custom server and use it as a tool. Watch the Add an MCP server to your Copilot Studio agent video to learn more.

Important

During OAuth authentication, Copilot Studio does not automatically include the required resource query parameter in the authorization URL. This causes a Resource parameter is required error. You must manually append the parameter as in steps 7–8 below.

To set up a connection:

  1. Open Copilot Studio and either create a new agent or open an existing one.

  2. Go to the Tools tab for your agent then click Add a tool.

  3. Click New tool then choose Model Context Protocol. The MCP onboarding wizard opens.

  4. Enter the following details:

    • Server name - for example, Marketer MCP.

    • Server description - a short description of what the Marketer MCP does.

    • Server URL - the Marketer MCP server endpoint:

      https://marketer.sitecorecloud.io/mcp/marketer-mcp-prod

  5. Under Authentication, select OAuth 2.0 and Dynamic discovery type. Then click Create.

  6. In the Add tool dialog, in Connection, click Not connected > Create new connection. Then click Create.

    A pop-up dialog appears with the message Resource parameter is required. This is expected. Follow the workaround below.

  7. Copy the entire URL shown in the dialog. Append the following resource parameter to the end of the URL:

    &resource=https%3A%2F%2Fmarketer.sitecorecloud.io%2Fmcp%2Fmarketer-mcp-prod

  8. Open a new browser window, paste the updated URL into the address bar and press Enter.

  9. In the Marketer MCP server authorization request dialog, click Allow Access.

  10. Select the organization and tenant you want to use when interacting with the MCP server.

  11. Return to the Add tool dialog in Copilot Studio. When it shows that you're connected to the MCP server, click Add and configure.

  12. To verify the connection, test your agent in the chat panel with a prompt such as: List all available sites. If the connection is successful, the server returns a list of sites for your tenant.

You can now start using prompts to interact with SitecoreAI. See example prompts and the Marketer MCP tool reference for guidance.

Other clients

You can connect the Marketer MCP server using other MCP-compatible clients. Select a client below for setup instructions:

Use the following configuration to set up a connection:

{
  "mcpServers": {
    "marketer": {
      "url": "https://marketer.sitecorecloud.io/mcp/marketer-mcp-prod",
      "auth": {
        "type": "external"
      }
    }
  }
}

This configuration defines the server endpoint and uses external authentication to securely connect from your chosen client.

To verify the connection, enter a simple prompt such as: List all available sites. If the connection is successful, the server returns a list of sites for your tenant.

Authentication

The Marketer MCP server uses an authorization code flow with interactive user authentication via Sitecore Identity. This ensures secure, user-initiated sign-in and maintains tenant-level isolation.

Process overview:

  1. Sign-in - the MCP host opens the Sitecore login page.

  2. User authentication - the user signs in with valid credentials.

  3. Authorization - the user grants access to the Marketer MCP server.

  4. Organization and tenant selection - the user selects their organization and tenant.

  5. Token storage - access and refresh tokens are securely stored within the tenant context.

  6. API access - all tool calls use authenticated tokens scoped to the selected tenant.

Examples

The following examples demonstrate how the Sitecore Marketer MCP server is used to perform common tasks through natural language prompts.

Example 1: Create a landing page

User prompt:Create a new landing page for our summer discount promo

What happens:

  • The server creates a landing page under the site’s Home (or selected parent) using an appropriate template.

  • The agent adds components (for example, Hero, Page Header, Text Banner, Promo).

  • The agent populates content, images, and links based on the request.

  • Optional page-level fields (such as SEO or metadata) may be updated.

  • The server saves the page in SitecoreAI.

  • The server returns the page item ID, content path, and route.

Example 2: Create content

User prompt:Create a new blog post about the summer promo

What happens:

  • The server creates a new article page using an appropriate template.

  • The agent adds components (for example, Page Header, Rich Text, CTA banner).

  • The agent populates content and internal links.

  • Optional page-level fields (such as title, summary, and SEO metadata) may be updated.

  • The server saves the page in SitecoreAI.

  • The server returns the page item ID, content path, and route.

Example 3: Create a marketing brief

User prompt:Create a marketing brief for a special brand anniversary sale

What happens:

  • The server generates a draft brief based on the available brand kit and brief type.

  • The agent presents the brief and prompts for updates or changes.

  • You review and confirm the brief.

  • The server saves the brief as a draft in SitecoreAI.

  • The server returns the brief ID, name, status, and locale.

Privacy policy

The Marketer MCP server processes data in accordance with Sitecore’s privacy practices and applicable data protection regulations.

For more information, see the Sitecore privacy policy.

Support

For additional help using the Sitecore Marketer MCP server, you can access the following resources:

For issues, questions, or troubleshooting, create a support case through the Sitecore Cloud Portal.

If you have suggestions for improving this article, let us know!