simple-reddit-mcp
This server provides read-only Reddit data via MCP using the Arctic Shift archive, with no account, API key, or browser required.
Get a thread:
get_threadfetches a post and its full comment tree from a URL or ID, with sorting and comment-count controls.Bulk post lookup:
get_postsretrieves metadata for up to 500 posts by ID.Bulk comment lookup:
get_commentsfetches up to 500 comments by ID, useful for expanding collapsed replies.Search posts: Filter by subreddit, author, keyword (title/body), URL prefix, or date range; sort and limit results.
Search comments: Filter by subreddit, author, keyword, post ID, parent comment ID, or date range; also works as a user comment history.
Search subreddits: Find by name, prefix, subscriber count, age, or NSFW status.
Output controls: Support raw JSON, field allowlists, max character budgets, sorting/dating options.
Limitations: all tools are read-only (no voting, posting, or commenting); recent post/comment scores and comment counts under ~36 hours are placeholders; subreddit subscriber counts may lag; the underlying Arctic Shift service has no uptime SLA.
Provides read-only access to Reddit, enabling retrieval and search of posts, comments, and subreddits.
Click on "Deploy Server".
Wait a few minutes for the server to deploy. Once ready, it will show a "Started" state.
In the chat, type
@followed by the MCP server name and your instructions, e.g., "@simple-reddit-mcp show me the latest posts from r/programming"
That's it! The server will respond to your query, and you can continue using it as needed.
Here is a step-by-step guide with screenshots.
simple-reddit-mcp
A read-only Reddit MCP server that needs no Reddit account, no API key, and no browser. It reads threads, comments and subreddits from the Arctic Shift archive over plain keyless HTTP.
One runtime dependency, zeromcp, keeps simple-reddit-mcp lightweight and quick to start.
Requirements
Python 3.11 or newer
uv(recommended) orpip
Related MCP server: reddirect
Run it
uvx simple-reddit-mcpThe server speaks MCP over stdio: JSON-RPC on stdout, logs on stderr.
Configure your MCP client
Claude:
claude mcp add reddit --scope user -- uvx simple-reddit-mcpor
{
"mcpServers": {
"reddit": {
"command": "uvx",
"args": ["simple-reddit-mcp"]
}
}
}Codex — in ~/.codex/config.toml:
[mcp_servers.reddit]
command = "uvx"
args = ["simple-reddit-mcp"]Tools
Implemented:
Tool | Arctic Shift endpoint | Purpose |
|
| A post plus its comment tree, from any reddit URL or id |
|
| Bulk post lookup by id (up to 500) |
|
| Bulk comment lookup by id (up to 500) |
|
| Discovery by subreddit / keyword / author / date range |
|
| Comment-level search; with |
|
| Find subreddits by name, prefix, size, or age |
Not currently implemented:
Tool | Arctic Shift endpoint |
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
|
— |
|
Caveats
Read-only. Voting, commenting and posting require Reddit auth
scoreandnum_commentsare placeholders for ~36h. Arctic Shift archives a post the moment it appears and backfills vote data later, so fresh posts report1and0. Rendered output flags anything under 36h old.Free service = no uptime SLA.
Development
uv sync --group dev
uv run --group dev pytestTo publish a new release to PyPI, bump version and push to master:
uv version --bump patch # bumps pyproject.toml and relocks
git commit -am "release $(uv version --short)"
git pushAttribution
MIT licensed.
Built on
zeromcp(MIT).Data comes from Arctic Shift, a free service; be considerate with it.
Available Tools
6 toolsget_commentsARead-onlyIdempotent
Look up comments in bulk by id.
Use for the comment ids returned inside a [+N more replies] marker, or any
comment permalink you already resolved.
Caveat: Arctic Shift archives posts the moment they appear and backfills vote data after ~36h, so score and num_comments on anything newer than that are placeholders (usually 1 and 0) - never report them as real counts.
Inputs: ids (required), raw, fields, max_chars.
get_postsARead-onlyIdempotent
Look up posts in bulk by id.
Use when you already have post ids (for example from search_comments
results) and want their titles, authors and scores.
Caveat: Arctic Shift archives posts the moment they appear and backfills vote data after ~36h, so score and num_comments on anything newer than that are placeholders (usually 1 and 0) - never report them as real counts.
Inputs: ids (required), raw, fields, max_chars.
get_threadARead-onlyIdempotent
Read a reddit post and its comment tree from any reddit URL or id.
The primary tool: give it whatever the user pasted. Comments come back as an
indented markdown tree; collapsed branches show as [+N more replies].
Caveat: Arctic Shift archives posts the moment they appear and backfills vote data after ~36h, so score and num_comments on anything newer than that are placeholders (usually 1 and 0) - never report them as real counts.
Inputs: url_or_id (required), raw, sort_top, max_chars, +2 more.
search_commentsARead-onlyIdempotent
Find comments by subreddit, author, keyword, post or date range.
With author alone this doubles as user comment history. Comment keyword
search is the slowest endpoint - pair body with a subreddit, an author or a
date range.
Caveat: Arctic Shift archives posts the moment they appear and backfills vote data after ~36h, so score and num_comments on anything newer than that are placeholders (usually 1 and 0) - never report them as real counts.
Inputs: raw, body, sort, after, +8 more.
search_postsARead-onlyIdempotent
Find posts by subreddit, author, keyword or date range.
Keyword parameters (query, title, selftext) are only accepted together
with subreddit or author, and can still time out on very busy ones - a
date range makes them reliable.
Caveat: Arctic Shift archives posts the moment they appear and backfills vote data after ~36h, so score and num_comments on anything newer than that are placeholders (usually 1 and 0) - never report them as real counts.
Inputs: raw, url, sort, after, +9 more.
search_subredditsARead-onlyIdempotent
Find subreddits by name, prefix, subscriber count or age.
Subreddit records are refreshed infrequently, so subscriber counts lag reality by more than the ~36h that applies to posts and comments.
Caveat: Arctic Shift archives posts the moment they appear and backfills vote data after ~36h, so score and num_comments on anything newer than that are placeholders (usually 1 and 0) - never report them as real counts.
Inputs: raw, sort, after, limit, +9 more.
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 6 tools
Each tool targets a distinct operation: get_thread retrieves a single post with its comment tree, get_posts and get_comments handle bulk lookups by ID, and the three search tools query posts, comments, and subreddits respectively. The purposes are clearly separated and the verbose caveats do not create ambiguity.
All tool names follow a consistent 'verb_noun' pattern, using 'get_' for direct ID-based retrieval and 'search_' for query-based discovery. The only minor deviation is 'get_thread' being singular while others are plural, but the pattern is otherwise uniform and predictable.
Six tools is well-scoped for a read-only Reddit client covering posts, comments, and subreddits through both direct access and search. Each tool serves a distinct purpose without unnecessary redundancy, fitting comfortably within the ideal 3-15 range.
The surface covers the core read operations: single-thread retrieval, bulk post/comment fetching, and searching across posts, comments, and subreddits. Minor gaps exist, such as no direct subreddit or user profile endpoint, but search_subreddits and search_comments with author can fill these needs effectively.
Related MCP Connectors
Reddit MCP server: search posts, subreddit feeds, comments & user profiles as JSON. No API key.
Public read-only MCP server for Genvernium product and developer resources.
Real-time Reddit posts, subreddit search, comments & mentions MCP. Local npx or hosted OAuth.
An MCP server that provides read access to your cloud storage providers, bank accounts and more.
Related MCP Servers
- AlicenseBqualityDmaintenanceAn MCP server that provides both read-only and authenticated access to Reddit content and interactions without requiring a developer API key. It enables users to browse posts, search subreddits, and perform write actions like commenting and voting by leveraging browser session cookies.83-
- AlicenseAqualityDmaintenanceReddit MCP Server — No API Keys Required. Browse, post, comment, vote, and manage your Reddit account from any MCP client.205MIT
- AlicenseAqualityDmaintenanceA dependency-free MCP server that reads Reddit through its RSS feeds, enabling search, browsing subreddits, and reading post comments without any API keys or authentication.319MIT
- AlicenseNot gradedqualityDmaintenanceA read-only MCP server that connects to the Reddit Data API to search posts, browse subreddits, read comments, view user profiles, and check trending content through the Model Context Protocol.24 npm2MIT