From c81f8c06b32212a5031baee95422fcaf4d6f805f Mon Sep 17 00:00:00 2001 From: Connie Date: Fri, 13 Feb 2026 10:01:34 -0600 Subject: [PATCH 1/5] Change tool names to use dash instead of underscore --- .../src/AzureBestPracticesSetup.cs | 2 +- .../src/Commands/AIAppBestPracticesCommand.cs | 2 +- 2 files changed, 2 insertions(+), 2 deletions(-) diff --git a/tools/Azure.Mcp.Tools.AzureBestPractices/src/AzureBestPracticesSetup.cs b/tools/Azure.Mcp.Tools.AzureBestPractices/src/AzureBestPracticesSetup.cs index 7a71b0fd6d..cd5ed008f0 100644 --- a/tools/Azure.Mcp.Tools.AzureBestPractices/src/AzureBestPracticesSetup.cs +++ b/tools/Azure.Mcp.Tools.AzureBestPractices/src/AzureBestPracticesSetup.cs @@ -10,7 +10,7 @@ namespace Azure.Mcp.Tools.AzureBestPractices; public class AzureBestPracticesSetup : IAreaSetup { - public string Name => "get_azure_bestpractices"; + public string Name => "get-azure-bestpractices"; public string Title => "Azure Best Practices"; public CommandCategory Category => CommandCategory.RecommendedTools; diff --git a/tools/Azure.Mcp.Tools.AzureBestPractices/src/Commands/AIAppBestPracticesCommand.cs b/tools/Azure.Mcp.Tools.AzureBestPractices/src/Commands/AIAppBestPracticesCommand.cs index 5f1ccc79f6..3f97213edc 100644 --- a/tools/Azure.Mcp.Tools.AzureBestPractices/src/Commands/AIAppBestPracticesCommand.cs +++ b/tools/Azure.Mcp.Tools.AzureBestPractices/src/Commands/AIAppBestPracticesCommand.cs @@ -39,7 +39,7 @@ private static string LoadEmbeddedText(string fileName) public override string Id => "6c29659e-406d-4b9b-8150-e3d4fd7ba31c"; - public override string Name => "ai_app"; + public override string Name => "ai-app"; public override string Description => @"Returns best practices and code generation guidance for building AI applications in Azure. From d9e90fa4ae68d0589b857cec1b4135d692340b73 Mon Sep 17 00:00:00 2001 From: Connie Date: Fri, 13 Feb 2026 10:07:46 -0600 Subject: [PATCH 2/5] Add CHANGELOG entry. --- servers/Azure.Mcp.Server/changelog-entries/1770998844653.yaml | 4 ++++ 1 file changed, 4 insertions(+) create mode 100644 servers/Azure.Mcp.Server/changelog-entries/1770998844653.yaml diff --git a/servers/Azure.Mcp.Server/changelog-entries/1770998844653.yaml b/servers/Azure.Mcp.Server/changelog-entries/1770998844653.yaml new file mode 100644 index 0000000000..c57654ff4c --- /dev/null +++ b/servers/Azure.Mcp.Server/changelog-entries/1770998844653.yaml @@ -0,0 +1,4 @@ +pr: 1727 +changes: + - section: "Breaking Changes" + description: "Change AzureBestPractice tool area from ai_app to ai-app and azure_bestpractices to azure-bestpractices. Consequently, `get_azure_bestpractices_ai_app` becomes `get-azure-bestpractices_ai-app` and `get_azure_bestpractices_get` becomes `get-azure-bestpractices_get`" \ No newline at end of file From 2d03dc5070b799a4c14c324dda44f3ad79642c2a Mon Sep 17 00:00:00 2001 From: Connie Date: Sat, 14 Feb 2026 10:10:23 -0600 Subject: [PATCH 3/5] Update references from get_azure_bestpractices_ai_app to get-azure-bestpractices_ai-app --- .../src/Areas/Server/Resources/azure-rules.txt | 2 +- .../src/Areas/Server/Resources/consolidated-tools.json | 4 ++-- .../ToolDescriptionEvaluator/prompts/prompts.json | 2 +- servers/Azure.Mcp.Server/docs/e2eTestPrompts.md | 10 +++++----- 4 files changed, 9 insertions(+), 9 deletions(-) diff --git a/core/Microsoft.Mcp.Core/src/Areas/Server/Resources/azure-rules.txt b/core/Microsoft.Mcp.Core/src/Areas/Server/Resources/azure-rules.txt index a70ac1a8c8..e117cb0154 100644 --- a/core/Microsoft.Mcp.Core/src/Areas/Server/Resources/azure-rules.txt +++ b/core/Microsoft.Mcp.Core/src/Areas/Server/Resources/azure-rules.txt @@ -6,7 +6,7 @@ or performing operations related to Azure, invoke your `bestpractices` tool if a invoke your `bestpractices` tool if available. - Only call your `bestpractices` tool when you are sure the user is discussing Azure; do not call it otherwise. - Use Azure AI App Code Generation Best Practices: When generating code for AI applications, AI agents, workflows, -or chatbots, invoke your `get_azure_bestpractices_ai_app` command (under `get_azure_bestpractices` tool) if tool available. +or chatbots, invoke your `get-azure-bestpractices_ai-app` command (under `get_azure_bestpractices` tool) if tool available. Call this tool first before creating any plans, todos or code. Only call this command when the user is discussing AI app development with Microsoft Foundry, Azure, Microsoft agent framework SDK, or without specifying any technology. Do NOT call it when the user specifies other technology diff --git a/core/Microsoft.Mcp.Core/src/Areas/Server/Resources/consolidated-tools.json b/core/Microsoft.Mcp.Core/src/Areas/Server/Resources/consolidated-tools.json index d1fe5152c3..dc02afc1d5 100644 --- a/core/Microsoft.Mcp.Core/src/Areas/Server/Resources/consolidated-tools.json +++ b/core/Microsoft.Mcp.Core/src/Areas/Server/Resources/consolidated-tools.json @@ -1070,8 +1070,8 @@ "mappedToolList": [ "azureterraformbestpractices_get", "bicepschema_get", - "get_azure_bestpractices_ai_app", - "get_azure_bestpractices_get", + "get-azure-bestpractices_ai-app", + "get-azure-bestpractices_get", "foundry_agents_get-sdk-sample" ] }, diff --git a/eng/tools/ToolDescriptionEvaluator/prompts/prompts.json b/eng/tools/ToolDescriptionEvaluator/prompts/prompts.json index 90993dc384..36540b9e41 100644 --- a/eng/tools/ToolDescriptionEvaluator/prompts/prompts.json +++ b/eng/tools/ToolDescriptionEvaluator/prompts/prompts.json @@ -543,7 +543,7 @@ "Search for Microsoft products in the marketplace", "Show me marketplace products from publisher " ], - "get_azure_bestpractices_ai_app": [ + "get-azure-bestpractices_ai-app": [ "Get best practices for building AI applications in Azure", "Show me the best practices for Microsoft Foundry agents code generation", "Get guidance for building agents with Microsoft Foundry", diff --git a/servers/Azure.Mcp.Server/docs/e2eTestPrompts.md b/servers/Azure.Mcp.Server/docs/e2eTestPrompts.md index 54257827c8..2a22f08e46 100644 --- a/servers/Azure.Mcp.Server/docs/e2eTestPrompts.md +++ b/servers/Azure.Mcp.Server/docs/e2eTestPrompts.md @@ -527,11 +527,11 @@ This file contains prompts used for end-to-end testing to ensure each tool is in | get_azure_bestpractices_get | Get the latest Azure Static Web Apps best practices | | get_azure_bestpractices_get | What are azure function best practices? | | get_azure_bestpractices_get | configure azure mcp in coding agent for my repo | -| get_azure_bestpractices_ai_app | Get best practices for building AI applications in Azure | -| get_azure_bestpractices_ai_app | Show me the best practices for Microsoft Foundry agents code generation | -| get_azure_bestpractices_ai_app | Get guidance for building agents with Microsoft Foundry | -| get_azure_bestpractices_ai_app | Create an AI app that helps me to manage travel queries. | -| get_azure_bestpractices_ai_app | Create an AI app that helps me to manage travel queries in Microsoft Foundry | +| get-azure-bestpractices_ai-app | Get best practices for building AI applications in Azure | +| get-azure-bestpractices_ai-app | Show me the best practices for Microsoft Foundry agents code generation | +| get-azure-bestpractices_ai-app | Get guidance for building agents with Microsoft Foundry | +| get-azure-bestpractices_ai-app | Create an AI app that helps me to manage travel queries. | +| get-azure-bestpractices_ai-app | Create an AI app that helps me to manage travel queries in Microsoft Foundry | ## Azure Migrate From b2984d8462726aa5abd35b1eed542c3e9a821c06 Mon Sep 17 00:00:00 2001 From: Connie Date: Sat, 14 Feb 2026 10:14:17 -0600 Subject: [PATCH 4/5] Update references to get-azure-bestpractices_get --- .../Azure.Mcp.Server/docs/e2eTestPrompts.md | 18 +++++++++--------- 1 file changed, 9 insertions(+), 9 deletions(-) diff --git a/servers/Azure.Mcp.Server/docs/e2eTestPrompts.md b/servers/Azure.Mcp.Server/docs/e2eTestPrompts.md index 2a22f08e46..374d264e06 100644 --- a/servers/Azure.Mcp.Server/docs/e2eTestPrompts.md +++ b/servers/Azure.Mcp.Server/docs/e2eTestPrompts.md @@ -518,15 +518,15 @@ This file contains prompts used for end-to-end testing to ensure each tool is in | Tool Name | Test Prompt | |:----------|:----------| -| get_azure_bestpractices_get | Get the latest Azure code generation best practices | -| get_azure_bestpractices_get | Get the latest Azure deployment best practices | -| get_azure_bestpractices_get | Get the latest Azure best practices | -| get_azure_bestpractices_get | Get the latest Azure Functions code generation best practices | -| get_azure_bestpractices_get | Get the latest Azure Functions deployment best practices | -| get_azure_bestpractices_get | Get the latest Azure Functions best practices | -| get_azure_bestpractices_get | Get the latest Azure Static Web Apps best practices | -| get_azure_bestpractices_get | What are azure function best practices? | -| get_azure_bestpractices_get | configure azure mcp in coding agent for my repo | +| get-azure-bestpractices_get | Get the latest Azure code generation best practices | +| get-azure-bestpractices_get | Get the latest Azure deployment best practices | +| get-azure-bestpractices_get | Get the latest Azure best practices | +| get-azure-bestpractices_get | Get the latest Azure Functions code generation best practices | +| get-azure-bestpractices_get | Get the latest Azure Functions deployment best practices | +| get-azure-bestpractices_get | Get the latest Azure Functions best practices | +| get-azure-bestpractices_get | Get the latest Azure Static Web Apps best practices | +| get-azure-bestpractices_get | What are azure function best practices? | +| get-azure-bestpractices_get | configure azure mcp in coding agent for my repo | | get-azure-bestpractices_ai-app | Get best practices for building AI applications in Azure | | get-azure-bestpractices_ai-app | Show me the best practices for Microsoft Foundry agents code generation | | get-azure-bestpractices_ai-app | Get guidance for building agents with Microsoft Foundry | From 25262eecdcbd4ecee20aa3e00f40c54221ca7687 Mon Sep 17 00:00:00 2001 From: Connie Date: Sat, 14 Feb 2026 10:15:20 -0600 Subject: [PATCH 5/5] update prompts. --- eng/tools/ToolDescriptionEvaluator/prompts/prompts.json | 2 +- 1 file changed, 1 insertion(+), 1 deletion(-) diff --git a/eng/tools/ToolDescriptionEvaluator/prompts/prompts.json b/eng/tools/ToolDescriptionEvaluator/prompts/prompts.json index 36540b9e41..862ea3cbce 100644 --- a/eng/tools/ToolDescriptionEvaluator/prompts/prompts.json +++ b/eng/tools/ToolDescriptionEvaluator/prompts/prompts.json @@ -550,7 +550,7 @@ "Create an AI app that helps me to manage travel queries.", "Create an AI app that helps me to manage travel queries in Microsoft Foundry" ], - "get_azure_bestpractices_get": [ + "get-azure-bestpractices_get": [ "Get the latest Azure code generation best practices", "Get the latest Azure deployment best practices", "Get the latest Azure best practices",