Tool consolidation for wiki tools (#1423)
This pull request refactors and consolidates the Azure DevOps wiki toolset to align with the remote MCP server's structure. It replaces multiple specialized wiki tools with a single dispatcher tool using an `action` parameter, updates documentation for clarity, and improves error handling and parameter validation. **Wiki tool consolidation and refactoring:** - Consolidated all read-only wiki operations into a single `wiki` tool that uses an `action` parameter to select between listing wikis, getting wiki details, listing pages, getting page metadata, and retrieving page content. The previous individual tools (e.g., `mcp_ado_wiki_list_wikis`, `mcp_ado_wiki_get_wiki`, etc.) are removed. (`src/tools/wiki.ts`, `docs/TOOLSET.md`) [[1]](diffhunk://#diff-b17fb169ab8df3740ad297819df82b07c47565474ef0a50c23d3f63c42ed2da0L12-L96) [[2]](diffhunk://#diff-b17fb169ab8df3740ad297819df82b07c47565474ef0a50c23d3f63c42ed2da0L112-L142) [[3]](diffhunk://#diff-b17fb169ab8df3740ad297819df82b07c47565474ef0a50c23d3f63c42ed2da0L155-R132) [[4]](diffhunk://#diff-b17fb169ab8df3740ad297819df82b07c47565474ef0a50c23d3f63c42ed2da0L174-R151) [[5]](diffhunk://#diff-b17fb169ab8df3740ad297819df82b07c47565474ef0a50c23d3f63c42ed2da0L211) [[6]](diffhunk://#diff-b17fb169ab8df3740ad297819df82b07c47565474ef0a50c23d3f63c42ed2da0R248-R271) [[7]](diffhunk://#diff-63809bcf7da46bf515d3deeb8551a8a5cd63b3fff00ee8dd3517e46bb2bd6025L90-R99) [[8]](diffhunk://#diff-63809bcf7da46bf515d3deeb8551a8a5cd63b3fff00ee8dd3517e46bb2bd6025L539-R552) **Documentation updates:** - Updated the `docs/TOOLSET.md` to reflect the new tool grouping, parameter structure, and to note alignment with the Azure DevOps remote MCP server. The documentation now describes the new `action`-based dispatcher and clarifies which parameters are required for each operation. [[1]](diffhunk://#diff-63809bcf7da46bf515d3deeb8551a8a5cd63b3fff00ee8dd3517e46bb2bd6025L90-R99) [[2]](diffhunk://#diff-63809bcf7da46bf515d3deeb8551a8a5cd63b3fff00ee8dd3517e46bb2bd6025L539-R552) **Error handling improvements:** - Centralized and clarified error messages for each wiki action, ensuring consistent and informative feedback for failed operations. **Parameter validation and flexibility:** - Improved validation for required parameters based on the chosen action, and added support for optional parameters such as `url` for page content retrieval. [[1]](diffhunk://#diff-b17fb169ab8df3740ad297819df82b07c47565474ef0a50c23d3f63c42ed2da0L12-L96) [[2]](diffhunk://#diff-b17fb169ab8df3740ad297819df82b07c47565474ef0a50c23d3f63c42ed2da0L112-L142) [[3]](diffhunk://#diff-b17fb169ab8df3740ad297819df82b07c47565474ef0a50c23d3f63c42ed2da0L174-R151) **Write operation tool renaming:** - Renamed the create/update wiki page tool to `wiki_upsert_page` for consistency with the new naming scheme. [[1]](diffhunk://#diff-b17fb169ab8df3740ad297819df82b07c47565474ef0a50c23d3f63c42ed2da0L12-L96) [[2]](diffhunk://#diff-b17fb169ab8df3740ad297819df82b07c47565474ef0a50c23d3f63c42ed2da0R248-R271) These changes simplify the codebase, make the API more intuitive, and ensure the toolset is consistent with Azure DevOps standards. ## GitHub issue number N/A ## **Associated Risks** Changing the signature of tools in wiki ## โ **PR Checklist** - [x] **I have read the [contribution guidelines](https://github.com/microsoft/azure-devops-mcp/blob/main/CONTRIBUTING.md)** - [x] **I have read the [code of conduct guidelines](https://github.com/microsoft/azure-devops-mcp/blob/main/CODE_OF_CONDUCT.md)** - [x] Title of the pull request is clear and informative. - [x] ๐ Code hygiene - [x] ๐ญ Telemetry added, updated, or N/A - [x] ๐ Documentation added, updated, or N/A - [x] ๐ก๏ธ Automated tests added, or N/A ## ๐งช **How did you test it?** manually testing all of the wiki tools and made sure automated tests are updated
D
Dan Hellem committed
7675bb70e3ab2cd84e2991f453a8fdc9d0c8ce89
Parent: 0a08dc6
Committed by GitHub <noreply@github.com>
on 7/15/2026, 2:31:25 PM