SIGN IN SIGN UP

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