Server has 4 tools with basic descriptions and Zod schemas. Naming follows verb_noun convention (list_, get_, search_). However, descriptions are minimal (10-80 chars, below the 50-200 char baseline for LLM optimization), parameter descriptions lack detail on constraints and formats, and output schemas are not formally documented. Error handling returns text but lacks recovery guidance. No tool annotations (readOnlyHint, etc.) despite all tools being read-only. The search tool's queryBody parameter accepts z.record(z.any()) which is too permissive and lacks format guidance.
Get field mappings for a specific Elasticsearch index
Get shard information for all or specific indices
List all available Elasticsearch indices
Perform an Elasticsearch search with the provided query DSL. Highlights are always enabled.
Tool descriptions are too brief (10-80 chars vs. 50-200 char baseline). 'List all available Elasticsearch indices' lacks context on when to call it vs. get_shards, what structure it reveals, or how to use results downstream.
search tool's queryBody parameter uses z.record(z.any()), too permissive. No format guidance on valid Elasticsearch DSL structure, required vs. optional fields, or examples of valid queries. LLMs will struggle to construct valid DSL.
Output schemas not formally documented. Tools return text content blocks with JSON strings, but no schema definition tells LLMs what fields to expect (e.g., does list_indices return health, status, docsCount for each index?). Downstream tool chaining is unclear.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | 2026-07-28+ | v2 |
Error handling returns raw error messages without recovery guidance. 'Error: index_not_found_exception' tells the LLM nothing about what to do next. Should suggest 'Try list_indices() to see available indices' or similar.
No tool annotations despite all tools being read-only. Missing readOnlyHint in tool definitions. This prevents clients from optimizing caching, retry logic, or safety checks.