Skip to main content

Delete a custom MCP

Deletes a custom MCP service in the current workspace. The deletion cannot be undone.

Endpoint

DELETE /api/v1/mcp/servers/{mcpCode} Supports custom MCP only. The deletion cannot be undone, and a deleted service cannot be deleted again.

Request parameters

ParameterTypeRequiredDescription
mcpCodestringYesCustom MCP code

Response

Returns a DetailResponse with only mcp_code, server_status, and server_status_text populated. All other fields are null.
curl -X DELETE "https://{workspace_id}.cn-beijing.maas.aliyuncs.com/api/v1/mcp/servers/mcp-a1b2c3d4e5f6g7h8" \
  -H "Authorization: Bearer $DASHSCOPE_API_KEY"
{
  "success": true,
  "error_code": null,
  "error_msg": null,
  "data": {
    "mcp_code": "mcp-a1b2c3d4e5f6g7h8",
    "server_name": null,
    "description": null,
    "type": null,
    "server_type": null,
    "server_status": "DELETED",
    "server_status_text": "已删除",
    "dashscope_endpoint": null,
    "meta_info": null,
    "mcp_config": null
  },
  "request_id": "6f1c2a8e-3b0d-4c55-9a0e-2f7d1c9b8a11"
}

Errors

HTTP statuserror_codeDescription
400InvalidParameterA query parameter or request body is provided
400OperationNotSupportedThe service is an official MCP
400DeleteFailedThe deletion failed
404McpServerNotFoundThe MCP service does not exist
404McpServerUnavailableThe MCP service is deleted