Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| REDDIT_CLIENT_ID | Yes | Your Reddit client ID from the app preferences | |
| REDDIT_USER_AGENT | No | Customize user agent (optional) | |
| REDDIT_CLIENT_SECRET | Yes | Your Reddit client secret from the app preferences |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
| get_popular_subreddits | Get list of 25 most popular subreddits. Returns a list of popular subreddits with their subscriber counts. This data is relatively static and ideal for caching. |
| get_server_info | Get information about this Reddit MCP server's capabilities. Returns server version, available tools, and usage examples. |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| discover_reddit_resources | LAYER 1: Discover available Reddit resources and operations. ALWAYS USE THIS FIRST to understand what's available before proceeding. Args: topic: Optional topic to find relevant communities for include_communities: Whether to search for relevant subreddits discovery_depth: Discovery thoroughness - "quick": Single search (faster, 3-5 subreddits) - "comprehensive": Multiple searches (8-15 subreddits for broader perspective) Returns: Available operations, relevant communities, and recommended workflow |
| get_operation_requirements | LAYER 2: Get detailed requirements for a Reddit operation. USE THIS BEFORE EXECUTING to understand parameters, validation rules, and get suggestions. Args: operation_id: The operation ID from discover_reddit_resources context: Optional context about what you're trying to accomplish Returns: Parameter schemas, validation rules, suggestions, and common mistakes to avoid |
| execute_reddit_operation | LAYER 3: Execute a Reddit operation with validated parameters. ONLY USE AFTER getting requirements from get_operation_requirements(). Args:
operation_id: The operation to execute (from Layer 1)
parameters: Parameters matching the schema from Layer 2 Returns: Operation results or detailed error information |