reddit -buddy

Reddit MCP Buddy is an MCP server that lets Claude Desktop and other AI assistants browse Reddit, search posts, and analyze user activity without requiring a separate API key setup. It exposes a set of tools designed for conversational querying: browse_subreddit to fetch posts from any subreddit with sorting and time options; search_reddit to query across Reddit with filters; get_post_details to retrieve a post along with its full comment thread; user_analysis to inspect a user’s karma, posts, and activity history; and reddit_explain to clarify common Reddit terms. To use it, install the MCP server (via npx as shown below) and configure it in your Claude Desktop or MVP MCP client configuration. Once registered, you can ask your AI assistant questions like “What’s trending on Reddit right now?” or “Show me discussions about AI,” and the assistant will invoke these tools to fetch and present results from Reddit.

In Claude Desktop or other MCP clients, you typically enable the server with a command like npx -y reddit-mcp-buddy and then reference the server in your mcp configuration. If you need authentication, you can supply Reddit credentials via environment variables in the config (client ID, client secret, username, and password). The tools are designed to be fast and privacy-conscious, using Reddit’s public data where possible and handling authentication tiers to respect rate limits.

Prerequisites:\n- Node.js and npm installed on your system (recommended: latest LTS release).\n- Optional: Docker if you prefer running via container.\n\nInstallation options:\n1) Global Install (recommended for quick setup):\n\n npm install -g reddit-mcp-buddy ````\nThis makes the command reddit-mcp-buddy and npx reddit-mcp-buddy available system-wide. You can then configure your MCP client to use npx -y reddit-mcp-buddy as shown in the Quick Start.\n\n2) From Source (for development or contribution):\n\n git clone https://github.com/karanb192/reddit-mcp-buddy.git cd reddit-mcp-buddy npm install npm run build (if provided in repo) or npm run start

Follow the repository’s README for any project-specific build steps.\n\n3) Using Docker (if supported by the project):\n\n```
docker pull karanb192/reddit-mcp-buddy

Then run with your preferred docker invocation, e.g.,\n``` docker run -it --rm karanb192/reddit-mcp-buddy

\nPrerequisites summary: ensure Node.js and npm are installed for npm-based setups, or use Docker if you prefer containerized execution.

Tips and caveats:\n- Authentication: If you plan to use the higher rate limits (App-Only or Authenticated), supply Reddit credentials via environment variables (REDDIT_CLIENT_ID, REDDIT_CLIENT_SECRET, REDDIT_USERNAME, REDDIT_PASSWORD). The server supports three levels: Anonymous (no credentials), App-Only (client ID/secret), and Authenticated (username/password). Script apps with a user/password setup provide the highest throughput.\n- Caching: Reddit API responses may be memo-cached to improve performance; this can affect real-time data freshness for very fast-moving topics.\n- Privacy: Credentials are stored locally only if you opt to save them; environment variables are not persisted by default. Be mindful of where you run the MCP server on shared machines.\n- Tools usage: Use browse_subreddit to fetch posts with options like sort and time; use get_post_details to fetch a post with full comments; use user_analysis to inspect user activity.\n- If you encounter 429 rate-limit errors, switch to Anonymous or App-Only mode, or stagger requests to respect the server’s rate limits.\n- For Claude Desktop, you can embed this MCP server in claude_desktop_config.json under mcpServers and optionally include env in the server entry if your client supports it.