TypeScript stdio MCP server for deterministic local repository health summaries.
Single tool with clear naming (repo_health_summary) and adequate description (97 chars). Input schema is present with proper type and description. However, output schema is completely undocumented, the tool returns JSON via text content with no declared structure, forcing LLMs to parse unstructured output. No error handling guidance, no parameter constraints beyond minLength=1, and no documentation of what fields the JSON response contains. Lacks idempotency hints and recovery guidance for common failure modes (missing git, invalid paths).
Summarize deterministic local repository health signals for a checkout path.
Output schema completely undocumented. Tool returns JSON as plain text with no declared structure. LLMs cannot plan downstream operations or extract fields reliably.
No error handling guidance. Tool can fail (invalid path, git not installed, permission denied) but provides no recovery hints or error categorization.
Parameter 'checkoutPath' lacks format/constraint documentation. Description mentions 'relative paths resolve from server process' but does not specify allowed characters, max length, or symlink handling.
Tool description does not state what the output contains or when to use it. 'Summarize deterministic local repository health signals' is vague, does not explain what 'health signals' means or what fields are returned.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 55 | 2026-07-28+ | v2 |
No idempotency guarantee documented. Tool reads filesystem and git state, repeated calls should return same result, but this is not stated. Agents may retry on ambiguous failures without knowing if it is safe.