1. SitecoreAI documentation for business users

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 and retrieve pages, and organize the components and layouts within them.
  • 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 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.
  • Brand context - retrieve brand contexts, browse their folder and file structure, and retrieve content.
  • Briefs - create, refine, and save marketing briefs, retrieve available brief types, and retrieve details of a specific brief.
  • Experiments - create and update component-level A/B/n tests on a page.
  • Flow definitions - retrieve flow definitions (A/B/n tests and personalizations) on a page, configure variants, and retrieve details of a specific variant.

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 such as Claude Desktop, Cursor IDE, Copilot Studio, Postman, or the Codex app.
  • A SitecoreAI account with at least the User app role and access to the organization and tenant you want to use. Your role determines which features and actions are available to you when using the MCP server.

Each client requires specific configuration to communicate with the Marketer MCP server. Follow the procedure for your preferred 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.

Connect using Claude Desktop

Add Marketer MCP server as a custom remote connector in Claude Desktop.

To connect using Claude Desktop:

  1. Open Claude Desktop.

  2. Open Customize > Connectors.

  3. Click Add > Add custom connector.

  4. Enter the following information:

    • Name: Marketer MCP.

    • Remote MCP server URL:

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

  5. Click Continue.

  6. Review the detected authentication settings and continue by clicking Add.

  7. Click Connect, then click Continue connecting.

  8. On the Sitecore authorization page, click Allow Access.

  9. Select your organization and tenant.

  10. When prompted, click Open Claude to complete authentication and return to Claude Desktop.

  11. To verify that Marketer MCP is available and that its tools can be used, start a new conversation in Claude Desktop and enter a prompt like List all available sites. If the connection is successful, the client returns a list of sites for the selected tenant.

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

Connect using Cursor

Connect Marketer MCP server as a remote MCP server in Cursor.

To connect using Cursor:

  1. Open Cursor.

  2. Go to the Cursor Settings.

  3. Click Customize > MCPs.

  4. Click New MCP Server to open the configuration file.

  5. Add the following configuration to mcp.json:

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

  6. Save the file.

  7. Return to the MCP server list and click Authenticate for Marketer MCP.

  8. On the Sitecore authorization page, click Allow Access.

  9. Select your organization and tenant.

  10. When prompted, click Open Cursor to complete authentication and return to Cursor.

  11. To verify that Marketer MCP is available and that its tools can be used, open a Cursor chat, select Agent mode, and enter a prompt like List all available sites. If the connection is successful, the client returns a list of sites for the selected tenant.

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

Connect using Visual Studio Code

Configure Marketer MCP in Visual Studio Code and enable it for GitHub Copilot Chat.

Before you begin

Make sure you have GitHub Copilot Chat enabled in Visual Studio Code.

To learn more, see Set up GitHub Copilot in VS Code.

To connect using Visual Studio Code:

  1. Open Visual Studio Code.

  2. Open the Command Palette:

    • Windows: Ctrl+Shift+P
    • macOS: Shift+Command+P

  3. Search for and select MCP: Open User Configuration.

  4. Add the following configuration to the user-profile mcp.json:

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

  5. Save the configuration.

  6. In themcp.jsonfile, click Start above the Marketer MCP server configuration. Alternatively, use MCP: List Servers in the Command Palette to locate and start the server.

  7. If prompted to open an external website, click Allow.

  8. Click Open.

  9. On the Sitecore authorization page, click Allow Access.

  10. Select your organization and tenant.

  11. When prompted, click Open Visual Studio Code to complete authentication and return to Visual Studio Code.

  12. To verify that Marketer MCP is available and that its tools can be used, open the AI chat, select Agent mode, and enter a prompt like List all available sites. If the connection is successful, the client returns a list of sites for the selected tenant.

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

Connect using Copilot Studio

Connect the Marketer MCP server to a Microsoft Copilot Studio agent by using it as a tool. To learn more, watch the Add an MCP server to your Copilot Studio agent video.

Before you begin

Make sure you have created an agent in Copilot Studio.

