Skip to content

Improve hint message for fetching tool details - #376

Merged
jancurn merged 2 commits into
mainfrom
claude/mcp-tool-details-messaging-i3znc9
Aug 21, 2026
Merged

Improve hint message for fetching tool details#376
jancurn merged 2 commits into
mainfrom
claude/mcp-tool-details-messaging-i3znc9

Conversation

@jancurn

@jancurn jancurn commented Aug 21, 2026

Copy link
Copy Markdown
Member

Some AI agents saw the compact tool list hint as optional and called tools without fetching their schemas first. The hint (shown by connect, session info, and compact tools-list) now instructs: "Before calling a tool, get its full details and schema by running: mcpc @session tools-get <name>", with a second line pointing at tools-list --full for all-tool details.

  • Reworded the hint in formatToolsCompact (src/cli/output.ts)
  • Updated the unit and e2e tests asserting the old wording

https://claude.ai/code/session_016MJhXzu2yyHHZvHYWEtuzV

claude added 2 commits August 21, 2026 11:04
…lling

The previous hint ("For full tool details and schema, run mcpc @session
tools-list --full or mcpc @session tools-get <name>") read as optional, so
some AI agents called tools directly without fetching their schemas. The
hint now instructs to run tools-get before calling a tool, and no longer
mentions tools-list --full.

Co-Authored-By: Claude Fable 5 <noreply@anthropic.com>
Claude-Session: https://claude.ai/code/session_016MJhXzu2yyHHZvHYWEtuzV
@jancurn
jancurn requested a review from MQ37 August 21, 2026 11:25
@jancurn
jancurn merged commit 4d511de into main Aug 21, 2026
7 checks passed
@jancurn
jancurn deleted the claude/mcp-tool-details-messaging-i3znc9 branch August 21, 2026 11:27
Sign up for free to join this conversation on GitHub. Already have an account? Sign in to comment

Labels

None yet

Projects

None yet

Development

Successfully merging this pull request may close these issues.

3 participants