# Reported issues for mcp-sitecore-server

Pod holds 18 of 26 problems reported by people outside the maintainer team. Issues filed by the project's own owners, members and collaborators are excluded entirely — a maintainer's release checklist is not a warning to a prospective user.

Back to [mcp-sitecore-server](/mcp/mcp-sitecore-server).

## Most discussed

### it doesn't work with xmc

## Environment

XMC Cloud starter kit - https://github.com/Sitecore/xmcloud-starter-js/

## Authentication

Any Sitecore XM Cloud starter kit comes with the Auth0 FedAuth provider.
Here is an example of docker CM configuration:

```YAML
    environment:
      SITECORE_FedAuth_dot_Auth0_dot_IsLocal: ${SITECORE_FedAuth_dot_Auth0_dot_IsLocal}
      SITECORE_XmCloud_dot_OrganizationId: ${SITECORE_XmCloud_dot_OrganizationId}
      SITECORE_XmCloud_dot_TenantId: ${SITECORE_XmCloud_dot_TenantId}
      

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/63) · 2025-10-30 · open · external user · 3 comments

### `const uuid = crypto.randomUUID();` doesn't work on some machines

**Expected behavior:**
PowerShell MCP tools should work

**Actual behavior:**
Powershell MCP tools fails with the error

![Image](https://github.com/user-attachments/assets/f567fd8c-f624-4276-b870-9c7f3364cb63)

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/3) · 2025-05-24 · closed · 3 comments

### MCP Server Fails to Connect with stdio Transport, Works with SSE

### **Environment**

- Node.js version: v23.7.0
- npm version: 10.9.2
- OS: Windows 10
- Sitecore version: 10.4 (hostname: sc104)
- MCP Server: @antonytm/mcp-sitecore-server (latest)

### **Issue Description**
When configuring the MCP server in Cursor to use the stdio transport (as recommended in the docs), the server fails to connect. The process either disconnects immediately or does not establish a stable connection. This was tested with various flags and approaches, including:

- Using npx a

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/2) · 2025-05-23 · closed · external user · 3 comments

### MCP server 'Sitecore' is not available. Returning error tool.

mcp.json
{
    "servers": {
        "Sitecore": {
            "type": "stdio",
            "command": "npx",
            "args": [ "@antonytm/mcp-sitecore-server@1.0.7" ],
            "env": {
                "TRANSPORT": "stdio",
                "GRAPHQL_ENDPOINT": "http://sc10.2.xxx.dev.local/sitecore/api/graph/",
                "GRAPHQL_SCHEMAS": "edge,master,core",
                "GRAPHQL_API_KEY": "{7486BF14-048C-4AE7-8BF6-2EAD4DA87766}",
                "GRAPHQL_HEADERS": "",
           

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/60) · 2025-08-04 · closed · external user · 2 comments

### sitecore failed to retrieve authentication cookie

my setup had an issue where the authentication cookie did not pass correctly, the following update to client.ts solved it.

Accepts both .AspNet.Cookies and .ASPXAUTH cookies:

<!-- Failed to upload "client.ts" -->
upload of file failed. here is complete in raw txt.
class RestfulItemServiceClient {
    private serverUrl: string;
    private username: string;
    private password: string;
    private domain: string;
    private authCookieName: string | null = null;
    private authCookieValue: st

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/61) · 2025-08-26 · open · external user · 1 comment

### `presentation-switch-rendering-by-path` tool

https://doc.sitecorepowershell.com/appendix/presentation/switch-rendering

Parameters:
1. oldRenderingPath: required
2. newRenderingPath: required
3. itemPath: required
4. uniqueId: optional
5. database: optional
6. finalLayout: optional
7. language: optional

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/35) · 2025-06-16 · closed · 1 comment

### `presentation-set-rendering-by-path` tool

It should be a composite tool. Similar to add rendering. Get the item to set rendering.  Get rendering by uniqueId. Set rendering.
https://doc.sitecorepowershell.com/appendix/presentation/set-rendering

Parameters:

1. uniqueId: required
2. itemPath: required
3. placeholder: required
4. datasource: optional
5. finalLayout: optional
6. parameter: optional
7. database: optional
8. language: optional

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/32) · 2025-06-16 · closed · 1 comment

### `presentation-add-rendering-by-path` tool

It should be a composite tool. Get the rendering item. Get the item to add rendering. Add rendering.

Parameters:
1. renderingPath: required
2. itemPath: required
3. placeholder: required
4. datasource: optional
5. finalLayout: optional
6. parameter: optional 
7. database: optional
8. language: optional

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/30) · 2025-06-16 · closed · 1 comment

## Most recent

### Improve error messaging for `presentation-set-rendering-by-id`

1. `presentation-set-rendering-by-id` calls `$rendering = Get-Rendering ${commandBuilder.buildParametersString(getRenderingParameters)};`
2. Then `$rendering` is used
3. If `$rendering` is null, for example, when a wrong uniqueId was specified, it throws an error `Cannot bind argument to parameter 'Instance' because it is null.`

The error is not helpful and doesn't tell AI agents what actually could be wrong. It can be improved.

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/62) · 2025-10-28 · closed · 0 comments

### `presentation-switch-rendering-by-id` tool

https://doc.sitecorepowershell.com/appendix/presentation/switch-rendering

Parameters:
1. oldRenderingId: required
2. newRenderingId: required
3. itemId: required
4. uniqueId: optional
5. database: optional
6. finalLayout: optional
7. language: optional

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/34) · 2025-06-16 · closed · 0 comments

### `presentation-set-rendering-by-id` tool

It should be a composite tool. Similar to add rendering. Get the item to set rendering.  Get rendering by uniqueId. Set rendering.
https://doc.sitecorepowershell.com/appendix/presentation/set-rendering

Parameters:

1. uniqueId: required
2. itemId: required
3. placeholder: required
4. datasource: optional
5. finalLayout: optional
6. parameter: optional
7. database: optional
8. language: optional

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/33) · 2025-06-16 · closed · 0 comments

### `presentation-add-rendering-by-id` tool

It should be a composite tool. Get the rendering item. Get the item to add rendering. Add rendering.
https://doc.sitecorepowershell.com/appendix/presentation/add-rendering

Parameters:
1. renderingId: required
2. itemId: required
3. placeholder: required
4. datasource: optional
5. finalLayout: optional
6. parameter: optional 
7. database: optional
8. language: optional

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/31) · 2025-06-16 · closed · 0 comments

### `presentation-remove-rendering-by-id` tool

https://doc.sitecorepowershell.com/appendix/presentation/remove-rendering
Parameters:
1. itemId: required, ID of item to process
2. database: optional
3. datasource: optional
4. placeholder: optional
5. language: optional
6. finalLayout: optional
7. uniqueId: optional

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/29) · 2025-06-16 · closed · 0 comments

### `presentation-remove-rendering-by-path` tool

https://doc.sitecorepowershell.com/appendix/presentation/remove-rendering
Parameters:
1. path: required
2. database: optional
3. datasource: optional
4. placeholder: optional
5. language: optional
6. finalLayout: optional
7. uniqueId: optional

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/28) · 2025-06-16 · closed · 1 comment

### `presentation-get-rendering-by-path` tool

https://doc.sitecorepowershell.com/appendix/presentation/get-rendering
Parameters:
1. path: required
2. database: optional
3. datasource: optional
4. placeholder: optional
5. language: optional
6. finalLayout: optional
7. uniqueId: optional

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/27) · 2025-06-16 · closed · 1 comment

### `presentation-get-rendering-by-id` tool

https://doc.sitecorepowershell.com/appendix/presentation/get-rendering
Parameters:
1. itemId: required, ID of item to process
2. database: optional
3. datasource: optional
4. placeholder: optional
5. language: optional
6. finalLayout: optional
7. uniqueId: optional

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/26) · 2025-06-16 · closed · 0 comments

### `presentation-get-default-layout-device` tool

https://doc.sitecorepowershell.com/appendix/presentation/get-layoutdevice

No parameters

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/21) · 2025-06-09 · closed · 0 comments

### `presentation-get-layout-device` tool

https://doc.sitecorepowershell.com/appendix/presentation/get-layoutdevice

Parameters:
1. Name

[Read the thread](https://github.com/Antonytm/mcp-sitecore-server/issues/20) · 2025-06-09 · closed · 0 comments

The remaining reports are on [the project's issue tracker](https://github.com/Antonytm/mcp-sitecore-server/issues).