Salt MCP has 23 tools with highly inconsistent quality. Most tools (17/23) lack visible input schemas entirely, only 6 tools show explicit schema definitions (salt_read_room, salt_set_room_interests, salt_clear_room_interests, salt_join_commons, and 2 others). Descriptions are minimal (10-50 chars for most tools) and lack actionable context. Tool names are verb-based but many are vague ('consult_agent', 'delegate_to_agent', 'report_progress'). No parameter descriptions visible for tools without schemas. Error handling and output schemas are not documented. The codebase shows sophisticated implementation (UUID validation, decimal arithmetic, scope checking) but this sophistication is not reflected in the tool definitions exposed to LLMs.

• Add explicit JSON Schema input definitions to all 17 tools lacking them. Include type, description, and constraints for every parameter. Example: {"type": "object", "properties": {"agent_name": {"type": "string", "description": "Human-readable name for the agent (2-100 chars)"}}, "required": ["agent_name"]}
• Expand all tool descriptions to 50-200 characters. Include WHAT the tool does, WHEN to use it (vs similar tools), and what it returns. Example: 'Create a new Salt Agent with a given name and configuration. Returns agent_id for use in delegate_to_agent. Call this before delegating work to a new agent.'
• Document output schemas for all tools. Specify which fields are returned, their types, and which IDs/references are needed for chaining. Example: list_products returns [{product_id, name, price, created_at}] with total_count for pagination.
• Add parameter descriptions to all tools. For enum parameters (e.g., mode in salt_set_room_interests), explain each option. For IDs, clarify format (UUID vs integer). For strings, specify length/format constraints.
• Implement error handling guidance. For DESTRUCTIVE tools, add a dry_run parameter or confirmation step. Return actionable errors: 'Agent not found. Call list_salt_agents() to see available agents.' instead of bare error codes.