Add Azure Policy Tool

[msalaman]

What does this PR do?

Add Azure Policy Tool (https://learn.microsoft.com/en-us/azure/governance/policy/overview) with command that lists Azure policy assignments and corresponding definitions for a given subscription/scope.
Update Azure Best Practice tool instructions to invoke Azure policy tool and use policies to help guide code generation/deployment

GitHub issue number?

#504

Pre-merge Checklist

• Required for All PRs
  • Read contribution guidelines
  • PR title clearly describes the change
  • Commit history is clean with descriptive messages (cleanup guide)
  • Added comprehensive tests for new/modified functionality
  • Updated servers/Azure.Mcp.Server/CHANGELOG.md and/or servers/Fabric.Mcp.Server/CHANGELOG.md for product changes (features, bug fixes, UI/UX, updated dependencies)
• For MCP tool changes:
  • One tool per PR: This PR adds or modifies only one MCP tool for faster review cycles
  • Updated servers/Azure.Mcp.Server/README.md and/or servers/Fabric.Mcp.Server/README.md documentation
  • Validate README.md changes using script at eng/scripts/Process-PackageReadMe.ps1. See Package README
  • Updated command list in /servers/Azure.Mcp.Server/docs/azmcp-commands.md and/or /docs/fabric-commands.md
  • Run .\eng\scripts\Update-AzCommandsMetadata.ps1 to update tool metadata in azmcp-commands.md (required for CI)
  • For new or modified tool descriptions, ran [ToolDescriptionEvaluator]
  • For tools with new names, including new tools or renamed tools, update consolidated-tools.json
  • For new tools associated with Azure services or publicly available tools/APIs/products, add URL to documentation in the PR description
• Extra steps for Azure MCP Server tool changes:
  • Updated test prompts in /servers/Azure.Mcp.Server/docs/e2eTestPrompts.md
  • 👉 For Community (non-Microsoft team member) PRs:
    • Security review: Reviewed code for security vulnerabilities, malicious code, or suspicious activities before running tests (crypto mining, spam, data exfiltration, etc.)
    • Manual tests run: added comment /azp run mcp - pullrequest - live to run Live Test Pipeline

[msalaman]

[Copilot]

Pull request overview

This PR adds a new Azure Policy tool to the Azure MCP Server that enables listing policy assignments for Azure subscriptions and scopes. The tool integrates with the Azure Best Practices guidance to help ensure generated code complies with organizational policies.

Changes:

• Added new Azure Policy tool with policy assignment list command
• Updated Azure Best Practice tool instructions to incorporate policy checking in code generation and deployment workflows
• Added tool to consolidated tools registry and server configuration

Reviewed changes

Copilot reviewed 30 out of 32 changed files in this pull request and generated 12 comments.

Show a summary per file

File	Description
tools/Azure.Mcp.Tools.Policy/src/Azure.Mcp.Tools.Policy.csproj	Project file for new Policy tool
tools/Azure.Mcp.Tools.Policy/src/Services/PolicyService.cs	Service implementation for listing policy assignments
tools/Azure.Mcp.Tools.Policy/src/Services/IPolicyService.cs	Service interface definition
tools/Azure.Mcp.Tools.Policy/src/Commands/Assignment/PolicyAssignmentListCommand.cs	Command implementation for listing policy assignments
tools/Azure.Mcp.Tools.Policy/src/Commands/PolicyJsonContext.cs	JSON serialization context for AOT compatibility
tools/Azure.Mcp.Tools.Policy/src/Models/PolicyAssignment.cs	Model for policy assignment data
tools/Azure.Mcp.Tools.Policy/src/Models/PolicyDefinition.cs	Model for policy definition data
tools/Azure.Mcp.Tools.Policy/src/Options/Assignment/PolicyAssignmentListOptions.cs	Options for list command
tools/Azure.Mcp.Tools.Policy/src/Options/PolicyOptionDefinitions.cs	Shared option definitions
tools/Azure.Mcp.Tools.Policy/src/Options/BasePolicyOptions.cs	Base options class
tools/Azure.Mcp.Tools.Policy/src/Options/Assignment/AssignmentGetOptions.cs	Options for future get command
tools/Azure.Mcp.Tools.Policy/src/PolicySetup.cs	Service registration and command setup
tools/Azure.Mcp.Tools.Policy/tests/Azure.Mcp.Tools.Policy.UnitTests/Assignment/PolicyAssignmentListCommandTests.cs	Unit tests for list command
tools/Azure.Mcp.Tools.AzureBestPractices/src/Resources/azure-general-deployment-best-practices.txt	Updated to include policy checking step
tools/Azure.Mcp.Tools.AzureBestPractices/src/Resources/azure-general-codegen-best-practices.txt	Updated to include policy checking step
tools/Azure.Mcp.Tools.AzureBestPractices/src/Resources/azure-functions-deployment-best-practices.txt	Updated to include policy checking step
tools/Azure.Mcp.Tools.AzureBestPractices/src/Resources/azure-functions-codegen-best-practices.txt	Updated to include policy checking step
servers/Azure.Mcp.Server/src/Program.cs	Registered Policy tool in server
servers/Azure.Mcp.Server/docs/e2eTestPrompts.md	Added test prompts for Policy tool
servers/Azure.Mcp.Server/docs/azmcp-commands.md	Added command documentation
servers/Azure.Mcp.Tools.Policy/src/GlobalUsings.cs	Global using statements
servers/Azure.Mcp.Tools.Policy/tests/Azure.Mcp.Tools.Policy.UnitTests/GlobalUsings.cs	Global using statements for tests
core/Azure.Mcp.Core/src/Areas/Server/Resources/consolidated-tools.json	Added Policy tool to consolidated tools registry
.github/CODEOWNERS	Added code ownership for Policy tool