Skip to content

docs: name the MCP packages tool by its bare name#3207

Merged
bpamiri merged 1 commit into
developfrom
fix/mcp-tool-names-bare
Jun 14, 2026
Merged

docs: name the MCP packages tool by its bare name#3207
bpamiri merged 1 commit into
developfrom
fix/mcp-tool-names-bare

Conversation

@bpamiri

@bpamiri bpamiri commented Jun 14, 2026

Copy link
Copy Markdown
Collaborator

What

The stdio MCP surface (wheels mcp wheels) advertises every tool by its bare function namegenerate, migrate, packages, … — not a wheels_-prefixed form. The packages guide was the last v4-0-0 doc still calling it wheels_packages; this swaps it for "the packages tool".

Why

Live-verified against the released 4.0.3 CLI:

$ wheels mcp wheels --once tools/list
→ 18 tools: analyze, create, db, deploy, destroy, doctor, generate, info,
  migrate, notes, packages, reload, routes, seed, stats, test, upgrade, validate

tools/call resolves by exact match (LuCLI McpCommand.java), so a prefixed name (wheels_packages) would return Unknown tool. The guide table, the mcp() help text (Module.cfc), and CLAUDE.md were 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

  • One-line prose change in web/sites/guides/.../v4-0-0/digging-deeper/packages.mdx. No code paths touched.

🤖 Generated with Claude Code

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>
@github-actions github-actions Bot added the bug label Jun 14, 2026

@wheels-bot wheels-bot Bot left a comment

Copy link
Copy Markdown
Contributor

Choose a reason for hiding this comment

The reason will be displayed to describe this comment to others. Learn more.

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.

@bpamiri bpamiri merged commit 9ed06ea into develop Jun 14, 2026
14 checks passed
@bpamiri bpamiri deleted the fix/mcp-tool-names-bare branch June 14, 2026 14:16
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

Projects

None yet

Development

Successfully merging this pull request may close these issues.

1 participant