- 3 minutes to read

MCP Tools for Documentation

The Documentation group of the MCP Endpoint helps an AI assistant write documentation the way your team has agreed to write it. It reads the Document Profiles that define an Article's sections, collects everything known about a Resource or a C4 node, recommends the Snippets and Templates that fit, and builds profile-based Articles part by part. The group is selected by default in the AI Assistant.

  • ✅ 14 tools: 8 read, 6 write
  • ✅ Facts, relations, and existing Articles for a Resource or C4 node in one call
  • ✅ Change impact before you edit a shared Snippet, Template, or Document Profile

The MCP Tool Reference explains the OAuth scopes, the paging rules, and the other groups. To see the group at work, follow Migrate Azure DevOps Wiki Pages to Profile-Based Articles with AI.

Understanding the Scopes in This Group

The read tools need mcp:repository.read. The write tools need both mcp:repository.read and mcp:repository.write, unlike the Article, Snippet, and Template writes in Repository Tools, which need only mcp:repository.write. Deleting a Document Profile is delete_document_profile, also in Repository Tools.

Tools (14)

Tool Kind What it does
get_article_composition Read The structure of a profile-based Article: its profile, main body, sections, and dangling parts
get_change_impact Read Every document that depends on a Snippet, Template, Document Profile, or Article
get_document_profile Read One Document Profile by slug, with its ordered parts
get_documentation_context Read Everything needed to document a Resource or a C4 node: facts, relations, and existing Articles
get_documentation_health Read The current Documentation Health findings over all live documents
list_document_profiles Read Live Document Profiles (id, title, slug), optionally filtered by a search text on title or slug; no paging
recommend_snippets Read Ranks the Snippets that fit a Resource, C4 diagram or node, Article, or free text
recommend_templates Read Ranks the Templates that fit a Resource, C4 diagram or node, Article, or free text
create_article_from_profile Write Creates an Article composed from a Document Profile
create_document_profile Write Creates a Document Profile
set_article_document_profile Write Assigns, changes, or removes (profileSlug null) an Article's Document Profile
set_document_profile_parts Write Replaces the whole ordered part list of a Document Profile
update_article_content_parts Write Writes the main body and content parts of a profile-based Article, and resolves dangling parts
update_document_profile Write Renames or retags a Document Profile by slug (newSlug renames it)

recommend_snippets and recommend_templates take an optional take from 1 to 25. Outside that range they answer take must be between 1 and 25. instead of adjusting the value.

Prompts

The server also offers two MCP prompts, which are not tools: ready-made instructions that a client can start, and that bring the tools they need with them.

Prompt Use it to
document-resource Document a monitored Resource
document-c4-node Document a node of a C4 diagram

In the AI Assistant, a prompt adds the tools it declares to your selection before the limit of 128 tools is checked.

Next Steps