Server has 5 well-named tools with complete input schemas and descriptions. Tool names follow verb_noun pattern (scan_page, scan_html, compare_reports, verify_repair, run_keyboard_journey). All tools have descriptions (50-100 chars) and detailed parameter schemas with types. However, output schemas are not documented in the provided source, only input schemas are visible. Parameter descriptions are present but vary in depth. No error handling guidance visible. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite all tools being READ_ONLY. Missing documentation of return types and structures.

• Document output schemas for all 5 tools. Specify the structure of audit reports, comparison results, and verification outcomes. Include field names, types, and what each field represents.
• Add readOnlyHint: true to all tool schemas. This signals to agents that these tools are safe to call repeatedly without side effects.
• Add constraint documentation to parameters: viewport (e.g. width 320-1920, height 240-1080), wcagTags (e.g. 'wcag2a, wcag2aa, wcag21a, wcag21aa'), selector arrays (e.g. max 50 selectors).
• Document the structure of 'before', 'after', and 'baseline' report objects. Provide a JSON Schema or example showing required fields (violations, passes, incomplete, inapplicable, etc.).
• Add error handling guidance: 'If readySelector times out, the page may not be loading correctly. Try increasing timeout or verifying the selector exists.' Include recovery steps for common failures.