docs: name the MCP packages tool by its bare name#3207
Conversation
The stdio MCP surface advertises tools by their bare function name (`packages`), not a `wheels_`-prefixed form — live-verified via `wheels mcp wheels --once tools/list`. The packages guide was the last v4-0-0 doc still calling it `wheels_packages`; the guide table, the mcp() help text, and CLAUDE.md were already corrected on develop. Co-Authored-By: Claude Opus 4.8 (1M context) <noreply@anthropic.com> Signed-off-by: Peter Amiri <petera@pai.com>
There was a problem hiding this comment.
Wheels Bot — Reviewer
TL;DR — This PR fixes the last wheels_packages leftover in the v4-0-0 packages guide, swapping the prefixed tool name for "the packages tool" to match how the stdio MCP surface (wheels mcp wheels) actually advertises tools — by bare function name. The change is accurate, verified, and self-contained. Verdict: approve.
Correctness
The change is correct. CLAUDE.md (CLI / MCP section) states the tool names in tools/list are the bare function names — NOT wheels_*-prefixed — and lists packages among the 18 live-verified tools. Replacing (wheels_packages) with the packages tool wording at web/sites/guides/src/content/docs/v4-0-0/digging-deeper/packages.mdx:320 aligns the doc with that contract. I confirmed the PR's "last remaining v4 doc leftover" claim with a repo-wide grep: zero wheels_packages matches remain anywhere under web/sites/guides/src/content/docs/v4-0-0/ after this edit.
Tests
No tests required — this is a prose-only doc change touching no code path (1 insertion, 1 deletion).
Docs
This is the doc fix. No changelog fragment is needed: the changelog.d/ requirement applies to user-facing fix/feat PRs, and this is a docs change.
Commits
docs: name the MCP packages tool by its bare name — valid conventional-commit header: allowed type docs, no scope, subject is sentence-case (not ALL-CAPS), header well under 100 chars. The PR title matches, so the squash-merge subject lints clean.
Nicely scoped, evidence-backed, single-line correction. Approving.
What
The stdio MCP surface (
wheels mcp wheels) advertises every tool by its bare function name —generate,migrate,packages, … — not awheels_-prefixed form. The packages guide was the lastv4-0-0doc still calling itwheels_packages; this swaps it for "thepackagestool".Why
Live-verified against the released 4.0.3 CLI:
tools/callresolves by exact match (LuCLIMcpCommand.java), so a prefixed name (wheels_packages) would returnUnknown tool. The guide table, themcp()help text (Module.cfc), andCLAUDE.mdwere already corrected on develop in a prior sweep — this closes the one remaining v4 doc leftover.Found while fact-checking two scheduled blog posts (the same prefix error appeared in the MCP post and was corrected in the publishing admin).
Scope
web/sites/guides/.../v4-0-0/digging-deeper/packages.mdx. No code paths touched.🤖 Generated with Claude Code