--- title: "Sitecore Marketer MCP server" slug: "sitecore-marketer-mcp-server" abstract: "The Sitecore Marketer MCP Server helps marketers and AI agents work in Sitecore using natural language. It transforms complex APIs into simple, goal-based actions that fit seamlessly into everyday marketing workflows." --- # 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](https://api-docs.sitecore.com/ai-capabilities/agent-api), providing secure access across the entire digital experience lifecycle. As part of Sitecore's [interoperability](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecore-marketer-mcp-server/integrating-sitecore-with-agentic-platforms.html "Integrating Sitecore with agentic platforms") 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. > [!note] > **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. ### 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 and click **Continue**: - **Name**: *Marketer MCP*. - **Remote MCP server URL**: ```text 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](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#example-prompts "Example prompts") and the [Marketer MCP tool reference](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#tool-reference "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. In the sidebar, click **Customize**. 3. Click **MCPs**. 5. Click :mdiPlus: **New MCP Server**. 6. Add the following configuration to your `mcp.json` file: ```json { "mcpServers": { "marketer": { "url": "https://marketer.sitecorecloud.io/mcp/marketer-mcp-prod", "auth": { "type": "external" } } } } ``` 7. Save the `mcp.json` file. The Marketer MCP now appears in your list of available tools. 8. Click **Connect**. 9. If Cursor asks you to confirm opening an external website, click **Open**. Cursor opens the Sitecore authorization page in your browser. 10. In the **Marketer MCP server authorization request** dialog, click **Allow Access**. 11. Select the organization and tenant you want to use with the MCP server. 12. When prompted, click **Open Cursor** to return to Cursor IDE and complete the setup. 13. 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](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#example-prompts "Example prompts") and the [Marketer MCP tool reference](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#tool-reference "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. > [!note] > **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](https://code.visualstudio.com/docs/setup/copilot). > 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: ```json { "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 the`mcp.json`file, 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](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#example-prompts "Example prompts") and the [Marketer MCP tool reference](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#tool-reference "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](https://www.youtube.com/watch?v=gcYz-l6R6FQ) video. > [!note] > **Before you begin** > Make sure you have [created an agent](https://learn.microsoft.com/en-us/microsoft-copilot-studio/fundamentals-get-started) 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 :mdiPlus: **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**: ```text 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**: ```text https://marketer.sitecorecloud.io/mcp/authorize/marketer-mcp-prod ``` - **Token URL template**: ```text 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](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#example-prompts "Example prompts") and the [Marketer MCP tool reference](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#tool-reference "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. > [!note] > **Before you begin** > Make sure you have an [AI request created in Postman](https://learning.postman.com/docs/use/send-requests/protocols/ai-requests/create#create-a-new-ai-request) 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: ```text https://marketer.sitecorecloud.io/mcp/marketer-mcp-prod ``` 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](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#example-prompts "Example prompts") and the [Marketer MCP tool reference](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#tool-reference "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 servers**. 4. Click **Add server**. 5. Enter the following details: - **Name**: *Marketer MCP*. - **Transport Type**: *Streamable HTTP*. - **Remote MCP server URL**: ```text 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](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#example-prompts "Example prompts") and the [Marketer MCP tool reference](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html#tool-reference "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**: ```text https://marketer.sitecorecloud.io/mcp/marketer-mcp-prod ``` 4. If your client uses a JSON configuration file, use the following configuration pattern: ```json { "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](https://auth0.com/docs/get-started/authentication-and-authorization-flow/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](https://www.sitecore.com/legal/privacy-policy). ## Support For additional help using the Sitecore Marketer MCP server, you can access the following resources: - [Marketer MCP tool reference and other information](https://doc.sitecore.com/sai/en/users/sitecoreai/sitecore-marketer-mcp-server/marketer-mcp-tool-reference-and-other-information.html "Marketer MCP tool reference and other information") - tools, prompts, troubleshooting, and FAQs. - [Marketplace documentation](https://doc.sitecore.com/mp/en/developers/sdk/0/sitecore-marketplace-sdk/adding-the-sitecore-marketer-mcp-to-marketplace-apps.html) - how to add the Marketer MCP server to Marketplace apps. - [Marketer MCP article](https://www.sitecore.com/resources/insights/artificial-intelligence/marketer-mcp-agent-api) - overview of how the Marketer MCP server and Agent API work together. For issues, questions, or troubleshooting, [create a support case](https://doc.sitecore.com/portal/en/developers/sitecore-cloud-portal/en/create-a-support-case.html) through the Sitecore Cloud Portal.