You can obtain Reddit API credentials by creating an app at Reddit's app preferences page.

For Claude, save this as claude_desktop_config.json in your Claude Desktop configuration directory at:

~/Library/Application Support/Claude/claude_desktop_config.json

For Cursor, save this as mcp.json in your Cursor configuration directory at:

~/.cursor/mcp.json

Available Tools

The server provides the following tools:

Read-only Tools (require only client credentials):

• get_user_info(username) - Get detailed user analysis with engagement insights
• get_user_comments(username, sort, time_filter, limit) - Get a user's comment history with filtering options
• get_user_posts(username, sort, time_filter, limit) - Get a user's post/submission history with filtering options
• get_top_posts(subreddit, time_filter, limit) - Get and analyze top posts
• search_posts(query, subreddit, sort, time_filter, limit) - Search for posts across Reddit or within a specific subreddit
• get_subreddit_stats(subreddit) - Get comprehensive subreddit analysis
• get_trending_subreddits() - Get list of trending subreddits
• get_submission_by_url(url) - Get a Reddit submission by its URL
• get_submission_by_id(submission_id) - Get a Reddit submission by its ID

Authenticated Tools (require user credentials):

• who_am_i() - Get information about the currently authenticated user
• create_post(subreddit, title, content, flair, is_self) - Create an optimized post
• reply_to_post(post_id, content, subreddit) - Add a reply with engagement insights
• reply_to_comment(comment_id, content, subreddit) - Add a strategic reply

Example Queries

Here are some examples of what you can ask an AI assistant connected to this server:

• "Who am I on Reddit?" or "Show my Reddit profile"
• "Analyze u/spez's Reddit activity"
• "Show me u/spez's recent comments"
• "Get the top posts by u/poem_for_your_sprog from the past year"
• "Show me the most controversial comments by u/username"
• "Show me the top posts from r/Python this week"
• "Search for posts about 'machine learning' across all of Reddit"
• "Find posts about 'beginner tutorials' in r/learnprogramming from this month"
• "Get statistics about r/AskReddit"
• "What are the trending subreddits right now?"
• "Create a post in r/Python about a new project"
• "Reply to this post with an insightful comment"
• "What's the best time to post in this subreddit?"

Advanced Features

AI-Driven Analysis

The server provides intelligent analysis in several areas:

1. User Analysis

   • Engagement patterns
   • Activity trends
   • Community influence
   • Personalized recommendations

2. Post Analysis

   • Performance metrics
   • Engagement quality
   • Timing optimization
   • Content impact assessment

3. Community Analysis

   • Health indicators
   • Growth patterns
   • Activity metrics
   • Engagement opportunities

Smart Response Formatting

• Organized bullet points
• Engagement statistics
• AI-driven insights
• Strategic recommendations
• Performance metrics

Authentication

The server supports two levels of authentication:

1. Read-only Access

   • Requires: client_id and client_secret
   • Allows: Fetching public data, reading posts/comments

2. Authenticated Access

   • Requires: All read-only credentials PLUS username and password
   • Allows: All read-only operations PLUS posting and commenting

Contributing

Contributions are welcome! Please feel free to submit a Pull Request.

License

This project is licensed under the MIT License - see the LICENSE file for details.