Provides a Python-based MCP Reddit server with tools for browsing, searching, posting, and interacting with Reddit content via a standardized interface.
Configuration
View docs{
"mcpServers": {
"ayush3298-mcp-servers": {
"command": "python",
"args": [
"reddit_mcp.py"
],
"env": {
"REDDIT_PASSWORD": "YOUR_PASSWORD",
"REDDIT_USERNAME": "YOUR_USERNAME",
"REDDIT_CLIENT_ID": "YOUR_CLIENT_ID",
"REDDIT_CLIENT_SECRET": "YOUR_CLIENT_SECRET"
}
}
}
}You can run a dedicated MCP Reddit server that exposes Reddit interactions through a standardized interface, letting your apps browse, search, post, and vote with consistent tooling across platforms.
Connect your MCP client to the Reddit MCP Server using the standard MCP connection flow. Request the list of available tools, then invoke the tools you need with the appropriate parameters. You can browse subreddits, fetch post details with comments, search Reddit content, view user profiles, and perform create and voting actions. All actions conform to the MCP protocol, so your client code can interact with this server in a consistent way alongside other MCP endpoints.
Prerequisites you need before installation.
# Prerequisites
python3.8+
# API credentials for Reddit (and any other platforms you plan to use)Steps to set up and run the Reddit MCP Server.
# 1. Clone the project
git clone https://github.com/ayush3298/mcp-servers.git
cd mcp-servers
# 2. Install dependencies for the Reddit MCP server
cd servers/reddit_server
pip install -r requirements.txt
# 3. Configure API credentials
# Create a .env file in the server directory with the required credentials
# (e.g., Reddit API client ID/secret, and any other needed variables)
# 4. Run the server
python reddit_mcp.pyConfiguration and security notes help you keep the server running smoothly and securely.
- Create and manage a .env file in the reddit_server directory to supply API credentials. Keep this file secure and do not commit it to version control. - The server is a Python-based MCP implementation. Ensure your Python environment uses compatible dependencies as listed in requirements.txt. - The server exposes tools for browsing subreddits, obtaining post details with comments, performing searches, viewing user profiles, creating posts and comments, voting, and accessing subreddit rules.
List and browse available subreddits to explore content and communities.
Retrieve a post along with its comments and metadata.
Search Reddit for posts, comments, or users matching provided queries.
Fetch public profile information for a Reddit user.
Create a new post within a subreddit.
Add a comment to a post or comment thread.
Vote on posts or comments to influence ranking.
Access the rules and guidelines for a subreddit.