@karanb192/reddit-buddy-mcp
Advanced tools
Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.
A Model Context Protocol (MCP) server that enables Claude Desktop and other AI assistants to browse Reddit, search posts, and analyze user activity. Clean, fast, and actually works - no API keys required.
Add this to your claude_desktop_config.json:
{
"mcpServers": {
"reddit": {
"command": "npx",
"args": ["@karanb192/reddit-buddy-mcp"]
}
}
}
That's it! Reddit Buddy is now available in Claude.
Ask your AI assistant to:
browse_subredditBrowse posts from any subreddit with sorting options.
- Subreddit:
- "all" - entire Reddit frontpage
- "popular" - trending across Reddit
- Any specific subreddit (e.g., "technology", "programming", "science")
- Sort by: hot, new, top, rising, controversial
- Time range: hour, day, week, month, year, all (for top/controversial sort)
- Include subreddit info: Optional flag for subreddit metadata
search_redditSearch across Reddit or specific subreddits.
- Query: Your search terms
- Filter by: subreddit, author, time, flair
- Sort by: relevance, hot, top, new, comments
get_post_detailsGet a post with all its comments.
- Input:
- Reddit URL (full URL including subreddit), OR
- Post ID alone (will auto-detect subreddit, 2 API calls), OR
- Post ID + subreddit (most efficient, 1 API call)
- Options: comment sorting, depth, link extraction
user_analysisAnalyze a Reddit user's profile.
- Username: Any Reddit user
- Returns: karma, posts, comments, active subreddits
reddit_explainGet explanations of Reddit terms.
- Terms: karma, cake day, AMA, ELI5, etc.
Want 10x more requests? Add Reddit credentials:
.env:REDDIT_CLIENT_ID=your_client_id
REDDIT_CLIENT_SECRET=your_client_secret
REDDIT_USER_AGENT=YourApp/1.0
{
"mcpServers": {
"reddit": {
"command": "npx",
"args": ["reddit-buddy-mcp"],
"env": {
"REDDIT_CLIENT_ID": "your_client_id",
"REDDIT_CLIENT_SECRET": "your_client_secret",
"REDDIT_USER_AGENT": "YourApp/1.0"
}
}
}
}
To test the server directly in your terminal:
# Run in HTTP mode on port 3000
npx @karanb192/reddit-buddy-mcp --http
# Or with custom port
REDDIT_BUDDY_PORT=8080 npx @karanb192/reddit-buddy-mcp --http
Note: The server runs in stdio mode by default (for Claude Desktop). Use --http flag for testing with Postman MCP or direct API calls.
npm install -g @karanb192/reddit-buddy-mcp
reddit-buddy --http # For testing
git clone https://github.com/karanb192/reddit-buddy-mcp.git
cd reddit-buddy-mcp
npm install
npm run build
npm link
docker run -it karanb192/reddit-buddy-mcp
| Feature | Reddit Buddy | Other MCP Tools |
|---|---|---|
| Zero Setup | ✅ Works instantly | ❌ Requires API keys |
| Language | TypeScript/Node.js | Python (most) |
| Tools Count | 5 (focused) | 8-10 (redundant) |
| Fake Metrics | ✅ Real data only | ❌ "Sentiment scores" |
| Search | ✅ Full search | Limited or none |
| Caching | ✅ Smart caching | Usually none |
| LLM Optimized | ✅ Clear params | Confusing options |
| Mode | Requests/Minute | Cache TTL |
|---|---|---|
| Anonymous | 10 | 15 min |
| Authenticated | 100 | 5 min |
"What are the top posts about GPT-4 today?"
→ search_reddit with query="GPT-4", time="day", sort="top"
"Show me what's trending in technology"
→ browse_subreddit with subreddit="technology", sort="hot"
"What do people think about this article?"
→ search_reddit with the article URL to find discussions
"Analyze the user DeepFuckingValue"
→ user_analysis with username="DeepFuckingValue"
"Get the comments from this Reddit post"
→ get_post_details with url="https://reddit.com/r/..."
"What's trending across all of Reddit?"
→ browse_subreddit with subreddit="all", sort="hot"
"Command not found" error
# Ensure npm is installed
node --version
npm --version
# Try with full npx path
$(npm bin -g)/reddit-buddy-mcp
Rate limit errors
"Subreddit not found"
Connection issues
| Variable | Description | Required | Default |
|---|---|---|---|
REDDIT_CLIENT_ID | Reddit app client ID | No | - |
REDDIT_CLIENT_SECRET | Reddit app secret | No | - |
REDDIT_USER_AGENT | User agent string | No | RedditBuddy/1.0 |
REDDIT_BUDDY_HTTP | Run as HTTP server | No | false |
REDDIT_BUDDY_NO_CACHE | Disable caching (always fetch fresh) | No | false |
Reddit Buddy includes intelligent caching to improve performance and reduce API calls:
This means faster responses and staying well within Reddit's rate limits, all while using minimal system resources.
# Install dependencies
npm install
# Run in development
npm run dev
# Build
npm run build
# Test
npm test
# Lint
npm run lint
# Type check
npm run typecheck
PRs welcome! See CONTRIBUTING.md for guidelines.
We keep things simple:
MIT - Use it however you want!
Made with ❤️ for the MCP community. No venture capital, no tracking, just a good MCP server.
FAQs
Clean, LLM-optimized Reddit MCP server. Browse posts, search content, analyze users. No fluff, just Reddit data.
We found that @karanb192/reddit-buddy-mcp demonstrated a healthy version release cadence and project activity because the last version was released less than a year ago. It has 1 open source maintainer collaborating on the project.
Did you know?
Socket for GitHub automatically highlights issues in each pull request and monitors the health of all your open source dependencies. Discover the contents of your packages and block harmful activity before you install or update your dependencies.
Security News
A misconfiguration gave three Anthropic models internet access, and one, believing it was in a simulation, shipped a credential-stealing package to PyPI.
Security News
/Company News
Socket has joined the new Composer and Packagist sponsorship program as a launch sponsor, supporting the team that keeps PHP's package ecosystem secure.
Research
/Security News
Benign-looking npm packages split malicious functionality across a dependency chain that deploys a cross-platform RAT targeting Alibaba developers.