Single tool with adequate naming but significant gaps in description quality and schema documentation. Tool name 'get_nice_guidance' follows verb_noun convention (+). Description is 194 chars, within baseline range, but lacks critical context: no mention of prerequisites (SERPER_API_KEY required), no guidance on when to use vs alternatives, no output structure documented. Parameter 'query' has a description but lacks constraints (format, length, examples of valid queries). No output schema documented, LLM cannot predict response structure. No error handling guidance (what happens on API failure, timeout, no results). Tool performs external API calls with 30s timeout but no timeout error recovery documented.
Get guidance for a given topic from NICE. Args: query (str): The topic to get guidance for (eg. "high blood pressure") Returns: str: The guidance for the given topic.
No output schema documented. Tool returns raw concatenated text from multiple web pages with no structure. LLM cannot predict response format, field names, or data types.
Missing error handling guidance. Tool can fail silently (timeout returns empty dict, fetch_url returns 'Timeout error' string). No recovery instructions for LLM.
API key (SERPER_API_KEY) exposed via environment variable but no documentation of prerequisite setup. Description does not mention this dependency.
Parameter 'query' lacks format constraints. No guidance on valid input length, character restrictions, or examples of well-formed queries.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 51 | 2026-07-28+ | v2 |
No pagination or result limiting. Tool concatenates all text from 3 search results into single response, could easily exceed context window. No limit documented.