Act on this, mostly signal

Tool naming decides whether agents find your MCP tools

What to do

Review tool names and first-line descriptions on your MCP server.

Why

A 99-tool production server was missed in discovery. Claude Code, Codex, OpenCode and Grok Build discover tools differently.

Read the source at spiritroom.app

What the research found

A production MCP server with 99 tools was missed by agents in discovery; tool naming and first-line description matter because Claude Code, Codex, OpenCode and Grok Build use different discovery methods.

Claims and how well the evidence supports them

Server had 99 tools and returned correct data but agents still missed tools 99%
OpenCode 2.0.31 initial catalog included 16 of 99 tools with descriptions cut to about 120 characters 99%
Claude Code 2.1.301 initially exposed tool names rather than full descriptions 99%
Grok Build uses BM25 keyword ranking for tool discovery 99%

Evidence

spiritroom.app https://spiritroom.app/blog/optimise-mcp-tools-for-agents

Actionability rated high.