Skip to main content
Glama
reddit-rss-mcp

reddit-rss-mcp

by ninjackster

reddit-rss-mcp

A tiny, dependency-free MCP server that reads Reddit through its still-open RSS feeds. No API key, no OAuth, no scraping service.

Why this exists

As of 2025–2026, Reddit blocks anonymous access to its JSON API at the network-security layer. A plain request to www.reddit.com/r/.../hot.json returns a 403 "blocked by network security" page — and this happens from residential IPs, VPNs, and even commercial residential-proxy scrapers. Self-service API key creation also ended (Responsible Builder Policy, pre-approval now required).

But Reddit's RSS feeds and search RSS still return 200. This server uses only those, so it works with zero credentials, even from a blocked IP.

Related MCP server: reddit-mcp

Tools

Tool

What it does

search_reddit

Search posts (globally or within one subreddit).

browse_subreddit

Fetch a subreddit's posts (hot/new/top/rising/controversial).

get_post_comments

Read the user comments on a post (flat list).

Each returns clean JSON: title, author, link, subreddit, date, and a text excerpt.

Install

Requires Node.js 18+ (uses the built-in fetch). No npm install needed.

Claude Desktop / Claude Code

Add to your MCP config (claude_desktop_config.json, or ~/.claude/settings.json for Claude Code).

Run directly from GitHub (no install step):

{
  "mcpServers": {
    "reddit-rss": {
      "command": "npx",
      "args": ["-y", "github:ninjackster/reddit-rss-mcp"]
    }
  }
}

Or run from a local clone:

{
  "mcpServers": {
    "reddit-rss": {
      "command": "node",
      "args": ["/absolute/path/to/reddit-rss-mcp/server.js"]
    }
  }
}

Restart the app (quit fully, then relaunch) to load the server.

Usage examples

Search r/technology for "local LLM" sorted by new.

Show me the hot posts in r/selfhosted.

Read the comments on this post: https://www.reddit.com/r/technology/comments/abc123/title/

Limitations (RSS, not the API)

  • Comments are flat — no parent/child threading.

  • No scores — RSS carries no upvote/downvote counts.

  • ~25 results per call — RSS feed cap.

For nested comment trees, scores, and unlimited depth you need Reddit's authenticated API (an approved OAuth app). This server is the no-credentials option that covers search, browse, and comment reading.

How it works

It maps tool calls to Reddit RSS endpoints:

  • Browse: https://www.reddit.com/r/<sub>/<sort>.rss

  • Search: https://www.reddit.com/search.rss?q=<q> (add restrict_sr=1 for a single subreddit via /r/<sub>/search.rss)

  • Comments: <post-permalink>.rss

It parses the Atom XML with no external dependencies and speaks MCP over stdio (JSON-RPC 2.0).

License

MIT

Available Tools

3 tools
browse_subredditA

Fetch posts from a subreddit via RSS (no API key). Returns title, author, link, date, excerpt. ~25 results max. No scores or comment trees (RSS limitation). Use "all" or "popular" for cross-Reddit feeds.

Inputs: subreddit (required), sort, time, limit.

get_post_commentsA

Read the user comments on a Reddit post via RSS (no API key). Pass the post URL/permalink. Returns the post plus a FLAT list of comments (author + text). Limitations: not threaded (no parent/child nesting), no upvote scores, ~25 comments max. For full nested trees + scores, use OAuth.

Inputs: url (required), limit.

search_redditA

Search Reddit posts via RSS (no API key). Optionally restrict to one subreddit. Returns title, author, link, subreddit, date, and a text excerpt. ~25 results max. No comment trees or scores (RSS limitation).

Inputs: query (required), subreddit, sort, time, +1 more.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections.

Loading tool schema changelog…

    TDQS

    A4.3/5.0

    Scored across 3 tools

    Disambiguation5/5

    Each tool has a distinct purpose: browsing a subreddit, reading comments on a specific post, and searching across Reddit. No overlap in functionality.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern in snake_case (browse_subreddit, get_post_comments, search_reddit), making them predictable and clear.

    Tool Count4/5

    With only 3 tools, the server feels slightly sparse but is appropriate for its RSS-based scope. Each tool covers a core operation, and adding more would require capabilities beyond RSS.

    Completeness4/5

    The tool set covers the primary Reddit actions achievable via RSS: viewing posts, searching, and reading comments. Missing features like nested comments or scores are acknowledged as RSS limitations, so the surface is reasonable for its domain.

    Maintenance

    ActivityInactive
    ResponsivenessNo recent community issues

    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
      27 PyPI
      3
      -
    • 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.
      70 npm
      2
      MIT
    • A
      license
      Not graded
      quality
      B
      maintenance
      A local, read-only Reddit MCP server that provides tools for searching posts, retrieving posts/comments, subreddit information, and user content via the official Reddit Data API with caching and privacy-focused features.
      -