reddit_mcp
This server provides tools to read and interact with Reddit data through public JSON endpoints, plus one write action via browser-based authentication.
search_subreddit: Search for posts within a subreddit by keywords, with control over sort order (relevance, hot, top, new), time filter (day, week, month, year, all), and result count (up to 100).get_subreddit_posts: Fetch posts from a subreddit by feed type — hot, new, top, or rising — with a configurable limit (up to 100).get_post_thread: Retrieve a specific post and its top-level comments, with configurable sort order (confidence, top, new, old) and comment count.get_user_profile: Fetch a Reddit user's public profile metadata (karma, account age, etc.).get_user_activity: Fetch a user's recent posts and/or comments, filterable by type (overview, submitted, or comments only), up to 100 items.post_reply: Post a reply to a Reddit thread or comment using an authenticated browser session, given a full Reddit URL or post/comment ID.
Responses are normalized into compact objects and post/comment bodies are trimmed for conciseness. Inputs such as subreddit names, usernames, post IDs, sort values, and limits are validated before requests are made.
Provides tools to query Reddit data (posts, comments, user profiles), search subreddits with filtering and pagination, and post replies using authenticated browser automation.
Click on "Install 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., "@reddit_mcpshow hot posts from r/Python"
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.
Reddit MCP Server
A Model Context Protocol server for reading Reddit data from public JSON endpoints.
What It Does
This codebase currently implements a read-only Reddit server with five MCP tools:
search_subredditget_subreddit_postsget_post_threadget_user_profileget_user_activity
The server does not require Reddit authentication for the implemented tools.
How It Works
Uses
aiohttpfor async HTTP requests to Reddit's public.jsonendpoints.Reuses one shared client session and rotates User-Agent strings per request.
Normalizes Reddit responses into compact post, comment, profile, and activity objects.
Validates subreddit names, usernames, post IDs, sort values, and limits before making a request.
Installation
pip install -e .Requires Python 3.12 or newer.
Run
reddit-mcp-serverOptional transports:
reddit-mcp-server --transport http
reddit-mcp-server --transport sse
reddit-mcp-server --transport streamable-http
reddit-mcp-server --log-level DEBUG
reddit-mcp-server --versionDefault transport is stdio, which is the recommended mode for MCP clients.
MCP Client Configuration
Example configuration:
{
"mcpServers": {
"reddit": {
"command": "reddit-mcp-server",
"args": ["--transport", "stdio"]
}
}
}Tool Summary
Tool | Purpose |
| Search posts within a subreddit by keyword |
| Fetch hot/new/top/rising posts from a subreddit |
| Fetch a post and its top-level comments |
| Fetch a user's public profile metadata |
| Fetch a user's recent posts and/or comments |
Repository Layout
reddit_mcp_server/
├── server.py
├── cli_main.py
├── http_client.py
└── tools/
└── read/
├── __init__.py
├── common.py
├── search_subreddit.py
├── get_subreddit_posts.py
├── get_post_thread.py
├── get_user_profile.py
└── get_user_activity.pyDocumentation
API.mdcontains the parameter and response reference for the implemented tools.
Notes
The server trims long post bodies and comment bodies to keep responses compact for LLM usage.
Resources
Unclaimed servers have limited discoverability.
Looking for Admin?
If you are the server author, to access and configure the admin panel.
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/ajaaysrinivaas/reddit_mcp'
If you have feedback or need assistance with the MCP directory API, please join our Discord server