# Managed MCP Servers View, create, update, and delete Managed MCP Server configurations for your Project. Managed MCP Servers expose a set of tools to AI agents through the [Model Context Protocol (MCP)](https://modelcontextprotocol.io/). Each MCP Server configuration defines which tools are available and how AI agents connect to your commercetools Project. Managed MCP Servers provide the hosted variant of Commerce MCP. For a conceptual overview and the available tools, see the [Commerce MCP documentation](/api/dev-tooling/mcp/commerce-mcp.md). To run and extend the server yourself, see [Self-hosted Commerce MCP](/api/dev-tooling/mcp/self-hosted-commerce-mcp.md). To access Managed MCP Server configuration endpoints, use an API Client with the `view_mcp_servers:{projectKey}` or `manage_mcp_servers:{projectKey}` [scopes](/api/scopes.md). To learn how to use the Managed MCP Server itself, see [Use the MCP Server with a client](/api/managed-mcp-servers-get-started.md#use-the-mcp-server-with-a-client). Each Managed MCP Server has a unique `key` within the Project. The server URL is generated automatically from your region, domain, Project key, and MCP Server key in the following format: `https://mcp.{region}.{domain}/projects/{projectKey}/{mcpServerKey}`. For example, consider a Project in the `europe-west1.gcp` region with the key `my-project`. If you create an MCP Server with the key `my-mcp-server`, the server URL is `https://mcp.europe-west1.gcp.commercetools.com/projects/my-project/my-mcp-server`. A maximum of **1000000** tool invocations can be made per Project per month. [Learn more about this limit](/api/limits.md#hosted-mcp-tool-invocations). ## Representations #### McpServer [type definition](/search.md?urn=ctp:api:type:McpServer). #### McpServerConfig [type definition](/search.md?urn=ctp:api:type:McpServerConfig). #### CommerceMcpServerConfig [type definition](/search.md?urn=ctp:api:type:CommerceMcpServerConfig). #### McpServerTool [type definition](/search.md?urn=ctp:api:type:McpServerTool). #### McpServerType [type definition](/search.md?urn=ctp:api:type:McpServerType). #### McpServerTypeTool [type definition](/search.md?urn=ctp:api:type:McpServerTypeTool). #### McpServerDraft [type definition](/search.md?urn=ctp:api:type:McpServerDraft). #### McpServerConfigDraft [type definition](/search.md?urn=ctp:api:type:McpServerConfigDraft). #### CommerceMcpServerConfigDraft [type definition](/search.md?urn=ctp:api:type:CommerceMcpServerConfigDraft). #### McpServerPagedQueryResponse [type definition](/search.md?urn=ctp:api:type:McpServerPagedQueryResponse). #### McpServerState [type definition](/search.md?urn=ctp:api:type:McpServerState). #### McpServerToolOutputFormatting [type definition](/search.md?urn=ctp:api:type:McpServerToolOutputFormatting). #### ToolCustomization [type definition](/search.md?urn=ctp:api:type:ToolCustomization). #### ParameterOverride [type definition](/search.md?urn=ctp:api:type:ParameterOverride). #### McpServerJsonOutputFiltering [type definition](/search.md?urn=ctp:api:type:McpServerJsonOutputFiltering). #### McpServerJsonOutputFilteringMatcher [type definition](/search.md?urn=ctp:api:type:McpServerJsonOutputFilteringMatcher). #### McpServerUpdate [type definition](/search.md?urn=ctp:api:type:McpServerUpdate). ## Get MCP Server ### Get MCP Server by ID [endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/mcp-servers/{id}:GET). ### Get MCP Server by key [endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/mcp-servers/key={key}:GET). ## Query MCP Servers [endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/mcp-servers:GET). ## Query MCP Server types [endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/mcp-servers/types:GET). ## Get MCP Server type [endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/mcp-servers/types/{mcpServerType}:GET). ## Create MCP Server [endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/mcp-servers:POST). ## Update MCP Server ### Update MCP Server by ID [endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/mcp-servers/{id}:POST). ### Update MCP Server by key [endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/mcp-servers/key={key}:POST). ## Update actions #### Add Tool [type definition](/search.md?urn=ctp:api:type:McpServerAddToolAction). #### Remove Tool [type definition](/search.md?urn=ctp:api:type:McpServerRemoveToolAction). #### Set Tools [type definition](/search.md?urn=ctp:api:type:McpServerSetToolsAction). #### Set Tool Customizations [type definition](/search.md?urn=ctp:api:type:McpServerSetToolCustomizationsAction). #### Add Tool Customization [type definition](/search.md?urn=ctp:api:type:McpServerAddToolCustomizationAction). #### Remove Tool Customization [type definition](/search.md?urn=ctp:api:type:McpServerRemoveToolCustomizationAction). #### Remove Tool Customization Target [type definition](/search.md?urn=ctp:api:type:RemoveToolCustomizationTarget). #### Set Name [type definition](/search.md?urn=ctp:api:type:McpServerSetNameAction). #### Set Description [type definition](/search.md?urn=ctp:api:type:McpServerSetDescriptionAction). #### Set State [type definition](/search.md?urn=ctp:api:type:McpServerSetStateAction). #### Set JSON Output Filtering [type definition](/search.md?urn=ctp:api:type:McpServerSetJsonOutputFilteringAction). #### Set Tool Output Formatting [type definition](/search.md?urn=ctp:api:type:McpServerSetToolOutputFormattingAction). ## Delete MCP Server ### Delete MCP Server by ID [endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/mcp-servers/{id}:DELETE). ### Delete MCP Server by key [endpoint definition](/search.md?urn=ctp:api:endpoint:/{projectKey}/mcp-servers/key={key}:DELETE). ## Related pages - [Area overview page with navigation](/api.md) - [Previous page: Get started](/api/managed-mcp-servers-get-started.md) - [Search documentation and API specs](/search.md)