Two tools with clear names and reasonable schemas, but descriptions lack depth and parameter documentation is incomplete. browser_search has a solid schema with min/max constraints. browser_visit supports flexible input (single URL or array) but goal parameter lacks constraint guidance. No output schemas documented. Error handling is basic (returns error.message as text). Missing security guidance (no mention of API key injection, timeout handling, rate limits). Naming is good (verb_noun pattern), but descriptions don't answer WHEN to use or WHAT prerequisites exist.

• Add explicit output schemas to tool definitions. Example for browser_search: { results: Array<{ title: string, snippet: string, url: string }> }. Example for browser_visit: { summary: string, extracted_info?: object }.
• Expand browser_search description to 150-200 chars: 'Search the web using Google Custom Search (or Serper API). Returns up to 10 results with title, snippet, and URL. Use this to find current information. Requires SERPER_API_KEY or GOOGLE_API_KEY + GOOGLE_CSE_ID environment variables.'
• Expand browser_visit description to clarify: 'Fetch and summarize web pages using AI. Pass a single URL string or array (max 5) and a goal describing what to extract. Returns a summary focused on the goal. Prerequisites: valid JINA_API_KEY environment variable for page fetch.'
• Add constraint guidance to 'goal' parameter: 'What you want to learn or extract from the page(s). Be specific: "Find the pricing for enterprise plans" vs "Tell me about the page". Max 500 chars.'
• Document maxItems constraint in browser_visit URL parameter description: 'Multiple URLs to visit concurrently (max 5). Larger batches will be rejected.'
• Improve error responses with categorization. For API key missing: 'No search API key configured. Set SERPER_API_KEY or GOOGLE_API_KEY + GOOGLE_CSE_ID environment variables.' For timeout: 'Search API timeout (>10s). Try a simpler query or retry in 30 seconds.'
• Add notes on the 10-result limit in browser_search. If agent needs exhaustive search, suggest refining the query rather than pagination.