# Reddit

Six Reddit tools for your agent: hot posts, comment threads, subreddit search, replies, and new posts of your own.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI
- Author: krishnarandad2023
- License: not stated · policy=link-only · description only; the file stays with the author
- Source: https://github.com/krishnarandad2023/mcp-reddit
- Updated: 2026-10-29
- Security check: automated, 2026-11-16 (text) — no signs of malicious code found.
- HTML: https://affpapa.org/en/nevibecode/mcp/krishnarandad2023-reddit

## What it does

Six tools sit behind this server. `fetchPosts` returns a subreddit's hot posts, `getComments` reads a thread by post id, `searchPosts` looks for matches inside one subreddit, `getSubredditInfo` describes it, `postComment` writes a reply, and `postToSubreddit` creates either a text post or a link. Post and search limits run from 1 to 100, ten by default.

The code is a Python server in `src/server.py`, shipped with a Dockerfile. `make build` handles the image on Linux and macOS; on Windows the entry point is `.\build.ps1 build`. You need a real account: register an app at `https://www.reddit.com/prefs/apps`, choose `script` as its type, then pass `REDDIT_CLIENT_ID`, `REDDIT_CLIENT_SECRET`, `REDDIT_USERNAME` and `REDDIT_PASSWORD` into the container as environment variables.

That password travels as a plain environment variable, so give the container its own scope instead of running it next to unrelated projects. `REDDIT_USER_AGENT` is optional and falls back to `mcp-reddit-agent/0.1`.

## Requirements
- Needs: Docker

## Install

### Claude Code (native platform)

**Install**
- The MCP registry has no launch command for it: see the repository README

## When to use it
- pull a subreddit's hot posts before writing a roundup
- read a thread's comments by post id
- search one subreddit for a keyword
- reply to a Reddit post from the agent
- publish a text post or a link to a subreddit

## Example prompts
- Fetch ten hot posts from `technology` with `fetchPosts`.
- Search `programming` for python tutorial and show the first five hits.
- Post to `test` with the title “MCP check” and the body “Written by the agent”.

## Similar
- [reddit-research](https://affpapa.org/en/nevibecode/skills/reddit-research.md) — skill · 13400 installs
- [reddit-posts](https://affpapa.org/en/nevibecode/skills/reddit-posts.md) — skill · 2400 installs
- [reddit-ads](https://affpapa.org/en/nevibecode/skills/reddit-ads.md) — skill · 1200 installs
- [reddit-automation](https://affpapa.org/en/nevibecode/skills/reddit-automation.md) — skill · 1500000 installs
- [content-distribution-mcp](https://affpapa.org/en/nevibecode/mcp/content-distribution-mcp.md) — MCP server · 252 installs
- [last30](https://affpapa.org/en/nevibecode/skills/last30.md) — skill · ★ 797 repo stars

## Other versions with the same name
- [reddit · ](https://affpapa.org/en/nevibecode/mcp/reddit.md) — 333 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md
