reddit-mcp
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| REDDIT_COOKIE | No | Your browser's whole cookie: request header for www.reddit.com; enables the live source. | |
| REDDIT_SOURCE | No | Source selection: auto, live or archive. | auto |
| MCP_AUTH_TOKEN | No | 24+ random characters; required when listening on anything but localhost. The server refuses to start publicly without it. | |
| REDDIT_MCP_PROBES | No | JSON list of read-only probes. | |
| REDDIT_USER_AGENT | No | User agent in http mode (browser mode uses Chromium's own). | reddit-mcp/0.1 ... |
| REDDIT_ARCHIVE_URL | No | Archive base URL. | Arctic Shift |
| REDDIT_COOKIE_FILE | No | Path to a file containing the Reddit cookie; enables the live source. | |
| REDDIT_LIVE_CLIENT | No | browser sends reddit.com requests through headless Chromium (needs the browser extra); http uses plain HTTP. | http |
| REDDIT_MCP_TIMEOUT | No | Request timeout in seconds. | 20 |
| REDDIT_ENABLE_WRITES | No | Set to 1 to register the write tools. | |
| REDDIT_MCP_CACHE_TTL | No | Seconds to cache identical reads; 0 disables. | 120 |
| REDDIT_SESSION_STORE | No | Browser mode: file that keeps the session across restarts (on a persistent volume). | |
| REDDIT_MCP_LIVE_CHECK | No | Set to 0 to skip startup checks. | 1 |
| REDDIT_WRITE_INTERVAL | No | Minimum seconds between writes. | 5 |
| REDDIT_MCP_LIVE_INTERVAL | No | Minimum seconds between live requests. | 1.0 |
| REDDIT_WRITE_DAILY_LIMIT | No | Maximum writes per rolling 24 h; 0 disables the cap. | 100 |
| REDDIT_MCP_WRITE_SELFTEST | No | Set to 1 or full to enable write self-tests. | |
| REDDIT_MCP_ARCHIVE_INTERVAL | No | Minimum seconds between archive requests. | 0.5 |
| REDDIT_SESSION_REFRESH_HOURS | No | Browser mode: hours between session keeper visits (0.25 to 168). | 6 |
| REDDIT_MCP_WRITE_SELFTEST_TARGET | No | Post fullname targeted by the write self-test, e.g. t3_abc123. |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
Read-only access to Reddit. Two sources exist: live reddit.com through the user's logged-in session (only if configured) and the Arctic Shift archive (always available). Every answer starts with the source that produced it and any notes; read the notes, they say when a request was approximated or fell back. The archive only orders posts chronologically and its scores are unreliable for posts under ~36h old. To page, pass next_cursor back unchanged. Collapsed comments show the exact follow-up call (get_comments_by_id or get_comment_thread) to expand them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": false
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| browse_subredditC | List posts in a subreddit. |
| search_postsC | Search posts by keywords, subreddit, author and date range. |
| get_postB | Get a post with its comment tree. |
| get_comment_threadB | Get one comment and the replies under it (expands 'deeper replies'). |
| get_comments_by_idA | Fetch specific comments by id (expands 'more replies collapsed'). |
| get_user_activityB | A user's recent posts and/or comments, newest first. |
| get_subreddit_infoC | Subreddit description, sidebar, subscriber count and creation date. |
| find_subredditsB | Find subreddits by topic (live) or by name prefix (archive). |
| diagnose_liveA | Check how reddit.com answers this server: block page, login recognized, modhash. |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 9 tools
Most tools target clearly different resources: finding subreddits, browsing posts, searching posts, fetching a post, and getting user activity are easy to distinguish. The only mild overlaps are browse_subreddit vs. search_posts (search can filter by subreddit) and the three comment-retrieval tools, but descriptions clarify that get_post returns the tree, get_comment_thread expands deeper replies, and get_comments_by_id expands collapsed 'more replies'.
All tools use snake_case with a leading verb (find_, browse_, search_, get_), which is highly predictable. The minor deviation is diagnose_live, a verb+adjective diagnostic name that doesn't match the verb_noun resource pattern of the rest.
Nine tools is well within the ideal range and each one serves a distinct browsing/retrieval need with no filler. The surface is tightly scoped to Reddit reading and discovery.
For a read-only Reddit client the surface is solid: discovery, browsing, search, post+comment retrieval, comment expansion, and user activity are all present. Minor gaps remain — no user profile/summary tool (only activity), no listing of subreddits a user moderates or subscribes to, and no write operations if those are intended.