MCP server for the Kanji Alive API - search and retrieve information about Japanese kanji characters
This server demonstrates solid engineering with clear tool naming, comprehensive parameter schemas, and good use of tool annotations. All three tools follow verb_noun convention (search_*, get_*), have proper Zod-validated input schemas with type definitions, and include descriptive parameters. Tool annotations (readOnlyHint, destructiveHint, idempotentHint) are correctly applied. However, tool descriptions are somewhat generic and lack actionable LLM guidance on when/why to use each tool over alternatives. Parameter descriptions exist but could be richer with constraints and examples. Output schemas are not explicitly documented in the visible code. Error handling is present but error messages are not visible in the provided source.
Get detailed information about a specific kanji character
Advanced kanji search with multiple optional filter parameters
Search for kanji using a single query term
Tool descriptions lack LLM-actionable guidance. Descriptions do not explain WHEN to use each tool (e.g., when is basic search sufficient vs. advanced search needed?), making tool selection ambiguous for LLMs.
Output schemas are not documented in tool definitions. The tool definitions include input schemas but no explicit documentation of what fields are returned, forcing LLMs to infer structure from actual API responses.
Parameter descriptions are generic and lack format/constraint guidance. For example, 'grade' parameter has description 'Japanese grade level (1-6 for elementary, optional)' which is adequate, but 'meaning' and 'kunyomi' parameters lack guidance on format (romaji vs. kanji, partial vs. exact match).
Inferred effective spec: <=2025-11-25.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | B | 75 | <=2025-11-25 | v2 |
| 2026-03-09 | D | 58 | - | v1 |
Error handling strategy not visible in tool definitions. Source shows no explicit error recovery guidance in descriptions or visible error handling patterns.