Server has 4 tools with basic schemas and descriptions, but significant gaps limit production readiness. All tools have descriptions (10-50 chars, below ideal 50-200 char range) and input schemas are present but minimal. Parameter descriptions are sparse or missing entirely. Error handling is generic ('Error: {str(e)}') with no recovery guidance. No tool annotations (readOnlyHint/destructiveHint). Output schemas are undocumented. The download_paper tool is marked WRITE but has no confirmation/dry-run pattern despite being destructive.

• Expand tool descriptions to 100-200 chars. Example: 'search_papers: Search arXiv for papers matching a query. Returns up to max_results papers with title, authors, abstract, and arXiv ID. Use this to discover papers before reading or downloading. Supports filtering by date range and category.'
• Document output schemas in tool descriptions or as structured comments. E.g., 'Returns: {papers: [{id, title, authors, abstract, published_date}], total_count}'
• Add parameter descriptions for all fields. E.g., 'date_from: Start date in ISO 8601 format (YYYY-MM-DD). Papers published on or after this date.'
• Implement structured error messages with recovery hints. E.g., 'Paper not found: arXiv ID 2401.12345 does not exist. Try search_papers() to find valid IDs.'
• Add tool annotations: mark search_papers, list_papers, read_paper with readOnlyHint=true; mark download_paper with destructiveHint=true and add a check_status parameter for dry-run.

Inferred effective spec: <=2025-11-25.

• Relies on Logging (deprecated) - log to stderr or use OpenTelemetry