Server has 4 tools with clear naming and generally good descriptions. Tool names follow verb_noun convention (markdown_to_mindmap, list_mindmaps, get_mindmap, cleanup_mindmaps). Descriptions are substantial and include context about use cases and behavior. However, schema quality is mixed: markdown_to_mindmap has a detailed but complex parameter spec with some ambiguities (e.g., 'at least one required' between markdown and inputPath is stated in description, not enforced in schema); list_mindmaps and cleanup_mindmaps have minimal parameter documentation; get_mindmap lacks output schema documentation. Error handling is mentioned generically but lacks specific recovery guidance. The descriptions lean heavily on templated hints (responseHint, modeHint, openHint) which suggest incomplete documentation in the actual code view provided.

• Expand get_mindmap description to document output structure: 'Returns the full file contents. For HTML, raw markup is returned. For PNG/SVG/JPG, content is returned as base64. Example response: {filePath: string, content: string, mimeType?: string}'
• Replace template placeholders in markdown_to_mindmap description with concrete examples. E.g., instead of 'Return mode={returnMode}: {modeHint}', write 'Return mode=path: Paths JSON only (no inline content). Return mode=content: Inline HTML text (if <200KB) or base64 image block. Return mode=both: Paths JSON plus inline content when available.'
• Add explicit output schema documentation for each tool. For example, list_mindmaps should document: 'Returns {files: [{name: string, path: string, size: number, created: ISO8601}], total: number}'
• For markdown_to_mindmap, use schema oneOf or clarify in description: 'Exactly one of markdown or inputPath is required. If both are provided, markdown takes precedence.' Then enforce in validation.
• Enhance cleanup_mindmaps description with concrete examples and error cases: 'Dry-run first to preview deletions. Common errors: EACCES (no write permission, run as owner), ENOENT (directory missing, create first with mkdir). Always backup before setting all=true.'
• Add 'When to use' guidance to list_mindmaps and get_mindmap descriptions to help LLMs choose between them: 'Call list_mindmaps to discover available mind maps. Call get_mindmap to retrieve a specific map by path found via list_mindmaps.'
• For markdown_to_mindmap, document the returnMode enum more explicitly in the description: 'returnMode (path|content|both): path returns file paths only; content returns inline HTML or base64 image (oversized HTML >200KB falls back to paths); both returns paths plus inline when eligible.'

Inferred effective spec: <=2025-11-25.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry