Skip to main content
Glama
ekatiyar

simple-reddit-mcp

by ekatiyar

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, making simple-reddit-mcp lightweight and quick to startup

Requirements

  • Python 3.11 or newer

  • uv (recommended) or pip

Related MCP server: reddirect

Run it

# from a clone of this repo
uv run simple-reddit-mcp

# from a local checkout, without installing anything
uvx --from /path/to/simple-reddit-mcp simple-reddit-mcp

# with pip
pip install -e . && simple-reddit-mcp

The server speaks MCP over stdio: JSON-RPC on stdout, logs on stderr.

Configure your MCP client

Example for Claude:

{
  "mcpServers": {
    "reddit": {
      "command": "uvx",
      "args": ["--from", "/absolute/path/to/simple-reddit-mcp", "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

Attribution

MIT licensed.

A
license - permissive license
-
quality - not tested
C
maintenance

Maintenance

Maintainers
Response time
Release cycle
Releases (12mo)
Commit activity

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Servers

  • A
    license
    B
    quality
    C
    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
    1
    The Unlicense
  • A
    license
    A
    quality
    C
    maintenance
    Reddit MCP Server — No API Keys Required. Browse, post, comment, vote, and manage your Reddit account from any MCP client.
    20
    2
    MIT
  • A
    license
    A
    quality
    C
    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
    9
    10
    MIT
  • A
    license
    -
    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.
    8
    1
    MIT

View all related MCP servers

Related MCP Connectors

  • Reddit MCP — public Reddit data via JSON endpoints (no auth required)

  • Lemmy MCP — public reads on any Lemmy instance.

  • Official remote MCP server for Archivist AI TTRPG campaign memory: characters, sessions, and more.

View all MCP Connectors

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/ekatiyar/simple-reddit-mcp'

If you have feedback or need assistance with the MCP directory API, please join our Discord server