CLI tool to generate MCP servers from markdown documentation
Three tools with basic descriptions but critical gaps in schema documentation and parameter descriptions. list_docs and get_doc have empty input schemas ({}), violating the requirement that every parameter needs a description. search_docs has a single parameter with a description, but no output schemas are documented for any tool. Descriptions are present but generic (10-50 chars), below the 50-200 char baseline for LLM-optimized tools. No error handling guidance, no pagination support despite list_docs likely returning multiple items, and no indication of output structure.
Retrieves the full content of a specific document by its relative path.
Lists available documents with previews.
Searches all documents for a given query string using fuzzy matching.
list_docs and get_doc have empty input schemas ({}). This violates pattern:constrained-input and pattern:tool-description.
No output schemas documented for any tool. LLMs cannot plan downstream calls or extract data without knowing what fields to expect. Violates pattern:tool and pattern:response-shaper.
Descriptions are too short (10-50 chars vs 50-200 baseline). 'Lists available documents with previews' lacks context on when to call it vs search_docs, what structure is returned, and whether results are paginated.
list_docs likely returns multiple items but has no pagination parameters (limit, offset, page_size). Without pagination, large doc sets blow context windows. Violates pattern:paginated-result.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | F | 44 | 2026-07-28+ | v2 |
No error handling guidance. If get_doc is called with a non-existent path, what does it return? Does search_docs handle empty queries? Agents need recovery hints per pattern:recovery-guide.