KaliMCP exhibits severe definition quality gaps across all dimensions. Tool names lack clear action verbs (run_tool, analyze_screenshot are vague). Descriptions are present but generic and lack WHEN/WHY guidance. Input schemas exist but parameters lack type constraints and validation rules. No output schemas documented. Error handling is minimal, tools return raw command output or generic errors without recovery guidance. The server conflates multiple concerns (run_tool handles arbitrary Kali tools, making it a catch-all rather than composable tools). No tool annotations (readOnlyHint, destructiveHint). Security concerns: run_tool accepts arbitrary arguments, creating command injection risk. Baseline: avg tool description ~100 chars (below 194 baseline); most params lack enums/constraints; no documented output structure.

• Split run_tool into specific, composable tools: run_nmap, run_nikto, run_sqlmap, etc. Each should have a clear verb_noun name and constrained parameters. This eliminates the catch-all anti-pattern and enables better LLM reasoning.
• Add enum constraints to all parameters with known valid values. E.g., analysis: enum=['concise', 'detailed', 'none']; scan_type: enum=['basic', 'full', 'stealth']. Declare these in JSON Schema, not just descriptions.
• Document output schemas for every tool. E.g., discover_tools returns {tools: [{name: string, category: string}], total: number}. This enables LLMs to chain tools and extract required fields.
• Add tool annotations: mark scan_target, enumerate_target, ffuf_scan, vulnerability_scan with destructiveHint=false (read-only); mark run_tool with destructiveHint=true (may modify system state).
• Implement input validation and sanitization in run_tool. Validate tool_name against an allowlist; sanitize arguments to prevent command injection. Return actionable errors: 'Tool nmap not found. Available tools: [list]. Call discover_tools() to search by category.'

Inferred effective spec: <=2025-11-25.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry