mcp-reddit

Name: mcp-reddit
Author: wllcnm

@wllcnm

Repository

About mcp-reddit

No overview available yet

#reddit #mcp #ai-assistant

Basic information

Config

Add this server to your MCP-compatible client using the configuration below.

{
  "mcpServers": {
    "mcp-reddit-wllcnm": {
      "command": "docker",
      "args": [
        "run",
        "hello-world"
      ]
    }
  }
}

Tools

No tools detected

We auto-extract tools from the README. The maintainer can list them under a ## Tools heading to populate this section.

Overview

What is mcp-reddit?

mcp-reddit is a Model Context Protocol (MCP) server that enables large language models like Claude to browse and analyze Reddit content. It is designed for developers who want AI assistants to search subreddits, retrieve post details and comments, and fetch hot posts.

How to use mcp-reddit?

Install Docker and obtain Reddit API credentials (client_id, client_secret, user_agent). Configure the server in Claude Desktop by adding a Docker-based mcpServers entry in claude_desktop_config.json. Then use any of the three provided tools (search_subreddit, get_post_details, get_subreddit_hot) in Claude.

Key features of mcp-reddit

Search posts within a specific subreddit
Retrieve detailed post information and comments
Browse hot posts in any subreddit
Runs in Docker for easy deployment
Integrates with Claude via MCP protocol

Use cases of mcp-reddit

Ask Claude to find the latest Python news on Reddit
Have Claude summarize the top comments on a popular post
Let Claude search for troubleshooting advice across multiple subreddits
Automate analysis of subreddit trends for research

FAQ from mcp-reddit

What dependencies does mcp-reddit require?

Docker is mandatory to run the server. For local development, Python 3.12+ and the packages in requirements.txt are needed. Reddit API credentials are always required.

What are the rate limits or usage restrictions?

Reddit API has its own rate limits. The server defaults to returning at most 5 search results and 10 comments per post. These limits are configurable via the limit and comment_limit parameters.

Where does my data live?

All data is fetched from Reddit’s public API in real time. No data is stored locally or on the server; only the API credentials are kept as environment variables.

How do I authenticate with the Reddit API?

You must provide REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, and REDDIT_USER_AGENT as environment variables when running the Docker container. These are obtained from the Reddit app management page.

What transport protocol does the server use?

The server communicates over standard input/output (stdio) inside the Docker container, as is typical for MCP servers. It is designed to be used with Claude Desktop’s MCP client.