Reddit MCP Server

Args: query: The search query/term to search for subreddit: Optional subreddit to limit search to (with or without 'r/' prefix). If None, searches all of Reddit sort: Sort order for results - one of: "relevance", "hot", "top", "new", "comments" time_filter: Time period to filter results (e.g. "hour", "day", "week", "month", "year", "all") limit: Number of posts to return (1-100) Returns: Dictionary containing structured search results with the following structure: { 'query': str, # The search query used 'subreddit': Optional[str], # Subreddit searched (None if searching all of Reddit) 'sort': str, # Sort method used 'time_filter': str, # Time filter used 'posts': [ # List of matching 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, # 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) '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') 'flair': Optional[Dict], # Post flair information if any }, ... ], 'metadata': { 'fetched_at': float, # Timestamp when data was fetched 'result_count': int, # Number of results returned 'search_scope': str, # "all" or subreddit name } } Raises: ValueError: If query is empty, sort method is invalid, or time_filter is invalid RuntimeError: For other errors during the operation