What it does
docsdiff takes the list of changed files in a change set and reports, for each area, one of four statuses: code changed without docs, docs changed without code, both changed, or no relevant changes. Each file is classified as docs, code or other using only its path: folder segments, basename prefixes and file extensions decide the result, and no file contents are read.
It is useful when reviewing a change set and checking whether a module was altered without its guide, or whether a documentation page was edited with no matching code change. The check_docs_drift tool accepts changed files with optional area names, which group files into modules or packages; files without an area are reported under "(global)". The result lists the drifted areas in sorted order, along with overall counts of files, code, docs and other.
It runs as an MCP server that an MCP client starts through its configuration, and it also offers a CLI that reads an args.json file and prints a JSON report. The computation is local and needs no network access or extra configuration. The CLI returns exit code 0 on success, 1 on a runtime error and 2 on a usage error.
Limitations and requirements
Classification relies only on file paths; file contents are not read and no repository is opened. The check_docs_drift tool requires at least one change, and each path must be non-empty and unique across the set. Malformed input, such as a missing or empty changes list, an empty or duplicated path, or an empty area name, produces a validation error that names the offending entry, and no partial report is returned.
Safety
Our team has not reviewed this resource. Only automated rules checked it; resources with high-risk signals are not published. These are signals, not a guarantee that installing it is safe. Try it in a sandbox project first.
- Runs code or changes an assistant's behaviour
Sources
- Official MCP Registry first seen 13 Nov 2026 · last seen 13 Nov 2026 · its page on the source
io.github.CloudCorpRecords/docsdiff
Flag documentation drift per area: code changed without docs, docs changed without code.
v0.1.0As shown on registry.modelcontextprotocol.io when we last read it