Server has 6 tools with basic schemas and descriptions, but significant quality gaps. All tools have descriptions (10-60 chars, mostly under 20 chars baseline), which is below the 194-char average for A+ tools. Input schemas are present but minimal, only 1 required parameter per tool, no enums, no constraints, no output schemas documented. Parameter descriptions are terse (e.g., 'The IP address to query'). No error recovery guidance, no pagination support despite search tool returning potentially large result sets, no tool annotations (readOnlyHint missing despite all being READ_ONLY). Tool names follow verb_noun pattern (good), but descriptions lack WHEN/WHY context. No documented output structure means LLMs cannot plan downstream calls or extract chaining IDs.

• Expand tool descriptions to 100-200 chars. Include WHEN to use (e.g., 'Call this to retrieve open ports and services running on an IP'), WHAT it returns (e.g., 'Returns ports, services, banners, and vulnerability count'), and any prerequisites (e.g., 'Requires valid IP address in CIDR or single-host format').
• Document output schemas for each tool. Example for get_ip_info: 'Returns {ip: string, ports: number[], services: {port: number, name: string}[], vulns: {cve: string, severity: string}[], last_update: ISO8601}'. This enables LLM planning and chaining.
• Add pagination to search tool: accept 'limit' (1-100, default 20) and 'offset' (default 0) parameters. Return {results: [...], total: number, limit: number, offset: number}. Document in description: 'Returns up to 20 results per call; use offset to paginate.'
• Add tool annotations to all tools. In ListToolsRequestSchema, add 'readOnlyHint: true' to each tool definition. This signals to LLMs that these tools are safe to call without confirmation.
• Improve error messages with recovery guidance. Instead of 'Shodan API error: 401 Unauthorized', return 'Authentication failed. Verify SHODAN_API_KEY environment variable is set and valid. Check Shodan account status at shodan.io.' For 'IP not found', return 'IP address not found in Shodan database. Try a different IP or use search() to discover devices.'