The server provides 27 tools across UniFi network management with complete input schemas and consistent, clear descriptions. Tool naming follows verb-noun patterns (list_, get_, set_, create_, update_, delete_) which aids LLM comprehension. All tools have descriptions (average ~100-150 chars, well within the 10-1024 baseline). Parameters include types and descriptions. However, output schemas are not documented in the provided source, the code shows no schema definitions for tool responses. Error handling lacks structured guidance and recovery hints. Some parameter descriptions are minimal (e.g., 'Site UUID; omit to use the configured default site' repeated across 24 tools). No tool annotations (destructiveHint, readOnlyHint, idempotentHint) are visible. Security-critical tools like restart_device and delete_firewall_zone have no confirmation or dry-run mechanism documented.

• Add explicit output schemas to all 27 tool definitions. Specify field names, types, and required fields. Example: list_clients should declare it returns {clients: [{client_id: string, mac: string, hostname: string, ...}], total: int}
• Add destructiveHint and readOnlyHint annotations to all tools. Mark restart_device, delete_firewall_policy, delete_firewall_zone as destructiveHint=true. Mark all list_* and get_* as readOnlyHint=true.
• Enhance descriptions of destructive operations with explicit warnings and confirmation guidance. E.g., 'restart_device: Sends an irreversible RESTART action. Requires manual confirmation, this will disconnect the device from the network.'
• Document pagination defaults and constraints. Update list_* tool descriptions: 'Returns one page (default limit=20, max 1000). Use offset and limit to paginate. Returns total count for efficient iteration.'
• Add error handling guidance to lookup tools (get_client, get_device, get_site, etc.). Include recovery hints: 'If device not found, try list_devices() first to discover valid device IDs in your site.'
• Consolidate and improve site_id parameter description. Use a shared template: 'Site UUID (from Settings → Sites). If omitted, uses the configured default site. Required format: UUID v4.'
• Create a shared description template for pagination parameters. 'Pagination offset (0 means start from first result, default varies by endpoint). Max result count is 1000, use offset to fetch subsequent pages.'
• Add per-request error handling. Define structured error responses with actionable messages. Validate offset/limit client-side and return 'Invalid limit: 2500. Maximum is 1000.' instead of silent truncation.