Three tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. Tool names follow verb_noun convention (search_books, get_libraries_*), which is good. However, descriptions are minimal (34-72 chars, below the 194-char baseline), and critical parameters lack descriptions. The 'query' parameter in search_books has no description. Prefecture and city parameters have examples but no format constraints or validation guidance. No output schemas documented. Error handling returns JSON strings but lacks recovery guidance. Resources feature is declared but returns placeholder responses.
Get libraries in the specified city using the Calil API
Get libraries in the specified prefecture using the Calil API
Search for books based on query parameters
Missing parameter descriptions for 'query' in search_books. LLMs cannot infer whether this is a title, author, keyword, or free-form search.
No output schemas documented for any tool. Callers cannot predict response structure, forcing LLMs to guess field names and types.
Prefecture and city parameters accept free-form strings with only examples ('東京都', '千葉県'). No enum constraint, format pattern, or validation guidance. LLMs may hallucinate invalid prefecture names.
Tool descriptions are 34 - 72 characters, well below the 194-char baseline. Descriptions lack context on WHEN to use each tool and what distinguishes them from each other.
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 47 | <=2025-11-25 | v2 |
Error responses return JSON strings but lack recovery guidance. 'Prefecture and city parameters are required' does not tell the LLM what to do next or how to correct the call.