Enhance best practices tools descriptions (#1029)

Author: fanyang-mono

CHANGELOG.md

@@ -37,6 +37,7 @@ The Azure MCP Server updates automatically by default whenever a new release com
   - Fixed KQL string escaping in Workbooks service queries.
 - Standardized Azure Storage command descriptions, option names, and parameter names for consistency across all storage commands. Updated JSON serialization context to remove unused model types and improve organization. [[#1015](https://github.com/Azure/azure-mcp/pull/1015)]
 - Update to .NET 10 SDK to prepare for .NET tool packing.
+- Enhance `bestpractices` and `azureterraformbestpractices` tool descriptions to better work with the vscode copilot tool grouping feature. [[#1029](https://github.com/Azure/azure-mcp/pull/1029)]
 
 ## 0.5.7 (2025-08-19)
 

areas/azurebestpractices/src/AzureMcp.AzureBestPractices/AzureBestPracticesSetup.cs

@@ -20,7 +20,13 @@ public void RegisterCommands(CommandGroup rootGroup, ILoggerFactory loggerFactor
         // Register Azure Best Practices command at the root level
         var bestPractices = new CommandGroup(
             "bestpractices",
-            "Returns secure, production-grade Azure best practices. Call this before generating Azure SDK code."
+            @"Azure best practices - Commands return a list of best practices for code generation, operations and deployment 
+            when working with Azure services. It should be called for any code generation, deployment or 
+            operations involving Azure, Azure Functions, Azure Kubernetes Service (AKS), Azure Container 
+            Apps (ACA), Bicep, Terraform, Azure Cache, Redis, CosmosDB, Entra, Azure Active Directory, 
+            Azure App Services, or any other Azure technology or programming language. Only call this function 
+            when you are confident the user is discussing Azure. If this tool needs to be categorized, 
+            it belongs to the Azure Best Practices category."
         );
         rootGroup.AddSubGroup(bestPractices);
 

areas/azurebestpractices/src/AzureMcp.AzureBestPractices/Commands/BestPracticesCommand.cs

@@ -22,9 +22,13 @@ public sealed class BestPracticesCommand(ILogger<BestPracticesCommand> logger) :
     public override string Name => "get";
 
     public override string Description =>
-        "Returns best practices for secure, production-grade Azure usage. " +
-        "Call this command and follow its guidance before generating or suggesting any Azure code. " +
-        "This command returns the content of the best practices file as a string array.";
+        @"This tool returns a list of best practices for code generation, operations and deployment 
+        when working with Azure services. It should be called for any code generation, deployment or 
+        operations involving Azure, Azure Functions, Azure Kubernetes Service (AKS), Azure Container 
+        Apps (ACA), Bicep, Terraform, Azure Cache, Redis, CosmosDB, Entra, Azure Active Directory, 
+        Azure App Services, or any other Azure technology or programming language. Only call this function 
+        when you are confident the user is discussing Azure. If this tool needs to be categorized, 
+        it belongs to the Azure Best Practices category.";
 
     public override string Title => CommandTitle;
 

areas/azureterraformbestpractices/src/AzureMcp.AzureTerraformBestPractices/AzureTerraformBestPracticesSetup.cs

@@ -20,7 +20,8 @@ public void RegisterCommands(CommandGroup rootGroup, ILoggerFactory loggerFactor
         // Register Azure Terraform Best Practices command at the root level
         var azureTerraformBestPractices = new CommandGroup(
             "azureterraformbestpractices",
-            "Returns Terraform best practices for Azure. Call this before generating Terraform code for Azure Providers."
+            @"Returns Terraform best practices for Azure. Call this before generating Terraform code for Azure Providers. 
+            If this tool needs to be categorized, it belongs to the Azure Best Practices category."
         );
         rootGroup.AddSubGroup(azureTerraformBestPractices);
         azureTerraformBestPractices.AddCommand(

areas/azureterraformbestpractices/src/AzureMcp.AzureTerraformBestPractices/Commands/AzureTerraformBestPracticesGetCommand.cs

@@ -26,9 +26,9 @@ private static string LoadBestPracticesText()
     public override string Name => "get";
 
     public override string Description =>
-        "Returns Terraform best practices for Azure. " +
-        "Call this command and follow its guidance before generating or suggesting any Terraform code specific to Azure. " +
-        "This command returns the content of the markdown file as a string array.";
+        @"Returns Terraform best practices for Azure. Call this command and follow its guidance before 
+        generating or suggesting any Terraform code specific to Azure. If this tool needs to be categorized, it belongs to 
+        the Azure Best Practices category.";
 
     public override string Title => CommandTitle;