Skip to main content
Glama
simple-reddit-mcp

simple-reddit-mcp

by ekatiyar

simple-reddit-mcp

PyPI CI

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) or pip

Related MCP server: reddirect

Run it

uvx simple-reddit-mcp

The 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-mcp

or

{
  "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

get_thread

/api/posts/ids + /api/comments/tree

A post plus its comment tree, from any reddit URL or id

get_posts

/api/posts/ids

Bulk post lookup by id (up to 500)

get_comments

/api/comments/ids

Bulk comment lookup by id (up to 500)

search_posts

/api/posts/search

Discovery by subreddit / keyword / author / date range

search_comments

/api/comments/search

Comment-level search; with author= it doubles as user history

search_subreddits

/api/subreddits/search

Find subreddits by name, prefix, size, or age

Not currently implemented:

Tool

Arctic Shift endpoint

search_users

/api/users/search

aggregate_posts / aggregate_comments

/api/{posts,comments}/search/aggregate

time_series

/api/time_series

subreddit_rules

/api/subreddits/rules

subreddit_wiki

/api/subreddits/wikis, /api/subreddits/wikis/list

user_interactions

/api/users/interactions/{users,subreddits}, .../users/list

user_flairs

/api/users/aggregate_flairs

resolve_short_link

/api/short_links

—

/api/subreddits/ids, /api/users/ids

Caveats

  • Read-only. Voting, commenting and posting require Reddit auth

  • score and num_comments are placeholders for ~36h. Arctic Shift archives a post the moment it appears and backfills vote data later, so fresh posts report 1 and 0. Rendered output flags anything under 36h old.

  • Free service = no uptime SLA.

Development

uv sync --group dev
uv run --group dev pytest

To 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 push

Attribution

MIT licensed.

Available Tools

6 tools
get_commentsA
Read-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_postsA
Read-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_threadA
Read-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_commentsA
Read-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_postsA
Read-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_subredditsA
Read-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

    A4.4/5.0

    Scored across 6 tools

    Disambiguation5/5

    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.

    Naming Consistency5/5

    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.

    Tool Count5/5

    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.

    Completeness4/5

    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

    Related MCP Servers

    • A
      license
      B
      quality
      D
      maintenance
      An 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.
      8
      3
      -
    • A
      license
      A
      quality
      D
      maintenance
      Reddit MCP Server — No API Keys Required. Browse, post, comment, vote, and manage your Reddit account from any MCP client.
      20
      5
      MIT
    • A
      license
      A
      quality
      D
      maintenance
      A 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.
      3
      19
      MIT
    • A
      license
      Not graded
      quality
      D
      maintenance
      A 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 npm
      2
      MIT