To connect using Copilot Studio:

  1. Open Copilot Studio and open an existing agent.

  2. Go to the agent's Tools tab

  3. Click Add a tool.

  4. In the Create New section, select Model Context Protocol.

  5. In the Add a Model Context Protocol server dialog, enter the following details:

    • Server name: Marketer MCP.

    • Server description: For example,Connects Copilot Studio to the Sitecore Marketer MCP server.

    • Server URL:

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

  6. Under Authentication, select OAuth 2.0.

  7. Enter the following OAuth details:

    • Type: Dynamic

    • Authorization URL:

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

    • Token URL template:

      https://marketer.sitecorecloud.io/mcp/token

  8. Click Create.

  9. When Copilot Studio displays the redirect URL and MCP server details, click Next.

  10. In the Add tool dialog, go to Connection.

  11. Click Not connected, then click Create new connection.

  12. Click Create.

  13. On the Sitecore authorization page, click Allow Access.

  14. Select your organization and tenant.

  15. When the connection shows as connected, click Add and configure.

  16. To verify that Marketer MCP is available and that its tools can be used, open the agent test chat panel and enter a prompt like List all available sites. If the connection is successful, the client returns a list of sites for the selected tenant.

Note

If Copilot Studio asks you to connect the MCP server before using it, open the connection manager, click Connect, click Submit, and then retry the prompt

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

Connect using Postman

Connect the Marketer MCP server to an AI request in Postman and test prompts directly using an AI model provider such as OpenAI, Google Gemini, or another supported provider.

Before you begin

Make sure you have an AI request created in Postman and credentials configured for your chosen provider.

To connect using Postman:

  1. Open Postman and open an existing AI request.

  2. Open the Tools tab.

  3. In the Add Server field, enter the Marketer MCP server endpoint:

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

  4. Click Add Server. Postman lists the server under MCP Servers.

  5. Click Authorize.

  6. On the Sitecore authorization page, click Allow Access.

  7. Select your organization and tenant.

  8. Return to Postman and confirm that the Marketer MCP server is enabled and that the available tools are displayed.

  9. Click Save to save the AI request.

  10. To verify that Marketer MCP is available and that its tools can be used, open the Prompt tab, enter a prompt like List all available sites and then click Send. If the connection is successful, the client returns a list of sites for the selected tenant.

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

Connect using Codex app

You can connect the Marketer MCP server to the Codex app and use it to interact with Sitecore using natural language prompts.

To connect using Codex app:

  1. Open the Codex app.

  2. Open Settings from the left pane, then select Settings.

  3. Go to Integrations and select MCP servers.

  4. Click Add server.

  5. Enter the following details:

    • Name: Marketer MCP.

    • Transport Type: Streamable HTTP.

    • Remote MCP server URL:

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

  6. Click Save. The Marketer MCP appears under your list of MCP servers.

  7. Click Authenticate.

  8. On the Sitecore authorization page, click Allow Access.

  9. Select your organization and tenant.

  10. To verify that Marketer MCP is available and that its tools can be used, start a new chat in Codex and enter a prompt like *List all available sites. If the connection is successful, the client returns a list of sites for the selected tenant.

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

Connect using another MCP-compatible client

Use your client's supported MCP configuration and OAuth authentication process to connect to Marketer MCP.

To connect using another MCP-compatible client:

  1. Open your MCP client.

  2. Add a new MCP server.

  3. Configure the connection using the following details:

    • Server name: Marketer MCP.

    • Transport Type: Streamable HTTP.

    • Server URL:

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

  4. If your client uses a JSON configuration file, adapt the following example to its supported format:

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

  5. Save the configuration and connect to the server.

  6. Start the OAuth authentication process when prompted.

  7. On the Sitecore authorization page, click Allow Access.

  8. Select your organization and tenant.

  9. To verify that Marketer MCP is available and that its tools can be used, open a chat, prompt, or agent test panel in your MCP client,and enter a prompt like *List all available sites. If the connection is successful, the client returns a list of sites for the selected 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!