Reddit MCP Server

Args: username: The username of the Reddit user (with or without 'u/' prefix) sort: Sort order for posts - one of: "new", "hot", "top", "controversial" time_filter: Time period to filter posts (e.g. "hour", "day", "week", "month", "year", "all") limit: Number of posts to return (1-100) Returns: Dictionary containing structured post history with the following structure: { 'username': str, # The username 'sort': str, # Sort method used 'time_filter': str, # Time filter used 'posts': [ # List of posts { 'id': str, # Post ID 'title': str, # Post title 'author': str, # Author's username 'subreddit': str, # Subreddit name 'score': int, # Post score (upvotes - downvotes) 'upvote_ratio': float, # Ratio of upvotes to total votes 'num_comments': int, # Number of comments 'created_utc': float, # Post creation timestamp 'url': str, # Full URL to the post 'permalink': str, # Relative URL to the post 'is_self': bool, # Whether it's a self (text) post 'selftext': str, # Content of self post (if any) 'link_url': str, # URL for link posts (if any) 'domain': str, # Domain of the linked content 'over_18': bool, # Whether marked as NSFW 'spoiler': bool, # Whether marked as spoiler 'stickied': bool, # Whether stickied in the subreddit 'locked': bool, # Whether comments are locked 'distinguished': Optional[str], # Distinguishing type (e.g., 'moderator') 'gilded': int, # Number of times gilded }, ... ], 'metadata': { 'fetched_at': float, # Timestamp when data was fetched 'post_count': int, # Number of posts returned } } Raises: ValueError: If username is invalid, sort method is invalid, or time_filter is invalid RuntimeError: For other errors during the operation