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 |
Capabilities
Features and capabilities supported by this server
| 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_post | 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_posts | 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_search | 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_subreddit | 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_user | 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_posts | 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 | |