This MCP server powers Dialog, an AI-driven Reddit intelligence platform for market research, competitive analysis, and customer discovery. It exposes MCP tools for discovering and querying Reddit data across 20,000+ indexed subreddits, retrieving posts and comments, and managing saved feeds for ongoing monitoring. The server supports operations for discovering available MCP operations, inspecting their schemas, and executing operations to produce citations and insights drawn from public Reddit content. You can integrate it with various MCP clients (Claude, OpenAI Codex, Gemini, Cursor, etc.) to run semantic search, sentiment analysis, and trend tracking against Reddit discussions—all without handling Reddit credentials directly.

Prerequisites:

• Python 3.11+ installed on your system
• Access to install Python packages (pip)

Step 1: Set up a Python environment (recommended)

• Install virtualenv if you don't have it: python -m pip install --user virtualenv
• Create and activate a virtual environment: python -m virtualenv venv

  Windows

  venv\Scripts\activate.bat

  macOS/Linux

  source venv/bin/activate

Step 2: Install required runtime (FastMCP-based framework)

• Install the MCP framework library (example, FastMCP/required dependencies): python -m pip install fastmcp

Step 3: Install the reddit_research_mcp package (or ensure it's installed from source)

• If published on PyPI: python -m pip install reddit_research_mcp
• If developing locally, navigate to the project root and install in editable mode: python -m pip install -e .

Step 4: Run the MCP server

• Start the server module as a Python package: python -m reddit_research_mcp

Note: If your project uses a different module name, adjust the -m argument accordingly (e.g., -m reddit_research_mcp). Ensure any required environment variables for authentication or configuration are set as described in additional_notes.

Tips and common issues:

• Python 3.11+ is required; ensure your environment matches this requirement.
• If you see port or binding errors, check for conflicts on the default MCP server port and adjust your client configuration accordingly.
• The server uses Descope OAuth2 for authentication; public Reddit data is accessed, so no Reddit credentials are needed for basic usage. Ensure MCP clients are configured to handle token management as described by your client.
• If you clone the repo or run from source, keep dependencies isolated in a virtual environment to avoid conflicts with system packages.
• When integrating with MCP clients (Claude, Codex, Gemini, etc.), use the recommended add commands shown in the README to connect to the reddit_research_mcp endpoint.
• Capture and preserve citations from Reddit posts/comments for auditability in your reports; verify that your usage complies with Reddit API terms and data usage policies.