Single tool with basic functionality but significant quality gaps. The deep_search tool has a visible input schema and description, but lacks critical metadata about output structure, error handling guidance, and parameter constraints. Description is minimal (43 chars, baseline p10=34, p90=392). No output schema documented. No error handling or recovery guidance. max_results parameter lacks validation constraints (no min/max bounds). The tool operates in isolation with no composition patterns or chaining metadata. Per-tool score (42) reflects these gaps across naming, description depth, parameter rigor, and schema completeness.

• Expand tool description to 80 - 200 characters explaining what deep_search does, when to use it (vs web search), what results look like, and any costs or rate limits. Example: 'Perform a deep web search using LinkUp API to retrieve detailed information from web pages. Returns sourced answers with citations. Useful for research, fact-checking, and multi-source queries. Requires LINKUP_API_KEY.'
• Document the output schema explicitly in the response. Modify the CallToolRequestSchema handler to return a structured response with clear field names and types: { content: [{ type: 'text', text: '<JSON schema description>' }], metadata: { sources: [...], query: '...', depth: 'deep' } }. Add a comment above the handler describing the output structure.
• Add min and max constraints to max_results parameter in the input schema. Update inputSchema to include: max_results: { type: 'number', default: 5, minimum: 1, maximum: 50, description: 'Maximum number of results to return (1 - 50). Default 5.' }
• Add early input validation in the CallToolRequestSchema handler. Before calling linkupClient.search(), validate: (1) query is non-empty string and matches expected length (e.g. 1 - 500 chars); (2) max_results is a number between 1 - 50. Return actionable errors: 'Invalid max_results: must be 1 - 50. Received: ' + maxResults.
• Wrap linkupClient.search() in a try-catch block with specific error messages. Example: catch (error) { if (error.message.includes('API')) { return { content: [{ type: 'text', text: 'LinkUp API error: ' + error.message + '. Verify LINKUP_API_KEY is valid.' }] }; } ... }