Reddit MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| REDDIT_HOST | No | Host for HTTP transport | 127.0.0.1 |
| REDDIT_PATH | No | Path for HTTP transport | /mcp |
| REDDIT_PORT | No | Port for HTTP transport | 8000 |
| REDDIT_PROXY | No | HTTP/HTTPS proxy URL | |
| REDDIT_TIMEOUT | No | Request timeout in seconds | 10.0 |
| REDDIT_LOG_LEVEL | No | Log level (DEBUG, INFO, WARNING, ERROR) | WARNING |
| REDDIT_TRANSPORT | No | MCP transport (stdio, streamable-http) | stdio |
| REDDIT_THROTTLE_MAX | No | Max delay between paginated requests (seconds) | 2.0 |
| REDDIT_THROTTLE_MIN | No | Min delay between paginated requests (seconds) | 1.0 |
Instructions
Guidance the server publishes about itself, which clients place ahead of the tool catalog so the model reads it before choosing anything.
This server publishes no instructions, or was last inspected before Glama recorded them.
Capabilities
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
| prompts | {
"listChanged": false
} |
| resources | {
"subscribe": false,
"listChanged": false
} |
| experimental | {} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| reddit_get_postB | Get full details of a Reddit post including its comment tree. Args: permalink: Reddit permalink path (e.g., '/r/Python/comments/abc123/my_post/') |
| reddit_get_subreddit_postsA | Get posts from a subreddit listing. Args: subreddit: Subreddit name without r/ prefix (e.g., 'Python', 'news') limit: Maximum number of posts (default: 25, max: 100) category: Listing category (hot, top, new, rising). Default: hot time_filter: Time window for top listings (hour, day, week, month, year, all). Default: all |
| reddit_searchA | Search all of Reddit for posts matching a query. Args: query: Search keywords (e.g., 'python web scraping', 'machine learning') limit: Maximum number of results to return (default: 25, max: 100) sort: Sort order for results (relevance, hot, top, new, comments) |
| reddit_search_subredditA | Search within a specific subreddit. Args: subreddit: Subreddit name without r/ prefix (e.g., 'Python', 'MachineLearning') query: Search keywords limit: Maximum number of results to return (default: 25, max: 100) sort: Sort order for results (relevance, hot, top, new, comments) |
| reddit_get_userA | Get a Reddit user's recent public activity (posts and comments). Args: username: Reddit username without u/ prefix (e.g., 'spez', 'GallowBoob') limit: Maximum number of activity items (default: 25, max: 100) |
| reddit_get_user_postsB | Get a Reddit user's submitted posts. Args: username: Reddit username without u/ prefix (e.g., 'spez') limit: Maximum number of posts (default: 25, max: 100) category: Listing category (hot, top, new). Default: new time_filter: Time window for top listings (hour, day, week, month, year, all). Default: all |
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
TDQS
Scored across 6 tools
The tools have clear distinctions between post retrieval, subreddit listing, user activity, and search operations, but there is some overlap between reddit_get_user and reddit_get_user_posts, as the former includes both posts and comments while the latter is a subset. This could cause confusion about which to use for specific user post queries.
All tool names follow a consistent reddit_verb_noun pattern with snake_case throughout, such as reddit_get_post, reddit_get_subreddit_posts, and reddit_search_subreddit. This predictability makes it easy for agents to understand and navigate the toolset.
With 6 tools, the server is well-scoped for a Reddit API, covering key functionalities like retrieving posts, subreddit content, user data, and search operations. This count is neither too sparse nor overwhelming, fitting typical use cases effectively.
The toolset covers essential read operations for posts, subreddits, users, and search, with good parameter support. However, it lacks write or interaction capabilities (e.g., posting, commenting, voting), which are common in Reddit workflows, leaving minor gaps that agents might need to work around.