Allows AI assistants to access and interact with Reddit content, providing tools for analyzing user activity, fetching posts from subreddits, retrieving subreddit statistics, viewing trending subreddits, creating posts with timing recommendations, and replying to posts/comments with engagement optimization.
Reddit MCP Server
This repository contains a Model Context Protocol server implementation for Reddit that allows AI assistants to access and interact with Reddit content through PRAW (Python Reddit API Wrapper).
What is MCP?
The Model Context Protocol (MCP) is a standard for enabling AI assistants to interface with external services, tools, and data sources. This server implements the MCP specification to provide access to Reddit content.
To know more about MCP, Check this video
Features
- Get detailed user information with engagement analysis
- Fetch and analyze top posts from any subreddit
- Get comprehensive subreddit statistics and health metrics
- View trending subreddits with growth patterns
- Create strategic posts with timing recommendations
- Reply to posts and comments with engagement optimization
- AI-driven insights and recommendations
- Smart response formatting with engagement metrics
Installation
- Clone this repository
- Connect to the MCP serverCopy the below json with the appropriate {{PATH}} values: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:For Cursor, save this asmcp.json
in your Cursor configuration directory at: - Restart Claude Desktop / CursorOpen Claude Desktop and you should now see Reddit as an available integration.Or restart Cursor.
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 insightsget_top_posts(subreddit, time_filter, limit)
- Get and analyze top postsget_subreddit_stats(subreddit)
- Get comprehensive subreddit analysisget_trending_subreddits()
- Get list of trending subreddits
Authenticated Tools (require user credentials):
create_post(subreddit, title, content, flair, is_self)
- Create an optimized postreply_to_post(post_id, content, subreddit)
- Add a reply with engagement insightsreply_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:
- "Analyze u/spez's Reddit activity"
- "Show me the top posts from r/Python this week"
- "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:
- User Analysis
- Engagement patterns
- Activity trends
- Community influence
- Personalized recommendations
- Post Analysis
- Performance metrics
- Engagement quality
- Timing optimization
- Content impact assessment
- 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:
- Read-only Access
- Requires:
client_id
andclient_secret
- Allows: Fetching public data, reading posts/comments
- Requires:
- Authenticated Access
- Requires: All read-only credentials PLUS
username
andpassword
- Allows: All read-only operations PLUS posting and commenting
- Requires: All read-only credentials PLUS
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.
This server cannot be installed
An MCP server that enables AI assistants to access and interact with Reddit content through features like user analysis, post retrieval, subreddit statistics, and authenticated posting capabilities.
Related MCP Servers
- -securityAlicense-qualityAn MCP server that helps AI assistants access text content from websites that implement bot detection, bridging the gap between what you can see in your browser and what the AI can access.Last updated -1PythonApache 2.0
- -securityFlicense-qualityA specialized MCP server that enables AI agents to interact with Reddit, including reading posts, creating content, and managing subreddit configurations.Last updated -715TypeScript
- AsecurityAlicenseAqualityA plug-and-play MCP server that enables AI assistants to browse, search, and read Reddit content through the PRAW library.Last updated -66PythonMIT License
- -securityFlicense-qualityA MCP server that allows AI assistants to interact with the browser, including getting page content as markdown, modifying page styles, and searching browser history.Last updated -5TypeScript