Reddit-Httpx

Complete Reddit API wrapper — 50+ endpoints, async httpx, MCP server, zero PRAW dependency.

---

What it is

Layer	Description
Core	RedditClient — async, typed, 50+ endpoints
MCP Server	32 tools for agents (browse, post, comment, vote, mod)
CLI	reddit-httpx browse, reddit-httpx post, reddit-httpx inbox

Endpoints: Frontpage, Subreddits, Posts, Comments, Users, Messages, Moderation, Search, Wiki, Live, Collections, Awards, Polls, Predictions

---

Quick start

# Install
pipx install reddit-httpx

# Auth (interactive)
reddit-httpx auth login

# Use as library
from reddit_httpx import RedditClient
client = RedditClient()
posts = await client.browse_subreddit("rust", sort="hot", limit=25)

# MCP server for agents
reddit-httpx mcp

---

MCP Tools (32)

Category	Tools
Browse	browse_frontpage, browse_popular, browse_subreddit, get_post, get_comments
Post	submit_text, submit_link, edit_post, delete_post
Comment	comment, reply, edit_comment, delete_comment
Vote	vote_post, vote_comment
Message	get_inbox, send_message, mark_read
User	get_profile, get_karma, get_saved
Mod	mod_approve, mod_remove, mod_lock, mod_sticky
Search	search_posts, search_subreddits, search_users

---

Architecture

┌─────────────────────────────────────────────────────────────┐
│                    RedditClient                               │
├─────────────────────────────────────────────────────────────┤
│  ┌──────────┐  ┌──────────┐  ┌──────────┐  ┌──────────┐     │
│  │  Auth    │  │  Models  │  │  Endpoints│  │  MCP     │     │
│  │  (OAuth) │  │  (Pydantic)│  │  (50+)   │  │  Server  │     │
│  └──────────┘  └──────────┘  └──────────┘  └──────────┘     │
└─────────────────────────────────────────────────────────────┘
                    │
                    ▼
           httpx.AsyncClient
           (connection pool, retry, timeout)

---

Example: Agent browsing Reddit

# Agent uses MCP tools:
# 1. browse_subreddit("MachineLearning", sort="hot", limit=10)
# 2. get_post("t3_abc123") → full post + comments
# 3. search_posts("transformer architecture", subreddit="MachineLearning")
# 4. submit_text("r/MySub", "Title", "Body") — with auth

---

Visual proof

MCP tools	Comment tree	Post detail

Search results	Mod tools	Message inbox

Requirements

• Python 3.11+
• Reddit app credentials (client_id, client_secret)

---

License

MIT — see LICENSE.