An MCP server for generating standardized llms.txt and llms-full.txt documentation files to help AI models better understand project structures
Single tool 'generate-llms' with minimal definition quality. The tool has a basic description and a single string parameter with minimal schema documentation. The tool description is functional but vague about context and when to use it. Parameter lacks guidance on expected format or constraints. No output schema is documented. The tool appears to concatenate a prompt file with user input and return it as text, but this is inferred from code review rather than explicit in the definition. No error recovery guidance. Critical gaps in parameter descriptions, output schema documentation, and error handling patterns.
Use this tool whenever the task is to create llms.txt and llms-full.txt files for the current project.
No output schema documentation. Tool description does not specify what the return value contains, structure, or how downstream tools should parse it.
Parameter 'prompt' lacks format constraints, expected length, or usage guidance. Description is empty (parameter has no description at all).
Tool description is vague and does not explain what the tool returns, when exactly to call it, or what the LLM should do with the output. 'Use this tool whenever the task is to create llms.txt files' does not clarify: does this tool actually CREATE files, or does it return a prompt template?
No error handling guidance. The implementation catches errors and returns them as text, but the tool definition does not document error cases, recovery steps, or expected error response format.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-22 | F | 43 | 2026-07-28+ | v2 |
| 2026-03-09 | F | 30 | 1.12.1+ | v1 |
Tool naming 'generate-llms' uses hyphen instead of underscore, breaking verb_noun naming convention. Also ambiguous: does it generate the files, or the content/prompt for generation?
No idempotency contract. The tool concatenates a prompt file with user input and returns it; unclear if repeated calls with same input return same result, or if file state varies.