Page Agent MCP has 3 tools with minimal schema documentation and weak descriptions. execute_task lacks parameter descriptions entirely (only 'task' with type string, no guidance on format or constraints). get_status and stop_task have no input parameters documented. Descriptions are present but generic (10-50 chars), below the 194-char baseline for production tools. No output schemas visible. No error handling guidance. No tool annotations (readOnlyHint, destructiveHint, idempotentHint). Tool composition is reasonable (separate concerns), but schema and description quality are far below production standards.

• Add detailed parameter descriptions to execute_task: 'Natural language task description (1-2000 chars). Examples: "Click the login button and enter credentials", "Fill the form and submit". Avoid ambiguous instructions; be specific about target elements and expected outcomes.'
• Document output schemas for all tools. Example for execute_task: {success: boolean, result: string, duration_ms: number, error?: string}. Example for get_status: {hub_connected: boolean, agent_status: 'idle'|'running'|'error', current_task?: string}.
• Add tool annotations: execute_task with destructiveHint=true (modifies browser state), get_status with readOnlyHint=true, stop_task with destructiveHint=true (interrupts running task).
• Expand descriptions to 100-200 chars with actionable context. E.g., execute_task: 'Execute a browser automation task in natural language. Use for multi-step workflows like form filling, navigation, or data extraction. Blocks until complete or timeout (60s). Returns success status and result. Call get_status first to ensure agent is ready.'
• Add error handling guidance in descriptions or separate error documentation. E.g., 'Errors: timeout (retryable, increase timeout or simplify task), invalid_task (user-fixable, clarify instructions), browser_unavailable (fatal, restart agent).'
• Consider adding a 'timeout_seconds' optional parameter to execute_task to let LLMs control wait duration and avoid blocking indefinitely.