A Swift-based MCP server that provides utility tools for date/time conversion
Single tool with minimal definition quality. Tool name 'unixtimeConverter' violates verb-first naming convention (should be 'convert_unix_time' or similar). Description is adequate (67 chars, within 10-1024 range) but lacks WHEN/WHY context. Input schema present but incomplete: parameter 'date' has description but schema lacks required field declaration and type validation. No output schema documented. No error handling guidance beyond basic validation. Tool does one thing (acceptable) but definition falls short of production standards.
Convert between Unix timestamp and human-readable date
Tool name violates verb-first convention. 'unixtimeConverter' should be 'convert_unix_time' or 'convert_timestamp'. LLMs rely on action verbs to infer intent.
Input schema lacks 'required' field declaration. Parameter 'date' is present but schema does not explicitly mark it as required, leaving ambiguity for LLM invocation.
No output schema documented. Tool returns text content but LLM cannot parse structured fields (timestamp value, original date, conversion direction). Prevents downstream tool chaining.
Description lacks WHEN/WHY context. Does not explain when to use this tool vs alternatives, prerequisites, or what the output enables. Current: 'Convert between Unix timestamp and human-readable date', too generic.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 45 | 2026-07-28+ | v2 |
Error messages are user-facing but not LLM-optimized. 'Invalid date: X. Expected format: yyyy-MM-dd HH:mm:ss' lacks recovery guidance (e.g., 'Try format YYYY-MM-DD HH:MM:SS or call get_current_time() first').