Elicitly provides three well-intentioned tools for human-in-the-loop interaction with clear names and reasonable descriptions. However, schema documentation is incomplete, parameter descriptions lack depth, and output schemas are not documented. The tools follow a verb-noun naming pattern (elicit_*) that clearly signals action, and descriptions explain the purpose adequately. Input parameters are present and typed via TypeScript/Zod, but the JSON Schema representation visible in the code lacks sufficient detail for LLM reasoning about field mappings and constraints. Error handling is generic. The prompts feature is implemented but ancillary to the core tool functionality.

• Document the return schema for each tool. For elicit_confirm: 'Returns {confirmed: boolean}'. For elicit_form: 'Returns {action: "submit"|"cancel", content: {[field_name]: value}} with field types matching requestedSchema.properties'. For elicit_doctor: 'Returns {form: boolean, url: boolean, sampling: boolean, roots: boolean, probe_result?: {success: boolean, error?: string}}'.
• Expand parameter descriptions with constraints and defaults. Example for elicit_confirm.labels: 'Optional object with keys "ok" and "cancel". If omitted, defaults to {ok: "OK", cancel: "Cancel"}. Each label must be 1-50 characters.'
• Clarify ElicitSchema structure in elicit_form. Describe that requestedSchema must follow JSON Schema conventions with 'type': 'object', 'properties' (field definitions), and 'required' (mandatory fields). Provide an example or link to docs.
• Add error classification guidance. Document that cancellation (action: 'cancel') is not an error but a valid outcome. Specify that timeoutSeconds errors are retryable, and provide a recovery message: 'Form submission timed out. Try again with a longer timeout or simpler form.'
• Set bounds on timeoutSeconds. Specify range (e.g., 1 - 3600 seconds) and default (e.g., 300 seconds).
• For elicit_doctor, clarify the purpose and typical use case. Example: 'Call this first to detect the host's MCP elicitation capabilities before attempting elicit_confirm or elicit_form. If form mode is false, elicit_form will fail; fall back to simpler elicit_confirm instead.'