Three tools with basic descriptions but significant gaps in schema completeness and parameter documentation. create_preview has a reasonable description (145 chars) and partial input schema, but lacks output schema documentation. list_previews and stop_preview have minimal descriptions (under 50 chars) and empty input schemas. No parameter descriptions visible in any tool. Error handling guidance is absent. Tool names follow verb_noun convention (positive), but parameter constraints and output structures are undocumented.

• Expand list_previews and stop_preview descriptions to 50-150 characters explaining what they return and when to use them (e.g., 'List all active preview URLs for the current repository and branch, including creation time and TTL.')
• Add descriptions to all create_preview parameters: port (e.g., 'Port number (1-65535) the dev server listens on. Omit to auto-detect from common ports.'), name (e.g., 'Optional subdomain prefix (alphanumeric, 3-32 chars). Defaults to repo name.'), ttl (e.g., 'Expiration duration: 30m, 2h, 24h, 7d. Default 24h.')
• Document output schemas for all three tools. E.g., create_preview returns {url: string, subdomain: string, expires_at: ISO8601, status: 'active'|'pending'}
• Add error handling guidance: 'If dev server is not running, start it first. If port detection fails, specify port explicitly. If subdomain is taken, try a different name.'
• Add parameter constraints: port as number with min/max, ttl as regex pattern (e.g., /^\d+[mhd]$/), name as alphanumeric pattern