Server has well-structured tool definitions with complete schemas (Zod + JSON Schema conversion), clear descriptions, and proper parameter typing. All 6 tools are explicitly registered with names, descriptions, and input schemas. However, descriptions are generic and lack LLM-optimized guidance on WHEN to use each tool vs. alternatives. Parameter descriptions are present but minimal (e.g., 'Name of the subreddit' lacks format hints). Output schemas are not documented, LLMs cannot predict response structure. Error handling is basic (generic AppError, ZodError messages). No tool annotations (readOnlyHint, etc.) despite all tools being read-only. Pagination support exists but next_cursor handling is undocumented.

• Add readOnlyHint: true to all 6 tool definitions in ListToolsRequestSchema handler. This signals to agents that tools are safe to call repeatedly without side effects.
• Expand tool descriptions to 150 - 250 chars. Add WHEN guidance: 'Use this to browse trending posts across all subreddits. Use reddit_get_subreddit_posts instead if you want posts from a specific community.'
• Document output schema for each tool. Create a TypeScript interface or JSON Schema for the markdown response structure, including fields like posts[], post.title, post.score, post.author, pagination.next_cursor.
• Enhance parameter descriptions with format hints. E.g., 'Pagination cursor (opaque string from previous response; pass as-is to fetch next page)' and 'Subreddit name without r/ prefix (e.g., "AskReddit", not "r/AskReddit").'
• Improve error messages with actionable recovery. E.g., 'Invalid subreddit: "xyz" not found. Try reddit_search to discover communities.' instead of raw ZodError output.

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

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