[WAF tool] Enhance get command to act as list

[sriramkakara]

What does this PR do?

Enhance wellarchitectedframework_serviceguide_get command to:

1. Act as a list command as well similar to existing patterns. This reduces the number of tools.
2. Add a service layer to read from the resources files.

Screenshots of the behavior

First made a GET call without any --service param to discover the available service names.

Then made parallel GET calls with specific --service param values.

GitHub issue number?

Issue 1927

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 and obtained a score of 0.4 or more and a top 3 ranking for all related test prompts
  • For tools with new names, including new tools or renamed tools, update consolidated-tools.json
  • For renamed tools, follow the Tool Rename Checklist and tag the PR with the breaking-change label
  • 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

[sriramkakara]

/azp run mcp - pullrequest - live

[azure-pipelines]

Azure Pipelines successfully started running 1 pipeline(s).

[Copilot]

Pull request overview

Adds a new wellarchitectedframework_serviceguide_list MCP command to return Azure Well-Architected Framework service-guide links for multiple services, sharing lookup logic via a new IServiceGuideService.

Changes:

• Introduces ServiceGuideListCommand (+ options) and wires it into the WellArchitectedFramework area setup.
• Extracts service guide URL resolution / supported-services listing into IServiceGuideService + ServiceGuideService, and updates ServiceGuideGetCommand to use it.
• Adds unit tests and updates server docs/metadata (consolidated-tools.json, azmcp-commands.md, e2e prompts, README) for the new tool.

Reviewed changes

Copilot reviewed 14 out of 15 changed files in this pull request and generated 6 comments.

Show a summary per file

File	Description
tools/Azure.Mcp.Tools.WellArchitectedFramework/src/Commands/ServiceGuide/ServiceGuideListCommand.cs	New list subcommand implementation producing guidance/not-available sections.
tools/Azure.Mcp.Tools.WellArchitectedFramework/src/Options/ServiceGuide/ServiceGuideListOptions.cs	Options model for list command (--services).
tools/Azure.Mcp.Tools.WellArchitectedFramework/src/Options/WellArchitectedFrameworkOptionDefinitions.cs	Adds --services option + refines help text.
tools/Azure.Mcp.Tools.WellArchitectedFramework/src/Services/ServiceGuide/IServiceGuideService.cs	New abstraction for service guide URL lookup and supported service listing.
tools/Azure.Mcp.Tools.WellArchitectedFramework/src/Services/ServiceGuide/ServiceGuideService.cs	New embedded-resource-backed implementation with static caching + normalization.
tools/Azure.Mcp.Tools.WellArchitectedFramework/src/Commands/ServiceGuide/ServiceGuideGetCommand.cs	Refactors get command to use IServiceGuideService and updated messaging.
tools/Azure.Mcp.Tools.WellArchitectedFramework/src/WellArchitectedFrameworkSetup.cs	Registers the new service + list command with DI and command group.
tools/Azure.Mcp.Tools.WellArchitectedFramework/tests/.../Commands/ServiceGuide/ServiceGuideListCommandTests.cs	Unit tests for list command behavior and input parsing.
tools/Azure.Mcp.Tools.WellArchitectedFramework/tests/.../Services/ServiceGuide/ServiceGuideServiceTests.cs	Unit tests for lookup normalization, mapping, and basic concurrency safety.
tools/Azure.Mcp.Tools.WellArchitectedFramework/tests/.../Resources/ServiceGuides/ServiceGuidesJsonSchemaTests.cs	Validates embedded service-guides.json schema and invariants (URLs/variations).
tools/Azure.Mcp.Tools.WellArchitectedFramework/tests/.../Commands/ServiceGuide/ServiceGuideGetCommandTests.cs	Updates get tests for injected service + revised response wording.
servers/Azure.Mcp.Server/src/Resources/consolidated-tools.json	Adds the new tool name to consolidated tool list.
servers/Azure.Mcp.Server/docs/e2eTestPrompts.md	Adds e2e prompts for wellarchitectedframework_serviceguide_list.
servers/Azure.Mcp.Server/docs/azmcp-commands.md	Documents the new CLI surface for serviceguide list.
servers/Azure.Mcp.Server/README.md	Updates example prompts for Well-Architected Framework usage.

[Copilot]

@sriramkakara I've opened a new pull request, #2021, to work on those changes. Once the pull request is ready, I'll request review from you.

[Copilot]

Pull request overview

Copilot reviewed 11 out of 12 changed files in this pull request and generated 3 comments.

[alzimmermsft]

Please add a CHANGELOG entry by using /eng/scripts/New-ChangelogEntry.ps1 from the root of the repo.