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
} |
| extensions | {
"io.modelcontextprotocol/ui": {}
} |
| 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 Returns: An object with a 'posts' array. |
| 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) Returns: An object with a 'results' array. |
| 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) Returns: An object with a 'results' array. |
| 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) Returns: An object with an 'items' array of posts and comments. |
| reddit_get_user_postsA | 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 Returns: An object with a 'posts' array. |
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
Most tools are clearly distinct by resource+action (get_post, get_subreddit_posts, search, get_user). The only real overlap is reddit_get_user vs reddit_get_user_posts, where the former returns mixed posts+comments and the latter only submissions; descriptions clarify this but an agent could still misselect when it just wants a user's posts. search vs search_subreddit is well delineated by the subreddit parameter.
All six tools follow a consistent snake_case `reddit_<verb>_<object>` pattern with a uniform server prefix. The verb mix (get/search) is semantically meaningful rather than arbitrary, and qualifiers like _subreddit/_posts/_user_posts read predictably.
Six tools is well-scoped for a read-only Reddit reader: fetching posts, comment trees, searches, and user activity. Each tool maps to a distinct access pattern and none feels redundant padding.
Core read workflows (post detail with comments, subreddit listings, global and scoped search, user activity) are covered. Minor gaps remain: no subreddit metadata/about endpoint, no dedicated user-comments-only retrieval, and no pagination/cursor beyond limits, but agents can work around these via existing tools.