The Reddit MCP server has solid naming conventions with clear verb-noun patterns (get_subreddit_posts, search_posts, submit_post, etc.). All 12 tools have descriptions and input schemas are present with type definitions and parameter descriptions. However, there are notable gaps: (1) output schemas are completely undocumented, no description of what fields are returned from any tool, forcing LLMs to infer structure from API calls; (2) parameter descriptions, while present, often lack constraints and ranges (e.g., 'limit' accepts 1-100 but description doesn't specify bounds in several tools); (3) error handling guidance is minimal, no actionable recovery messages visible; (4) the two write tools (submit_post, submit_comment) lack dry-run/confirmation patterns despite being irreversible; (5) no tool annotations (readOnlyHint, destructiveHint) to help agents understand operation safety. The 8 read-only tools are well-designed for discovery, but the 4 write/action tools need strengthening with confirmations and clearer consequences.

• Document output schemas for all tools. Specify the exact fields returned (e.g., for get_subreddit_posts: 'Returns array of posts with fields: id, title, author, score, created_at, url, subreddit, ...'). This allows LLMs to extract data confidently.
• Add dry-run parameter to submit_post and submit_comment: 'dryRun': {type: 'boolean', description: 'If true, validate the post/comment without publishing', default: false}. This gives agents a safe way to test before committing.
• Declare 'sort' and 'kind' parameters as enums in input schemas. Example: 'sort': {type: 'string', enum: ['hot', 'new', 'top', 'rising', 'controversial'], description: 'Sort order'}.
• Add explicit range constraints to numeric parameters in descriptions. E.g., 'limit': {type: 'integer', description: 'Number of posts to return (1-100)', minimum: 1, maximum: 100}.
• Add tool annotations in the tool definition: readOnlyHint: true for all get_* and search_* tools; destructiveHint: true for submit_post and submit_comment; idempotentHint: true for vote and save_post (reversible operations).
• Enhance error handling in write tool implementations. Return actionable errors: 'Failed to post to r/subreddit: subreddit not found or you lack posting permissions. Try searching for the correct subreddit name with search_subreddits()' instead of generic exceptions.
• Document pagination behavior: include 'Returns max 100 results. Use the next_cursor field from the response to fetch additional posts.' in tool descriptions for paginated tools.

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

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