Reddit Universal MCP Server

What is Reddit Universal MCP Server about?

The Reddit Universal MCP Server implements the Model Context Protocol for Reddit, allowing developers to call Reddit functionalities via a consistent, framework‑agnostic API. It leverages the Universal MCP framework to ensure compatibility with other MCP‑compliant services.

How to use Reddit Universal MCP Server?

1. Prerequisites – Install Python 3.11+ and the uv package manager.
2. Install dependencies – Run uv sync to create a virtual environment and install all required packages.
3. Activate the environment – source .venv/bin/activate (Linux/macOS) or .venv\Scripts\Activate (Windows PowerShell).
4. Start the MCP inspector – mcp dev src/universal_mcp_reddit/server.py and note the displayed address/port.
5. Install the application – mcp install src/universal_mcp_reddit/server.py.
6. Consume the API – Access the server through the address shown by the inspector or via the UI at agentr.dev after enabling the Reddit app.

Key features of Reddit Universal MCP Server

• MCP‑compliant: Full adherence to the Model Context Protocol specification.
• Unified Reddit API: Abstracts Reddit’s various endpoints into a single, consistent interface.
• Python‑first: Built with modern Python (3.11+) and managed via uv for fast dependency resolution.
• Local development tooling: Built‑in commands for quickly running the inspector and installing the service.
• Extensible tooling list: Detailed tool documentation located in src/universal_mcp_reddit/README.md.

Use cases of Reddit Universal MCP Server

• Chatbot integrations – Enable conversational agents to fetch posts, comments, or submit new content on Reddit without dealing with OAuth flows directly.
• Data aggregation – Collect and normalize Reddit data for analytics dashboards or research pipelines.
• Automation scripts – Automate subreddit moderation, posting schedules, or content curation using a stable API.
• Third‑party app development – Build web or mobile applications that interact with Reddit through a single MCP endpoint.

FAQ from the Reddit Universal MCP Server

Q: Do I need a Reddit API key? A: Yes. The server expects standard Reddit OAuth credentials, which should be placed in a .env file for local development.

Q: Can I run the server in production? A: The repository provides a development‑focused setup, but you can containerize the server or deploy it with any WSGI‑compatible host after configuring environment variables.

Q: How do I add custom tools? A: Extend src/universal_mcp_reddit/app.py with additional MCP‑compatible functions and update the README tool list.

Q: What Python version is required? A: Python 3.11 or newer is recommended.

Q: Is there a Docker image available? A: Not in this repository, but you can create one by installing the project in a Python base image and exposing the inspector port.

Reddit Universal MCP Server

This repository contains an implementation of an Reddit Universal MCP (Model Context Protocol) server. It provides a standardized interface for interacting with Reddit's tools and services through a unified API.

The server is built using the Universal MCP framework.

This implementation follows the MCP specification, ensuring compatibility with other MCP-compliant services and tools.

Usage

You can start using Reddit directly from agentr.dev. Visit agentr.dev/apps and enable Reddit.

If you have not used universal mcp before follow the setup instructions at agentr.dev/quickstart

Available Tools

The full list of available tools is at ./src/universal_mcp_reddit/README.md

Local Development

📋 Prerequisites

Ensure you have the following before you begin:

• Python 3.11+ (recommended)
• uv (install globally with pip install uv)

🛠️ Setup Instructions

Follow the steps below to set up your development environment:

1. Sync Project Dependencies

   uv sync
   

   This installs all dependencies from pyproject.toml into a local virtual environment (.venv).

2. Activate the Virtual Environment

   For Linux/macOS:

   source .venv/bin/activate
   

   For Windows (PowerShell):

   .venv\Scripts\Activate
   

3. Start the MCP Inspector

   mcp dev src/universal_mcp_reddit/server.py
   

   This will start the MCP inspector. Make note of the address and port shown in the console output.

4. Install the Application

   mcp install src/universal_mcp_reddit/server.py
   

📁 Project Structure

.
├── src/
│   └── universal_mcp_reddit/
│       ├── __init__.py       # Package initializer
│       ├── server.py            # Server entry point
│       ├── app.py            # Application tools
│       └── README.md         # List of application tools
├── tests/                    # Test suite
├── .env                      # Environment variables for local development
├── pyproject.toml            # Project configuration
└── README.md                 # This file

📄 License

This project is licensed under the MIT License.

---

Generated with MCP CLI — Happy coding! 🚀