Server has 4 tools with complete schemas and descriptions, but quality is uneven. Tool names follow verb_noun convention (start_timer, stop_timer, get_summary, list_tags), good. Descriptions are present but generic (avg ~80 chars, below 194-char baseline). Parameters have types and descriptions, but lack constraints (enums, ranges, patterns). No output schema documentation. Error handling exists but lacks recovery guidance. Input sanitization is present but inconsistent across tools. No tool annotations (readOnlyHint/destructiveHint). Overall: functional but below production baseline.
Generates an aggregate report of tracked time, optionally filtered by range and/or tags.
Lists tags used in Timewarrior intervals. Use this before starting a timer to ensure similar tags are repeated for better reporting. Optionally filtered by a date range.
Starts a new Timewarrior timer interval with the specified tags. MUST use list_tags first to ensure consistent tags.
Stops the currently running Timewarrior interval.
No output schema documentation. Tools return text content but LLMs cannot predict structure (e.g., get_summary returns raw timew output; list_tags returns newline-separated tags). Agents cannot reliably parse or chain results.
Missing tool annotations. start_timer and stop_timer are destructive (WRITE risk) but lack destructiveHint annotation. get_summary and list_tags are read-only but lack readOnlyHint. Agents cannot distinguish safe from risky operations.
Descriptions lack dependency hints and prerequisites. start_timer says 'MUST use list_tags first' but this is buried in description text, not formalized. No structured guidance on tool ordering or when to call discovery tools.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 56 | 2026-07-28+ | v2 |
Error handling lacks recovery guidance. Errors are thrown as generic messages (e.g., 'Failed to get summary: <stderr>') without actionable next steps. LLMs cannot self-correct or retry intelligently.
Parameter constraints missing. 'range' parameter accepts free-form strings with basic sanitization but no enum or pattern constraint. 'tags' array has minItems=1 for start_timer but no maxItems or character limits. Invites invalid input.