Skip to content

docs: sync the README and CLAUDE.md tool lists with the shipped tools - #108

Merged
CalvinAllen merged 2 commits into
mainfrom
docs/readme/tool-list
Sep 3, 2026
Merged

docs: sync the README and CLAUDE.md tool lists with the shipped tools#108
CalvinAllen merged 2 commits into
mainfrom
docs/readme/tool-list

Conversation

@CalvinAllen

@CalvinAllen CalvinAllen commented Sep 3, 2026

Copy link
Copy Markdown
Contributor

Brings both tool lists back in sync with what the server actually exposes. The server has 74 tools; the README documented 72 and CLAUDE.md documented 38.

I checked by extracting every [McpServerTool(Name = "...")] from Server/Tools/*.cs and diffing against each document, rather than reading by eye. Both now match the code exactly, with nothing missing or extra in either direction.

README — 72 → 74

file_create and folder_create shipped in #98 but were never added to the tables:

$ comm -23 code-tools.txt readme-tools.txt
file_create
folder_create

Both live in DocumentTools.cs, so they went into the Document Tools table, which stays alphabetically ordered — as do all eleven tables.

Everything from the recent run of work was already documented: Test Tools landed with #105, Terminal Tools with #106, and Coverage Tools with #107, each including its caveat callout.

CLAUDE.md — 38 → 74

Considerably further behind. It was missing four entire groups — Navigation, Debugger, Diagnostics and Window — plus build_configuration_get/set, document_save, document_cleanup, and the same two file/folder tools.

The list is now generated from the README tables, so the two documents describe the same tools with the same descriptions and the same grouping. Sections follow the README's eleven groups rather than the previous four, which had folded the editor and selection tools into Document Tools.

The terminal and coverage caveats are carried over as plain prose, since CLAUDE.md does not use callout styling.

Verification

code=74  readme=74  claude=74
code vs README  missing: []  extra: []
code vs CLAUDE  missing: []  extra: []

Docs only — no source changes, so the build workflow does not run on this PR by design (it triggers on src/**).

file_create and folder_create shipped in #98 but were never added to the tool
tables, leaving the README listing 72 of the 74 tools the server exposes.

Both live in DocumentTools, so they go in the Document Tools table, which stays
alphabetically ordered.
The MCP Tools Available section listed 38 of the 74 tools the server exposes. It
was missing the Navigation, Debugger, Diagnostics and Window groups outright,
along with build_configuration_get/set, document_save, document_cleanup,
file_create and folder_create.

The list is now generated from the README tables, so both documents describe the
same tools with the same descriptions and are grouped identically. Sections
follow the README's eleven groups rather than the previous four, which had
folded the editor and selection tools into Document Tools.

The terminal and coverage caveats are kept as plain prose, since CLAUDE.md does
not use callout styling.
@CalvinAllen CalvinAllen changed the title docs(readme): document the file and folder creation tools docs: sync the README and CLAUDE.md tool lists with the shipped tools Sep 3, 2026
@CalvinAllen
CalvinAllen merged commit 466d64a into main Sep 3, 2026
2 checks passed
@CalvinAllen
CalvinAllen deleted the docs/readme/tool-list branch September 3, 2026 21:02
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Development

Successfully merging this pull request may close these issues.

1 participant