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 |
Schema
Prompts
Interactive templates invoked by user choice
| Name | Description |
|---|---|
No prompts | |
Resources
Contextual data attached and managed by the client
| Name | Description |
|---|---|
No resources | |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| get_subreddit_posts | 📖 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_reddit | 🔍 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_profile | 👤 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_info | 🏠 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_comments | 💬 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_subreddits | 🔥 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_posts | 🔄 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 |