fix: remove hound_ prefix from MCP tool names (complete) by yizhi-shi · Pull Request #75 · tiluckdave/hound-mcp

yizhi-shi · 2026-06-01T15:09:33Z

This PR completes the tool rename started in #11 by also updating all help text, prompts, README, and docs to match the unprefixed tool names.

What changed?

Help text in audit.ts, preinstall.ts, upgrade.ts (6 references)
Prompts: package_evaluation.ts, security_audit.ts, pre_release_check.ts
README.md: tools table, use cases, roadmap
docs/tools.md: all 12 tool sections (headings, syntax, examples)
docs/prompts.md: all 3 prompt sections

Why this matters:
PR #11 (by zamadye) only changed the tool name definitions but left all help text, prompts, and docs referencing the old hound_* names. The owner requested these changes but they were never completed. This PR finishes the job.

123/123 tests pass. Closes #9.

MCP clients already prefix tools with the server name, causing redundant double-prefixing (e.g. hound_hound_audit). Strip the hound_ prefix from all 12 tool name definitions. Closes tiluckdave#9

The tool name prefixes (hound_audit -> audit, etc.) were already changed in the MCP registration. This commit fixes all remaining references in help text, prompts, README, and docs to match. Changes: - src/tools/audit.ts, preinstall.ts, upgrade.ts: help text strings - src/prompts/*.ts: 3 prompt files with tool name references - README.md: tools table, use cases, and roadmap references - docs/tools.md: all 12 tool sections (headings, syntax, examples) - docs/prompts.md: all 3 prompt sections 123/123 tests pass. Closes tiluckdave#9.

Copilot

Pull request overview

This PR completes the removal of the hound_ prefix from MCP tool names by renaming tool registrations and updating user-facing references (prompts + docs) to use the new unprefixed names.

Changes:

Renames registered MCP tool names from hound_* to unprefixed names (e.g., audit, vulns, license_check).
Updates in-tool guidance/help strings and built-in prompt instructions to reference the new tool names.
Updates README and docs pages (docs/tools.md, docs/prompts.md) to match the new naming.

Reviewed changes

Copilot reviewed 20 out of 20 changed files in this pull request and generated 4 comments.

Show a summary per file

File	Description
src/tools/vulns.ts	Renames the registered tool from `hound_vulns` to `vulns`.
src/tools/upgrade.ts	Renames the tool to `upgrade` and updates guidance text to reference `advisories`/`compare`.
src/tools/typosquat.ts	Renames the registered tool from `hound_typosquat` to `typosquat`.
src/tools/tree.ts	Renames the registered tool from `hound_tree` to `tree`.
src/tools/score.ts	Renames the registered tool from `hound_score` to `score`.
src/tools/preinstall.ts	Renames the tool to `preinstall` and updates “Run …” hints to new names.
src/tools/popular.ts	Renames the registered tool from `hound_popular` to `popular`.
src/tools/license-check.ts	Renames the registered tool from `hound_license_check` to `license_check`.
src/tools/inspect.ts	Renames the registered tool from `hound_inspect` to `inspect`.
src/tools/compare.ts	Renames the registered tool from `hound_compare` to `compare`.
src/tools/audit.ts	Renames the tool to `audit` and updates “Run …” hints to new names.
src/tools/advisories.ts	Renames the registered tool from `hound_advisories` to `advisories`.
src/prompts/security_audit.ts	Updates prompt instructions to call unprefixed tool names.
src/prompts/pre_release_check.ts	Updates prompt instructions to call unprefixed tool names.
src/prompts/package_evaluation.ts	Updates prompt instructions to call unprefixed tool names.
README.md	Updates tools table + use-case examples to the new tool names.
docs/tools.md	Updates tool headings/syntax/examples to unprefixed tool names.
docs/prompts.md	Updates prompt docs to reference unprefixed tool names.
.omo/run-continuation/ses_17c8b3bbbffeRjqiOFUfwez9Sg.json	Adds a session metadata JSON file (appears to be an accidental artifact).
.omo/run-continuation/ses_17c4feeb8ffew8aF01tK3sMcT7.json	Adds a session metadata JSON file (appears to be an accidental artifact).

Comments suppressed due to low confidence (1)

docs/tools.md:357

The license_check example output doesn’t match the tool’s actual output format (header text and the “Scanned:” line). The implementation prints 🔏 Hound License Check and Scanned: <n> packages (first 50 of <total>) when truncated, so the docs example can’t show scanning 142 packages without noting the cap.

📄 License Audit — package-lock.json (policy: permissive)
══════════════════════════════════════════════════
Scanned 142 packages

-| `none`       | Report only — no violations flagged |
-
-### Example: hound_license_check
+### Example: license_check


@@ -104,9 +104,9 @@ Add to your MCP config file:
 → [See full examples with real lockfiles and expected output](examples/)


+{
+  "sessionID": "ses_17c8b3bbbffeRjqiOFUfwez9Sg",
+  "updatedAt": "2026-06-01T13:53:11.473Z",
+  "sources": {
+    "background-task": {
+      "state": "idle",
+      "updatedAt": "2026-06-01T13:53:11.473Z"
+    }
+  }
+}


+{
+  "sessionID": "ses_17c4feeb8ffew8aF01tK3sMcT7",
+  "updatedAt": "2026-06-01T14:57:31.898Z",
+  "sources": {
+    "background-task": {
+      "state": "idle",
+      "updatedAt": "2026-06-01T14:57:31.898Z"
+    }
+  }
+}


tiluckdave · 2026-06-17T19:42:21Z

The rename itself is correct and complete — I confirmed all 12 tools are unprefixed, names are unique, they wire through server.ts, and the suite passes (123/123). This does resolve #9. Two things block merge:

Drop the accidental session artifacts. .omo/run-continuation/ses_17c4feeb8ffew8aF01tK3sMcT7.json and ses_17c8b3bbbffeRjqiOFUfwez9Sg.json are agent state files unrelated to the rename — please git rm both. I'm adding .omo/ to .gitignore separately so it can't recur.
Restore the Policies table. docs/tools.md lost the entire ### Policies table under license_check (permissive / copyleft / none rows) — please add it back; that deletion is unrelated to the rename.

Optional sweep-up: hound_ still lingers in .github/ISSUE_TEMPLATE/bug_report.yml and CLAUDE.md. And a small note — the PR body credits #11 with the registration renames, but #11 is closed/unmerged; this PR's first commit is what actually does them, so worth correcting the description.

Heads-up on sequencing: I'm landing the typosquat cluster (#73, then #71) just before this, then rebasing the parser/error PRs (#70/#76/#78) on top of the rename — so please don't be surprised if I ask for a final rebase right before merge. Once 1 and 2 are in, this goes in. Thanks for the thorough work.

- Add `.omo/` to .gitignore so agent session files can't be committed again (they were accidentally included in PR #75). - Restrict the dev-dependencies Dependabot group to minor/patch so major bumps get their own reviewable PR. A grouped TypeScript 5->6 major broke CI in PR #58. Co-authored-by: Tilak Dave <tiluckdave@users.noreply.github.com> Co-authored-by: Claude Opus 4.8 <noreply@anthropic.com>

tiluckdave · 2026-06-27T09:42:32Z

Following up, @yizhi-shi — ready to merge once the two blockers are cleared: git rm the .omo/ session files, and restore the deleted ### Policies table in docs/tools.md. Able to push those?

tiluckdave · 2026-07-13T19:24:22Z

Hey @yizhi-shi, still around? Just need the .omo files removed and the Policies table restored, then this is good to merge.

tiluckdave · 2026-07-13T19:25:27Z

Also, a ⭐ would be much appreciated if you're finding this useful 🙌

tiluckdave · 2026-07-29T16:26:08Z

Hey @yizhi-shi — this still merges cleanly. Drop the stray .omo files and restore the Policies table in docs/tools.md and I'll get it in. Otherwise I'll close it out soon.

yizhi-shi added 2 commits June 1, 2026 22:02

fix: remove hound_ prefix from MCP tool names

b3d0f6c

MCP clients already prefix tools with the server name, causing redundant double-prefixing (e.g. hound_hound_audit). Strip the hound_ prefix from all 12 tool name definitions. Closes tiluckdave#9

yizhi-shi requested a review from tiluckdave as a code owner June 1, 2026 15:09

tiluckdave requested a review from Copilot June 2, 2026 11:58

Copilot started reviewing on behalf of tiluckdave June 2, 2026 11:58 View session

Copilot AI reviewed Jun 2, 2026

View reviewed changes

This was referenced Jun 17, 2026

Add language lock-file audit examples #69

Open

Improve unsupported lockfile error messages #70

Merged

tiluckdave mentioned this pull request Jun 17, 2026

chore: ignore .omo agent artifacts and ungroup dependabot majors #80

Merged

tiluckdave added SSoC26 Hard Significant effort/skill; wide surface or tricky edge cases labels Jun 17, 2026

tiluckdave mentioned this pull request Jul 13, 2026

MCP tools should not be named with prefix hound #9

Open

Navigation Menu

Uh oh!

fix: remove hound_ prefix from MCP tool names (complete) - #75

fix: remove hound_ prefix from MCP tool names (complete)#75
yizhi-shi wants to merge 2 commits into
tiluckdave:mainfrom
yizhi-shi:main

yizhi-shi commented Jun 1, 2026

Uh oh!

Copilot AI left a comment

Uh oh!

tiluckdave commented Jun 17, 2026

Uh oh!

tiluckdave commented Jun 27, 2026

Uh oh!

tiluckdave commented Jul 13, 2026

Uh oh!

tiluckdave commented Jul 13, 2026

Uh oh!

tiluckdave commented Jul 29, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants

		@@ -104,9 +104,9 @@ Add to your MCP config file:
		→ [See full examples with real lockfiles and expected output](examples/)

Uh oh!

Conversation

yizhi-shi commented Jun 1, 2026

Uh oh!

Copilot AI left a comment

Choose a reason for hiding this comment

Pull request overview

Reviewed changes

Uh oh!

tiluckdave commented Jun 17, 2026

Uh oh!

tiluckdave commented Jun 27, 2026

Uh oh!

tiluckdave commented Jul 13, 2026

Uh oh!

tiluckdave commented Jul 13, 2026

Uh oh!

tiluckdave commented Jul 29, 2026

Uh oh!

Reviewers

Assignees

Labels

Projects

Milestone

Development

Uh oh!

3 participants