Git-like versioning for prompts with eval-gated promotion, exposed as an MCP server
Single tool with clear naming (prompt.get) and adequate schema. Description is present but generic (72 chars, below ideal 50-200 range). Input schema properly typed with required field and object properties. However, output schema is not documented, LLMs cannot predict what fields the response contains. No error handling guidance, no parameter constraints (e.g., promptId format), and no mention of variable substitution behavior or edge cases. Lacks composition guidance for multi-step workflows.
Retrieve the production version of a prompt with optional variable substitution
Output schema not documented. LLMs cannot infer what fields the response contains (e.g., content, version, metadata, timestamp). This forces guessing and breaks downstream tool chaining.
Description is generic and under-specified (72 chars). Does not explain WHEN to use this tool vs alternatives, what 'production version' means, or what happens if promptId is not found. Lacks actionable context for LLM selection.
Parameter 'promptId' lacks format constraints. Is it a UUID, slug, integer ID, or free-form string? No description of valid formats, length limits, or case sensitivity. LLMs will guess and pass invalid values.
No error handling guidance. What happens if promptId does not exist? What if variable substitution fails? No recovery hints for the LLM.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | D | 52 | 2026-07-28+ | v2 |
Variables parameter is under-documented. Does it support nested objects? What happens if a variable is missing from the template? Are there reserved variable names?