{"record":{"id":"de168585c2a069ce","repo":"BerriAI/litellm","slug":"only-proxy-admins-can-delete-mcp-toolsets","errorCode":null,"errorMessage":"Only proxy admins can delete MCP toolsets.","messagePattern":"Only proxy admins can delete MCP toolsets\\.","errorType":"http","errorClass":"HTTPException","httpStatus":403,"severity":"error","filePath":"litellm/proxy/management_endpoints/mcp_management_endpoints.py","lineNumber":2966,"sourceCode":"        )\n\n        global_mcp_server_manager.invalidate_toolset_cache(getattr(payload, \"toolset_id\", None))\n        return result\n\n    @router.delete(\n        \"/toolset/{toolset_id}\",\n        description=\"Delete an MCP toolset (admin only)\",\n        status_code=status.HTTP_202_ACCEPTED,\n    )\n    @management_endpoint_wrapper\n    async def remove_mcp_toolset(\n        toolset_id: str,\n        user_api_key_dict: UserAPIKeyAuth = Depends(user_api_key_auth),\n        litellm_changed_by: str | None = Header(None),\n    ):\n        prisma_client: Final = get_prisma_client_or_throw(\"Database not connected. Connect a database to your proxy\")\n        if LitellmUserRoles.PROXY_ADMIN != user_api_key_dict.user_role:\n            raise HTTPException(\n                status_code=status.HTTP_403_FORBIDDEN,\n                detail={\"error\": \"Only proxy admins can delete MCP toolsets.\"},\n            )\n        deleted: Final = await delete_mcp_toolset(prisma_client, toolset_id)\n        if deleted is None:\n            raise HTTPException(\n                status_code=status.HTTP_404_NOT_FOUND,\n                detail={\"error\": f\"Toolset '{toolset_id}' not found.\"},\n            )\n        from litellm.proxy._experimental.mcp_server.mcp_server_manager import (\n            global_mcp_server_manager,\n        )\n\n        global_mcp_server_manager.invalidate_toolset_cache(toolset_id)\n        return Response(status_code=status.HTTP_202_ACCEPTED)\n","sourceCodeStart":2948,"sourceCodeEnd":2982,"githubUrl":"https://github.com/BerriAI/litellm/blob/77b7c6c40c0c5aa5fbcb1d6a1825ac39ca8829b8/litellm/proxy/management_endpoints/mcp_management_endpoints.py#L2948-L2982","documentation":"Admin gate on MCP toolset deletion: only PROXY_ADMIN may remove toolsets; other roles get HTTP 403.","triggerScenarios":"Thrown at litellm/proxy/management_endpoints/mcp_management_endpoints.py:2966 when the library encounters an invalid state.","commonSituations":"See trigger scenarios.","solutions":["Use a PROXY_ADMIN API key to delete MCP toolsets."],"exampleFix":null,"handlingStrategy":"validation","validationCode":null,"typeGuard":null,"tryCatchPattern":null,"preventionTips":[],"tags":[],"backgroundTag":null,"analyzedSha":"77b7c6c40c0c5aa5fbcb1d6a1825ac39ca8829b8","analyzedAt":"2026-08-18T11:44:31.656Z","contentChangedAt":null,"schemaVersion":2},"datasetVersion":"2026-09-14T05:17:10.506Z"}