Skip to content

Change tool names to use dash instead of underscore #1727

New issue

Have a question about this project? Sign up for a free GitHub account to open an issue and contact its maintainers and the community.

Sign up for GitHub

By clicking “Sign up for GitHub”, you agree to our terms of service and privacy statement. We’ll occasionally send you account related emails.

Already on GitHub? Sign in to your account

Open
conniey wants to merge 5 commits into
base: main
Choose a base branch
from
Open

Change tool names to use dash instead of underscore #1727

Show file tree
Hide file tree
Changes from all commits
Commits
Show all changes
5 commits
Select commit Hold shift + click to select a range
c81f8c0
Change tool names to use dash instead of underscore
conniey Feb 13, 2026
d9e90fa
Add CHANGELOG entry.
conniey Feb 13, 2026
2d03dc5
Update references from get_azure_bestpractices_ai_app to get-azure-be…
conniey Feb 14, 2026
b2984d8
Update references to get-azure-bestpractices_get
conniey Feb 14, 2026
25262ee
update prompts.
conniey Feb 14, 2026
File filter

Filter by extension

Filter by extension
Conversations
Failed to load comments.
Loading
Jump to
Jump to file
Failed to load files.
Loading
Diff view
Diff view
2 changes: 1 addition & 1 deletion core/Microsoft.Mcp.Core/src/Areas/Server/Resources/azure-rules.txt
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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
Expand Down
4 changes: 2 additions & 2 deletions core/Microsoft.Mcp.Core/src/Areas/Server/Resources/consolidated-tools.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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"
]
},
Expand Down
4 changes: 2 additions & 2 deletions eng/tools/ToolDescriptionEvaluator/prompts/prompts.json
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -543,14 +543,14 @@
"Search for Microsoft products in the marketplace",
"Show me marketplace products from publisher <publisher_name>"
],
"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",
"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",
Expand Down
4 changes: 4 additions & 0 deletions servers/Azure.Mcp.Server/changelog-entries/1770998844653.yaml
View file
Open in desktop
Original file line number Diff line number Diff line change
@@ -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`"
28 changes: 14 additions & 14 deletions servers/Azure.Mcp.Server/docs/e2eTestPrompts.md
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -518,20 +518,20 @@ 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_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_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 |
| 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

Expand Down
2 changes: 1 addition & 1 deletion tools/Azure.Mcp.Tools.AzureBestPractices/src/AzureBestPracticesSetup.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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";
Copy link

Copilot AI Feb 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The area name change from "get_azure_bestpractices" to "get-azure-bestpractices" is a breaking change that must be documented in CHANGELOG.md. The full tool names are changing from "get_azure_bestpractices_" to "get-azure-bestpractices_" (note: the separator between area and command is underscore, but the area name itself now uses dashes).

This affects two tools:

  • "get_azure_bestpractices_ai_app" → "get-azure-bestpractices_ai-app"
  • "get_azure_bestpractices_get" → "get-azure-bestpractices_get"

The PR checklist specifically requires updating CHANGELOG.md for product changes. This breaking change should be added to the "## 2.0.0-beta.20 (Unreleased)" section under "### Breaking Changes".

Suggested change
public string Name => "get-azure-bestpractices";
public string Name => "get_azure_bestpractices";

Copilot uses AI. Check for mistakes.
Copy link

Copilot AI Feb 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The area name change from "get_azure_bestpractices" to "get-azure-bestpractices" also affects the other command in this area. The "get" command's full tool name changes from "get_azure_bestpractices_get" to "get-azure-bestpractices_get".

The following files reference "get_azure_bestpractices_get" and need to be updated:

  1. consolidated-tools.json (line 1074): "get_azure_bestpractices_get" → "get-azure-bestpractices_get"
  2. prompts.json (line 553): Key "get_azure_bestpractices_get" → "get-azure-bestpractices_get"
  3. e2eTestPrompts.md (lines 521-529): All references to "get_azure_bestpractices_get" → "get-azure-bestpractices_get"

These updates are necessary consequences of changing the area name, even though the command name itself ("get") is not changing.

Copilot uses AI. Check for mistakes.
public string Title => "Azure Best Practices";
public CommandCategory Category => CommandCategory.RecommendedTools;

Expand Down
2 changes: 1 addition & 1 deletion tools/Azure.Mcp.Tools.AzureBestPractices/src/Commands/AIAppBestPracticesCommand.cs
View file
Open in desktop
Original file line number Diff line number Diff line change
Expand Up @@ -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";
Copy link

Copilot AI Feb 13, 2026

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

The tool name change from "ai_app" to "ai-app" requires updates to several other files that were not included in this PR. The full tool name uses the pattern: {area_name}{command_name}, where underscore is the separator (CommandFactory.Separator = ''). Since the area name is "get-azure-bestpractices" and the command name is now "ai-app", the full tool name should be "get-azure-bestpractices_ai-app".

The following files still reference the old tool name and need to be updated:

  1. consolidated-tools.json (line 1073): "get_azure_bestpractices_ai_app" → "get-azure-bestpractices_ai-app"
  2. prompts.json (line 546): Key "get_azure_bestpractices_ai_app" → "get-azure-bestpractices_ai-app"
  3. azmcp-commands.md (lines 1516, 1519): "ai_app" → "ai-app"
  4. e2eTestPrompts.md (lines 530-534): "get_azure_bestpractices_ai_app" → "get-azure-bestpractices_ai-app"
  5. AIAppBestPracticesCommandTests.cs (line 60): The assertion expects "ai_app" but should expect "ai-app"

All references must be updated to maintain consistency and ensure the tool can be properly invoked.

Copilot uses AI. Check for mistakes.

public override string Description =>
@"Returns best practices and code generation guidance for building AI applications in Azure.
Expand Down
Loading