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.
  • 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.
  • An Admin role in the SitecoreAI app.
  • Access to the SitecoreAI organization and tenant you want to use with the Marketer 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.

Claude Desktop

You can connect the Marketer MCP server to Claude Desktop as a custom connector.

To set up the connection:

  1. Open Claude Desktop.

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

  3. In Customize, go to Connectors.

  4. Click Add > Add custom connector.

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

    • Name: Marketer MCP.

    • Remote MCP server URL:

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

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

  7. Click Connect. Claude opens the Sitecore 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 with the MCP server.

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

  11. To verify the connection, 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.

Cursor IDE

You can connect the Marketer MCP server to Cursor IDE by adding it as a custom MCP server.

To set up the connection:

  1. Open Cursor IDE.

  2. Click View > Settings.

  3. Go to MCP icon Tools & MCPs.

  4. Click Add icon New MCP Server.

  5. Add the following configuration to your mcp.json file:

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

  6. Save the mcp.json file. The Marketer MCP now appears in your list of available tools.

  7. Click Connect.

  8. If Cursor asks you to confirm opening an external website, click Open. Cursor opens the Sitecore authorization page in your browser.

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

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

  11. When prompted, click Open Cursor to return to Cursor IDE and complete the setup.

  12. To verify the connection, 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.

Visual Studio Code

In Visual Studio Code, you can connect to the Marketer MCP server and use GitHub Copilot Chat to test requests directly.

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 set up the connection:

  1. Open Visual Studio Code.

  2. Open the Command Palette using one of the following keyboard shortcuts:

    • On Windows, press Ctrl+Shift+P.
    • On macOS, press Shift+Command+P.

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

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

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

  5. Start the Marketer MCP server. You can start the server in any of the following ways:

    • In themcp.jsonfile, click Start above the Marketer MCP server configuration.
    • Open the Command Palette, run MCP: List Servers, select marketer, and then select Start Server.
    • Open the Extensions view, expand MCP Servers - Installed, select marketer, and then click Start Server.

  6. Visual Studio Code will prompt you to confirm opening an external website. Click Allow.

  7. Click Open. Visual Studio Code opens the Sitecore 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 with the MCP server.

  10. When prompted, click Open Visual Studio Code to complete the setup.

  11. To verify the connection, open Chat, switch to 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.

Copilot Studio

You can connect the Marketer MCP server to an agent in Microsoft Copilot Studio and use 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 set up the connection:

  1. Open Copilot Studio and open an existing agent.

  2. Go to the agent's Tools tab

  3. Click image4.png Add a tool.

  4. In the Create New section, select MCP icon 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. Copilot Studio opens the Sitecore authorization page in your browser.

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

  14. Select the organization and tenant you want to use with the MCP server.

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

  16. To verify the connection, 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.

Postman

You can 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 set up the connection:

  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/token

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

  5. Click Authorize. Postman opens the Sitecore authorization page in your browser.

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

  7. Select the organization and tenant you want to use with the MCP server.

  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 the connection, 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.

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 set up the connection:

  1. Open the Codex app.

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

  3. Go to Integrations and select MCP icon 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. The Codex app opens the Sitecore 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 with the MCP server.

  10. To verify the connection, 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.

Other clients

You can connect the Marketer MCP server from other MCP-compatible clients that support MCP servers over Streamable HTTP.

To set up the connection:

  1. Open your MCP-compatible client.

  2. Add a new MCP server.

  3. Configure the server 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, use the following configuration pattern:

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

  5. Save the configuration.

  6. Connect to the Marketer MCP Server.

  7. When the client opens the Sitecore authorization page in your browser, click Allow Access.

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

  9. To verify the connection, 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!