Server has 16 tools with consistent naming (verb_noun pattern) and basic descriptions. All tools have input schemas with type definitions and parameter descriptions. However, descriptions are generic and lack LLM-optimized guidance on WHEN to use each tool vs. alternatives. Output schemas are not documented. Error handling is minimal, no recovery guidance or actionable error messages. Missing tool annotations (readOnlyHint, destructiveHint). Parameter descriptions lack format constraints and validation rules. No pagination support documented for list operations.

• Document output schemas for all tools. For jira_get_issue, specify: returns {key, summary, description, status, assignee, priority, created, updated, ...}. For jira_search_issues, specify: returns {issues: [{key, summary, status, ...}], total, startAt, maxResults}.
• Enhance tool descriptions to 50-200 chars with LLM-optimized guidance. E.g., 'Get a single Jira issue by key (e.g. PROJ-123). Returns full details: summary, description, status, assignee, priority, dates. Use jira_search_issues for bulk queries or filtering.' This clarifies WHEN to use each tool.
• Add tool annotations to all tools. Mark jira_delete_issue, confluence_remove_label, confluence_remove_restriction with destructiveHint=true. Mark all read-only tools (jira_get_*, confluence_get_*, confluence_list_*) with readOnlyHint=true. Mark idempotent tools with idempotentHint=true.
• Add enum constraints and bounds to parameters. E.g., jira_create_issue.issue_type should list valid values (Task, Bug, Story, Epic). jira_search_issues.max_results should have min=1, max=100. confluence_add_restriction.operation should be enum [read, update]. Include these in both JSON Schema and descriptions.
• Implement error handling with recovery guidance. When a tool fails, return structured error: {error: 'issue_not_found', message: 'Issue PROJ-999 not found', suggestion: 'Try jira_search_issues with a partial key or summary'}. Categorize errors as retryable (network), user_fixable (invalid input), or fatal (permission denied).