Reddit MCP Server
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| TIMEOUT_SECONDS | No | Request timeout in seconds | 30 |
| REDDIT_CLIENT_ID | Yes | Your Reddit app client ID | |
| REDDIT_USER_AGENT | Yes | User agent string for Reddit API requests (format: Your-App-Name/1.0.0 (by /u/YourUsername)) | |
| REDDIT_OAUTH_SCOPES | No | OAuth scopes for Reddit API access | read submit vote history privatemessages subscribe |
| REDDIT_REDIRECT_URI | No | OAuth2 redirect URI (must match Reddit app configuration exactly) | http://localhost:8080/callback |
| REDDIT_CLIENT_SECRET | Yes | Your Reddit app client secret |
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
Server capabilities have not been inspected yet.
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_subreddit_postsA | š Get posts from a subreddit šÆ What it does: Fetches posts from any Reddit subreddit with sorting options š Required: subreddit name (e.g., 'programming', 'AskReddit', 'MachineLearning') āļø Optional: sort ('hot', 'new', 'top') š” Examples: ā¢ Get hot posts: {"subreddit": "programming"} ā¢ Get new posts: {"subreddit": "AskReddit", "sort": "new"} ā¢ Get top posts: {"subreddit": "MachineLearning", "sort": "top"} š Output: Formatted list with title, author, score, comments, date, and Reddit link |
| search_redditA | š Search Reddit posts and comments šÆ What it does: Searches across Reddit or within a specific subreddit š Required: query (search terms) āļø Optional: subreddit (limit search to specific subreddit) š” Examples: ā¢ Global search: {"query": "machine learning"} ā¢ Subreddit search: {"query": "python tutorial", "subreddit": "programming"} ā¢ Tech search: {"query": "TypeScript", "subreddit": "typescript"} š Output: Formatted search results with title, author, subreddit, score, and link |
| get_user_profileA | š¤ Get Reddit user profile information šÆ What it does: Fetches detailed profile info for any Reddit user š Required: username (Reddit username without u/ prefix) š” Examples: ā¢ Get profile: {"username": "spez"} ā¢ Check user: {"username": "AwkwardTension4482"} ā¢ View profile: {"username": "gallowboob"} š Output: User info with karma, account age, gold status, moderator status, and profile link |
| get_subreddit_infoA | š Get subreddit information šÆ What it does: Fetches detailed info about any Reddit subreddit š Required: subreddit name (without r/ prefix) š” Examples: ā¢ Get info: {"subreddit": "programming"} ā¢ Check subreddit: {"subreddit": "AskReddit"} ā¢ View details: {"subreddit": "MachineLearning"} š Output: Subreddit details with description, subscribers, active users, creation date, NSFW status, and URL |
| get_post_commentsA | š¬ Get comments for a Reddit post šÆ What it does: Fetches comments and replies for any Reddit post š Required: post_id (Reddit post ID, found in post URLs) āļø Optional: sort ('best', 'top', 'new') š” Examples: ā¢ Get comments: {"post_id": "1n1nlse"} ā¢ Best comments: {"post_id": "1n1nlse", "sort": "best"} ā¢ New comments: {"post_id": "1n1nlse", "sort": "new"} š Output: Formatted comment tree with author, score, timestamp, and nested replies |
| get_trending_subredditsA | š„ Get trending/popular subreddits šÆ What it does: Fetches list of currently popular and trending subreddits š Required: None (no parameters needed) š” Examples: ā¢ Get trending: {} ā¢ Simple call: {} š Output: List of trending subreddits with name, title, subscribers, description, and URL |
| get_cross_postsA | š Find crossposts of a Reddit post šÆ What it does: Finds posts that were cross-posted from the original post š Required: post_id (Reddit post ID to find crossposts for) š” Examples: ā¢ Find crossposts: {"post_id": "1n1nlse"} ā¢ Check shares: {"post_id": "1abc123"} š Output: List of crossposts with title, author, subreddit, score, and Reddit link |
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 7 tools
Each tool has a clearly distinct purpose targeting specific Reddit entities or actions: crossposts, post comments, subreddit info, subreddit posts, trending subreddits, user profiles, and search. There is no overlap in functionality, and the descriptions clearly differentiate what each tool does, making misselection unlikely.
All tool names follow a consistent verb_noun pattern using snake_case, starting with 'get_' for retrieval operations or 'search_' for search functionality. This uniformity makes the tool set predictable and easy to understand, with no deviations in naming conventions.
With 7 tools, the count is well-scoped for a Reddit server, covering core read-only operations like fetching posts, comments, subreddits, users, and search. Each tool serves a unique and necessary function without bloat, fitting typical expectations for such a domain.
The tool set provides comprehensive read-only coverage for browsing Reddit content, including posts, comments, subreddits, users, and search. A minor gap exists in write operations (e.g., posting, voting, commenting), but for a retrieval-focused server, the surface is nearly complete and supports common agent workflows without dead ends.