MCP server: word/sentence/paragraph counts plus reading-time estimate.
Single-tool server with clear naming ('count') and a well-structured input schema. Tool description is adequate (89 chars, within baseline 34 - 392 range). Input parameters have types and descriptions. However, output schema is not formally documented, the tool returns a JSON object but the response structure is not declared in the tool definition, forcing LLMs to infer field names. Error handling is basic (generic error messages without recovery guidance). No parameter validation constraints (e.g., wpm must be positive is checked at runtime but not declared in schema). Missing tool annotations (readOnlyHint, idempotentHint) that would clarify intent.
Count characters / words / sentences / paragraphs in text and estimate reading time.
Output schema not documented. Tool returns CountResult object with fields (characters, words, sentences, paragraphs, reading_time_minutes, reading_time_display) but this structure is not declared in the tool definition. LLMs cannot plan downstream operations or validate responses.
Parameter 'wpm' lacks constraint documentation in schema. Runtime validation (wpm > 0) exists but is not exposed via JSON Schema minValue or description. LLMs may pass invalid values; error message 'wpm must be positive' is generic and does not guide recovery.
Error responses lack recovery guidance. 'wordcount failed: <message>' and 'unknown tool: <name>' do not tell the LLM what to do next or whether the error is retryable. No error classification (retryable vs user-fixable vs fatal).
Missing tool annotations. No readOnlyHint or idempotentHint declared, even though 'count' is a pure read-only, idempotent operation. Annotations help LLMs reason about safety and retry logic.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 59 | 2026-07-28+ | v2 |
STDIO transport only. Server is not remotely accessible and cannot be used by hosted MCP clients. Limits deployment flexibility and integration with cloud-based agent platforms.