TodoAssistant has 5 tools with basic schemas and descriptions, but significant gaps prevent production use. All tools have descriptions (10-50 chars, below the 50-200 char baseline for LLM optimization), and input schemas are present but minimal. Critical issues: (1) task_id parameter accepts both UUID and title string with fallback logic, creating ambiguity that violates the 'natural identifiers' pattern, LLMs cannot predict which format to use; (2) no output schemas documented, forcing LLMs to guess response structure; (3) error messages are generic ('Task not found or unauthorized') without recovery guidance; (4) no pagination for list_tasks despite potentially large result sets; (5) descriptions lack WHEN/WHY context, e.g., 'Create a new todo task' does not explain when to use add_task vs update_task. Per-tool average: 42/100.

• Split task_id into two parameters: task_id (UUID only) and task_name (string only). Or document precedence: 'Pass task_id as UUID if known; if only the title is available, pass task_name and task_id will be ignored.' Add examples to parameter descriptions.
• Document output schemas for all tools. E.g., add_task returns {task_id: string, title: string, description: string, due_date: string, completed: boolean, created_at: string, updated_at: string}. Include this in the tool description or a separate schema field.
• Expand descriptions to 50-200 characters with WHEN/WHY context. E.g., 'Create a new todo task. Use this when the user asks to add a task; use update_task to modify an existing task. Returns the new task with its ID.'
• Add pagination to list_tasks: accept limit (default 20, max 100) and offset (default 0) parameters. Return {tasks: [...], total: number, offset: number, limit: number}. Document in description: 'Returns up to 20 tasks per call; use offset to fetch more.'
• Improve error messages with recovery guidance. E.g., 'Task not found. Verify the task_id is correct or call list_tasks() to see available tasks.' For auth errors: 'No authenticated user context. Ensure USER_ID environment variable is set.'