mcp-reddit
Fetch posts from subreddits, search Reddit globally or scoped, and retrieve posts with their comment trees via Reddit's JSON endpoints.
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., "@mcp-reddit show top posts from r/MachineLearning"
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.
mcp-reddit
FastMCP server — Reddit via old.reddit.com JSON endpoints.
Usage
mcp-reddit [--transport TRANSPORT] [--host HOST] [--port PORT]Options
Flag | Default | Description |
|
|
|
|
| Bind address (HTTP transports) |
|
| Bind port (HTTP transports) |
Environment
Variable | Equivalent |
|
|
Examples
# Claude Desktop / Codex (stdio)
uvx --from git+https://... mcp-reddit
# Self-hosted Streamable HTTP
mcp-reddit --transport streamable-http --port 8000
# → clients connect to http://host:8000/mcp
# Env-var style
MCP_TRANSPORT=sse mcp-reddit --port 9000Related MCP server: reddit-rss-mcp
Tools
Tool | Description |
| Fetch posts from a subreddit |
| Search Reddit (global or scoped) |
| Fetch a post and its comment tree |
Available Tools
3 toolsreddit_get_commentsA
Fetch a post and its comment tree using old.reddit.com .json endpoints
Inputs: shortcode (required), sort, limit. Returns: object
reddit_get_postsA
Fetch posts from a subreddit using old.reddit.com .json endpoints
Inputs: subreddit (required), sort, limit, time_filter. Returns: result
reddit_searchC
Search Reddit using old.reddit.com .json endpoints
Inputs: query (required), sort, limit, subreddit, +1 more. Returns: result
Tool Schema Changelog
Recent tool additions, removals, and schema changes observed during successful MCP inspections.
Loading tool schema changelog…
TDQS
Scored across 3 tools
Each tool serves a distinct purpose: fetching subreddit posts, fetching comments for a specific post, and searching Reddit. There is no overlap or ambiguity between them.
All tools share the reddit_ prefix, and two use verb_noun (get_posts, get_comments). The third, reddit_search, deviates slightly by using a bare verb, but the pattern is still clear and predictable.
Three tools is a well-scoped set for a Reddit reading server, covering core read operations without unnecessary bloat.
The server covers the primary read workflows: viewing posts, viewing comments, and searching. Minor gaps like fetching a specific post by ID or user profiles could be added, but the core domain is adequately covered.
Maintenance
Related MCP Connectors
Reddit MCP server: search posts, subreddit feeds, comments & user profiles as JSON. No API key.
Real-time Reddit posts, subreddit search, comments & mentions MCP. Local npx or hosted OAuth.
Reddit MCP — public Reddit data via the Atom/RSS feeds.
MCP server for siGit (sigit.si): browse repos, search code, manage PRs/issues, web search.
Related MCP Servers
- 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 gradedqualityBmaintenanceA 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.-
- AlicenseNot gradedqualityBmaintenanceMCP server for Reddit data — subreddits, users, search, live comments. No OAuth required.MIT