LeafWiki MCP demonstrates solid tool design with consistent naming (verb_noun pattern), complete input schemas across all 18 tools, and comprehensive parameter descriptions. All tools follow the verb-first convention (add_, search_, get_, browse_, list_, move_, copy_, ensure_). Schemas are well-formed with proper types and defaults. However, tool descriptions average ~80 chars (below the 194-char baseline for A+ tools), lacking context on WHEN to use each tool vs. alternatives and missing dependency hints. Output schemas are not documented in the source. Error handling guidance is absent, no recovery hints or categorization. Security considerations (permission gates, audit trails) are not visible. Composition is strong: tools are single-responsibility and chain well (e.g., search_pages → get_page → get_page_links). Parameter naming is consistent and human-friendly (id/path alternatives, sensible defaults).

• Expand tool descriptions to 100 - 200 chars. For each tool, add: (1) what it does, (2) when to use it vs. similar tools, (3) any prerequisites. E.g., 'Get a page by ID (preferred) or path. Use this after search_pages() returns a page_id, or when you know the exact path. Returns full content and metadata.'
• Document output schemas in docstrings. Specify which fields are always present, which are optional, and which IDs/references are needed for chaining. E.g., 'Returns: {id, title, slug, parent_id, content, tags, properties, created_at, updated_at}'.
• Add error recovery hints to descriptions. E.g., 'If page not found, try search_pages() with a partial title or browse_tree() to explore the hierarchy.'
• Implement tool annotations: mark add_page, move_page, copy_page, ensure_path as destructiveHint=true; mark all read-only tools with readOnlyHint=true; mark idempotent operations (e.g., ensure_path) with idempotentHint=true.
• Add optional dry_run parameter to destructive tools (add_page, move_page, copy_page) so agents can preview changes before committing. Return a summary of what would change without applying it.