# Reddit MCP > Reddit MCP Server gives your AI client full access to Reddit's community data. Search subreddits, retrieve global trending posts using `list_popular_posts`, and deep-dive into entire comment threads with `get_post_comments`. It lets you analyze social sentiment and monitor niche communities without opening a browser. ## Overview - **Category:** industry-titans - **Price:** Free - **Tags:** reddit, subreddits-api, social-discovery, community-monitoring, trending-posts, comment-analysis, user-profiles, social-intelligence, mcp ## Description You've got your AI client connected to Reddit’s full data stream. This server lets you treat your agent like a dedicated social analyst, pulling in community chatter and trend data without ever opening a web browser. You can analyze niche groups or track global movements using just a few simple commands. ### Finding What's Hot Globally You wanna know what everyone’s talking about? Use `list_popular_posts` to grab a list of posts that are currently racking up votes across the whole platform. If you want to see which communities are gaining traction right now, run `list_trending_subreddits`. You can also get recent content from any specific community by listing all its posts using `list_subreddit_posts`, and you control how it sorts—by time or by score. When you need to find something super specific across Reddit's entire site, use `search_reddit` with a keyword query. If your interest is confined to one sub, limit the search to that single community using `search_subreddit`. ### Digging into Specific Subreddits Before you even read a post, you should know the rules and history of the group. Run `get_subreddit_info` to grab general metadata about any subreddit—you'll see its creation date or what its official description is. For the fine print, use `get_subreddit_rules` to pull those specific community guidelines that everyone has to follow. ### Analyzing Discussions and Content The real juice is in the conversation. When you find a post ID using any of the search tools, pass it over to `get_post`. This function pulls the core details for that single piece of content: its title, who wrote it, and how many upvotes it got. To really analyze sentiment or track key discussion points, use `get_post_comments`. That tool fetches the entire nested thread—every reply, every comment—so your agent can synthesize what people are actually saying about the topic. ### Tracking Users and Profiles You need to know who's driving the conversation. Use `get_user_profile` to retrieve public details on any Reddit account; you’ll get their join date and karma score right there. If you wanna see what that user has been up to recently, run `get_user_comments`. This lists all of their most recent comments across the site. You can also find out about a specific person by listing their most recent activity with `get_user_comments`. This entire setup lets your agent search everything—site-wide using `search_reddit`, or limited to one community via `search_subreddit`. It pulls all the metadata, tracks user history through profile data and comment streams, and gives you access to every single comment chain for deep analysis. You can analyze full conversation threads with `get_post_comments` after grabbing a post's basics using `get_post`. ## Tools ### get_post Retrieves the core details (title, author, upvotes) of one specific Reddit post using its unique ID. ### get_post_comments Fetches the entire nested discussion thread for a given post, allowing you to analyze replies and comments. ### get_subreddit_info Retrieves general metadata about a subreddit, like its creation date or description. ### get_subreddit_rules Pulls the specific community guidelines and rules that apply to a given subreddit. ### get_user_comments Lists the most recent comments made by an individual user across Reddit's platform. ### get_user_profile Retrieves public details about a specific Reddit account, such as join date and karma score. ### list_popular_posts Gets a list of posts that are currently trending or highly upvoted across the entire platform. ### list_subreddit_posts Lists recent posts from a specific subreddit, with options to sort by time or score. ### list_trending_subreddits Returns a list of popular and currently rising subreddits that are gaining attention. ### search_reddit Performs a keyword search across all of Reddit, finding posts matching your query anywhere on the site. ### search_subreddit Limits a search to only pull results from a single, specific subreddit community. ## Prompt Examples **Prompt:** ``` List the hot posts in r/artificialintelligence. ``` **Response:** ``` I've retrieved the hot posts. Currently, the top discussions are about 'New LLM Benchmarks' and 'AI in Robotics'. Would you like me to fetch the comments for any of them? ``` **Prompt:** ``` Show me the top trending posts in r/technology from the past 24 hours. ``` **Response:** ``` Top 5 in r/technology (24h). #1: "OpenAI announces GPT-5 with 10x context window" (23,400 upvotes, 4,567 comments). #2: "EU passes landmark AI regulation framework" (18,200 upvotes, 3,234 comments). #3: "Apple reveals M5 chip benchmarks" (15,800 upvotes, 2,100 comments). #4: "Quantum computing milestone: 1000 logical qubits" (12,400 upvotes, 1,890 comments). #5: "Tesla's new battery tech doubles EV range" (11,200 upvotes, 2,456 comments). Subreddit activity: 12% above average today. ``` **Prompt:** ``` Search r/startups for posts mentioning Series A funding advice from the last month. ``` **Response:** ``` Found 23 relevant posts in r/startups about Series A advice. Most upvoted: "What I wish I knew before our Series A" (2,340 upvotes, detailed founder retrospective). "Series A pitch deck template that raised $12M" (1,890 upvotes, includes template link). "VC red flags during Series A due diligence" (1,456 upvotes). Key themes: unit economics (mentioned 34 times), team composition (28), market timing (22), board structure (18). 3 AMA posts from Series A founders this month. ``` ## Capabilities ### Search and find content across Reddit You ask your AI agent to search the entire platform or a specific subreddit, returning relevant links and discussion summaries. ### Pull community metadata for subreddits The server retrieves detailed information about any given subreddit, including its rules and general status using `get_subreddit_info` and `get_subreddit_rules`. ### Track trending and popular posts You ask the agent to list hot or currently trending content globally or within a specific community, sorting results by popularity or recency. ### Analyze full conversation threads The server fetches entire comment chains for any post, allowing your AI client to perform sentiment analysis and synthesize key discussion points. ### Monitor specific users You get a summary of a user’s public profile details or retrieve a list of their most recent comments on the site. ## Use Cases ### Monitoring product sentiment after a launch. A Product Manager needs to know how users feel about a new feature. They tell their agent: 'Run `search_reddit` for "product name" and "feature X." Then, get the top 3 posts with that keyword using `get_post`, and finally, use `get_post_comments` on those three to summarize user complaints.' The PM gets a bulleted list of actionable feedback in seconds. ### Identifying untapped market opportunities. A Strategy Analyst wants to know what niche markets are growing. They ask the agent to run `list_trending_subreddits`. Seeing a surge in tech subreddits, they follow up by running `get_subreddit_rules` on that new subreddit to understand the community's tone and restrictions. ### Assessing competitor activity. A Marketing Team member suspects a competitor is building buzz. They ask their agent to run `list_popular_posts` across several industry subreddits, looking for repeated mentions of the competitor's name or product category. ### Investigating an influential community voice. A PR specialist needs to vet a key opinion leader. They run `get_user_profile` on the user and then use `get_user_comments` to see their recent activity, checking for consistency or shifts in public tone. ## Benefits - **Deep Comment Analysis:** Stop reading threads manually. Use `get_post_comments` to pull entire comment chains, letting your agent summarize sentiment or extract key themes instantly. - **Targeted Discovery:** Forget scrolling through endless pages. Run a query with `search_reddit` and get structured results for keywords across the whole platform. - **Community Oversight:** Use `get_subreddit_info` to check basic metadata, then use `get_user_profile` to track who the main contributors are in any given community. - **Trend Spotting:** Need to know what's hot right now? Call `list_popular_posts` for global hits or `list_trending_subreddits` to find emerging topics before they blow up. - **Efficiency Gain:** You eliminate context switching. Instead of opening Reddit, running a search, then copying data into Notion, your AI client does all those steps in one conversation turn. ## How It Works The bottom line is, you stop browsing Reddit manually. You just ask your AI client for what you need, and it runs the specific tool call for you. 1. Subscribe to the server and input your Reddit Client ID and Client Secret into Vinkius. 2. Your AI client calls a function, like `search_reddit`, telling it exactly what topic or keyword to find. 3. The agent runs the tool against the Reddit API and returns structured data—whether that's a list of posts or a full comment thread—back to your chat interface. ## Frequently Asked Questions **How do I find what people are talking about in r/technology? (Using search_reddit)** Use `search_subreddit` to limit your search only to that community. You can then refine it by adding keywords, like 'AI regulation,' to narrow the focus and ignore general tech noise. **Can I see how popular posts are across Reddit? (Using list_popular_posts)** Yes, calling `list_popular_posts` gives you a ranked list of trending topics globally. This is great for spotting immediate, high-volume discussions. **What if I want to track a specific user’s history? (Using get_user_comments)** Use `get_user_profile` first to verify the account details. Then, run `get_user_comments` to pull their most recent activity history from anywhere on Reddit. **How do I find out if a subreddit is active? (Using get_subreddit_info)** Run `get_subreddit_info`. This gives you basic metadata—like the creation date and whether it’s pinned to the front page—which helps establish its legitimacy and activity level. **How do I handle authentication when using tools like `get_user_profile`?** You must provide your Reddit Client ID and Client Secret for access. These credentials authenticate your AI agent and grant it the necessary permissions to pull public API data. **When should I use `search_subreddit` versus `search_reddit`?** Use `search_subreddit` when you know the exact community (e.g., r/tech) and want focused results. Use `search_reddit` for broad, global searches across all of Reddit. **Can I use `get_subreddit_rules` to understand a subreddit's policies?** Yes, this tool retrieves the specific rules set by community moderators. It allows your agent to check if content violates guidelines before you analyze it further. **Does the server manage API rate limits when running tools like `get_post_comments` repeatedly?** Yes, the system tracks responses and manages common throttling errors. It handles these limitations so your agent doesn't fail mid-task; it just slows down until you can query again. **Can my AI automatically find the hot posts in a specific subreddit?** Yes! Use the `list_subreddit_posts` tool with the subreddit name and sort set to 'hot'. Your agent will return the trending discussions, including titles, scores, and links in seconds. **How do I get my Reddit Client ID and Client Secret?** Log in to your Reddit account, navigate to **Preferences** > **Apps** (https://www.reddit.com/prefs/apps), and create a new app of type **script** to reveal your credentials.