Playwright MCP has 25 tools with significant quality gaps. Tool naming is inconsistent (browser_click appears twice with different signatures; browser_drag, browser_type duplicated). Descriptions are minimal (10-50 chars, well below the 194-char baseline). Most parameters lack descriptions entirely, e.g., browser_navigate's 'url' param has a description, but browser_press_key's 'key' param is described only as 'Name of the key to press or a character to generate, such as `ArrowLeft` or `a`' (contains example values, violating pattern:tool-description). No output schemas documented. Error handling is absent, tools return raw error strings with no recovery guidance. Duplicate tool names (browser_click #11 vs #19, browser_drag #12 vs #20, browser_type #14 vs #21) indicate tool registration issues. Parameters like 'ref' (element reference) lack type constraints and validation rules. No tool annotations (readOnlyHint, destructiveHint, idempotentHint) despite clear risk levels assigned.

• Deduplicate browser_click, browser_drag, and browser_type. Merge coordinate-based and element-based variants into single tools with optional parameters, or rename one variant (e.g., browser_click_at_coordinates vs browser_click_element).
• Expand all descriptions to 100-200 chars. Include WHAT the tool does, WHEN to use it, and what it returns. E.g., 'Navigate to a URL and wait for page load. Returns the final page title and URL. Use before taking screenshots or interacting with page elements.'
• Add descriptions to all parameters. For 'ref' (element reference), explain: 'Exact target element reference from the page snapshot (e.g., "button[aria-label=Submit]"). Obtain from browser_snapshot output.'
• Document output schemas for all tools. E.g., browser_snapshot returns {type: 'object', properties: {accessibility_tree: {type: 'string'}, ...}}. Include required fields for chaining (e.g., element refs for browser_click).
• Add tool annotations: mark browser_close and browser_close_tab with destructiveHint=true; mark browser_navigate, browser_go_back, browser_go_forward, browser_take_screenshot with readOnlyHint=true; mark browser_type, browser_click with idempotentHint=false (not idempotent if page state changes).