stacklok / toolhive / 22765002621

64%

Build Type

push

github

Committed by web-flow

Commit Message

Enrich optimizer tool descriptions for better LLM usage (#4031)

* Enrich optimizer tool descriptions for better LLM usage

The `find_tool` and `call_tool` MCP tools exposed by the optimizer had
minimal descriptions that did not give LLMs enough context to use them
effectively. LLMs rely heavily on tool descriptions to decide when and
how to invoke tools, so sparse descriptions led to poor tool discovery
and incorrect invocations.

This aligns the Go descriptions with the richer ones in the Python
mcp-optimizer reference (`server.py`), covering:
- When and why to use each tool (use cases)
- What the tools return (response structure)
- Workflow guidance (always call find_tool before call_tool)
- Examples for find_tool queries
- Detailed parameter descriptions with examples for input schemas

Co-Authored-By: Claude Opus 4.6 <noreply@anthropic.com>

* Fix unit tests with tool descriptions

---------

Co-authored-by: Claude Opus 4.6 <noreply@anthropic.com>

Run Details

24 of 24 new or added lines in 1 file covered. (100.0%)

11 existing lines in 3 files now uncovered.

47136 of 73763 relevant lines covered (63.9%)

73.08 hits per line