Skip to main content
Glama

Server Configuration

Describes the environment variables required to run the server.

NameRequiredDescriptionDefault
REDDIT_COOKIENoYour browser's whole cookie: request header for www.reddit.com; enables the live source.
REDDIT_SOURCENoSource selection: auto, live or archive.auto
MCP_AUTH_TOKENNo24+ random characters; required when listening on anything but localhost. The server refuses to start publicly without it.
REDDIT_MCP_PROBESNoJSON list of read-only probes.
REDDIT_USER_AGENTNoUser agent in http mode (browser mode uses Chromium's own).reddit-mcp/0.1 ...
REDDIT_ARCHIVE_URLNoArchive base URL.Arctic Shift
REDDIT_COOKIE_FILENoPath to a file containing the Reddit cookie; enables the live source.
REDDIT_LIVE_CLIENTNobrowser sends reddit.com requests through headless Chromium (needs the browser extra); http uses plain HTTP.http
REDDIT_MCP_TIMEOUTNoRequest timeout in seconds.20
REDDIT_ENABLE_WRITESNoSet to 1 to register the write tools.
REDDIT_MCP_CACHE_TTLNoSeconds to cache identical reads; 0 disables.120
REDDIT_SESSION_STORENoBrowser mode: file that keeps the session across restarts (on a persistent volume).
REDDIT_MCP_LIVE_CHECKNoSet to 0 to skip startup checks.1
REDDIT_WRITE_INTERVALNoMinimum seconds between writes.5
REDDIT_MCP_LIVE_INTERVALNoMinimum seconds between live requests.1.0
REDDIT_WRITE_DAILY_LIMITNoMaximum writes per rolling 24 h; 0 disables the cap.100
REDDIT_MCP_WRITE_SELFTESTNoSet to 1 or full to enable write self-tests.
REDDIT_MCP_ARCHIVE_INTERVALNoMinimum seconds between archive requests.0.5
REDDIT_SESSION_REFRESH_HOURSNoBrowser mode: hours between session keeper visits (0.25 to 168).6
REDDIT_MCP_WRITE_SELFTEST_TARGETNoPost 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

CapabilityDetails
tools
{
  "listChanged": false
}
prompts
{
  "listChanged": false
}
resources
{
  "subscribe": false,
  "listChanged": false
}
experimental
{}

Tools

Functions exposed to the LLM to take actions

NameDescription
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

NameDescription

No prompts

Resources

Contextual data attached and managed by the client

NameDescription

No resources

TDQS

B3.3/5.0

Scored across 9 tools

Disambiguation4/5

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'.

Naming Consistency4/5

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.

Tool Count5/5

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.

Completeness4/5

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.

Maintenance

ActivityMaintained
ResponsivenessNo recent community issues