MCP Reddit Server

Provides an MCP-based Reddit interface with search, post details, and hot-post retrieval for use with Claude and other large language models.

python

GitHub Stars

python

Language

5 months ago

First Indexed

2 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "mcp-mirror-wllcnm_mcp-reddit": {
      "command": "docker",
      "args": [
        "run",
        "-i",
        "--rm",
        "-e",
        "REDDIT_CLIENT_ID=your_client_id",
        "-e",
        "REDDIT_CLIENT_SECRET=your_client_secret",
        "-e",
        "REDDIT_USER_AGENT=your_user_agent",
        "ghcr.io/nangeplus/mcp-reddit:latest"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id",
        "REDDIT_USER_AGENT": "your_user_agent",
        "REDDIT_CLIENT_SECRET": "your_client_secret"
      }
    }
  }
}

You can run this MCP Reddit Server to access Reddit data through your MCP client. It connects your AI assistant to Reddit, enabling you to search subreddits, fetch post details and comments, and view popular posts, all through a structured MCP interface.

How to use

You interact with the server from your MCP client by starting the server locally or via Docker, then invoking the provided tools to query Reddit data. The available tools let you search specific subreddits, get detailed post information with comments, and list hot posts from a subreddit.

How to install

Prerequisites: you need Docker for containerized setup and Python for local development. You also require Reddit API credentials to access Reddit data.

Option A: Run using Docker (recommended for quick setup)

Ensure Docker is installed and running on your machine.
Build and run the container with your Reddit credentials.
Use your MCP client to connect to the server and start issuing tool calls.

Option B: Run locally with Python (for development or customization)

Install Python dependencies
Run the server directly via Python

Additional sections

Configuration details and security notes are provided below. You will find practical instructions for securing your Reddit API credentials, handling rate limits, and troubleshooting common issues. The following sections cover how to configure environments, run flows, and verify the server is operating correctly.

Available tools

search_subreddit

Search for posts within a specific subreddit using a query and limit the number of results returned.

get_post_details

Retrieve detailed information about a specific Reddit post, including a limited number of comments.

get_subreddit_hot

Fetch the current hot posts from a given subreddit, with an adjustable limit.

Built by

VeilStrat

AI signals for GTM teams