Four tools with basic schemas and descriptions, but significant gaps in parameter documentation and output schema clarity. All tools have descriptions (10-20 chars baseline met), but parameter descriptions are sparse or missing. Input schemas use Zod but lack formal descriptions for most parameters. No output schemas documented. Error handling is absent, tools return raw JSON without recovery guidance. Naming is verb-forward (parse_, infer_, detect_, test_) but descriptions are terse and lack WHEN/WHY context. No parameter constraints (enums, ranges) despite tools accepting free-form strings (method, headers). The test_endpoint tool accepts arbitrary HTTP methods and bodies with no validation hints.

• Add explicit output schemas to all tools. Document the structure of parse_docs (array of endpoints with fields), infer_schema (TypeScript type string), detect_auth (AuthInfo object), and test_endpoint (response status, headers, body).
• Add descriptions to all parameters. For test_endpoint: 'method: HTTP verb (GET, POST, PUT, DELETE, PATCH). Must be uppercase.' For infer_schema: 'examples: Array of JSON response objects to analyze. At least one example required.'
• Constrain free-form parameters with enums or patterns. test_endpoint.method should be an enum: ['GET', 'POST', 'PUT', 'DELETE', 'PATCH', 'HEAD', 'OPTIONS']. Validate in the handler and return 'Invalid method: got X, must be one of: GET, POST, ...'
• Expand tool descriptions to 100-200 chars. Include WHEN to use: 'Call parse_docs after fetch_page to extract endpoint definitions from HTML. Returns a list of {path, method, description} objects. Use infer_schema next to generate TypeScript types from response examples.'
• Add error handling with recovery guidance. If test_endpoint fails: 'Failed to reach endpoint (timeout). Check the URL is correct and the service is online. Try fetch_page first to verify the domain is accessible.' If infer_schema gets empty array: 'No examples provided. Call test_endpoint to fetch a live response, then pass it to infer_schema.'