reddit-research-agent
Server Configuration
Describes the environment variables required to run the server.
| Name | Required | Description | Default |
|---|---|---|---|
| REDDIT_AUTH_MODE | No | auto, authenticated, or anonymous | auto |
| REDDIT_CLIENT_ID | No | Client id from your Reddit script app | |
| REDDIT_CACHE_SIZE | No | Maximum cached responses | 512 |
| REDDIT_USER_AGENT | No | Override the User-Agent sent to Reddit | |
| REDDIT_MAX_RETRIES | No | Retries on 429 and 5xx | 3 |
| REDDIT_MAX_THREADS | No | Ceiling on threads per research pass | 25 |
| REDDIT_CACHE_TTL_MS | No | Response cache lifetime. 0 disables it | 300000 |
| REDDIT_MAX_COMMENTS | No | Ceiling on comments per thread | 400 |
| REDDIT_CLIENT_SECRET | No | Client secret from the same app | |
| REDDIT_REQUEST_TIMEOUT_MS | No | Per-request deadline | 30000 |
| REDDIT_MIN_REQUEST_INTERVAL_MS | No | Minimum gap between requests | 0 |
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
Features and capabilities supported by this server
Protocol revision2025-11-25
| Capability | Details |
|---|---|
| tools | {
"listChanged": true
} |
Tools
Functions exposed to the LLM to take actions
| Name | Description |
|---|---|
| research_topicA | Run a full Reddit research pass and return the evidence. This is the tool to reach for first. It discovers the relevant subreddits when none are given, searches each one, ranks results by how much discussion they actually hold rather than by upvotes, then pulls comments from the winners. Every item comes back with a permalink. Set includeComments false for a cheap overview of which threads matter before committing context to reading them. |
| harvest_quotesA | Research a topic and return only the quotable sentences, tagged by intent. Use this when the goal is customer language: the exact words people use about a problem, a want, or an objection. Results are verbatim and each carries the permalink of the comment it came from, so every line can be cited. Intents are pain, desire, objection, comparison, recommendation, and question. |
| track_mentionsA | Find where and how a brand, product, or phrase is being mentioned. Returns matching posts with permalinks, plus a breakdown of which communities they came from. Use it to see who is talking about something and where, before deciding which threads to read in full. |
| compare_termsA | Compare how much Reddit discussion several terms attract. Returns post counts, total comments and total upvotes per term, plus each term's share of the group. This measures volume of conversation and nothing else. It is not sentiment, and it is not market share. |
| find_subredditsA | Find the communities where a topic is actually discussed. Merges Reddit's own subreddit search with the communities that recent posts about the topic came from, which surfaces places that never mention the topic in their name. |
| search_redditA | Search Reddit posts, optionally inside one subreddit. By default results are re-ranked so the most discussed threads come first rather than the most upvoted, which is usually what research wants. |
| browse_subredditA | List posts from one subreddit by hot, new, top, rising, or controversial. |
| get_threadA | Read one thread in full: the post and its comments, flattened and sorted by score, each with a permalink. Accepts a Reddit URL, a permalink, or a post id. |
| get_subreddit_infoA | Size, age, activity, and description of one community. Use it to weigh a finding: ten complaints in a 2,000 member subreddit mean something different from ten in a two million member one. |
| get_subreddit_rulesA | The posting rules of a community. Read these before suggesting the user post anything anywhere. Most subreddits ban self-promotion outright. |
| get_user_activityA | A redditor's recent public posts and comments. Use it to weigh a source: someone who only ever posts about one brand reads differently from someone with five years of unrelated history. |
| server_statusA | Check configuration, auth mode, and whether Reddit is answering. Run this first when anything looks broken. It reports which auth mode is in use, whether credentials were accepted, and the result of one live request to Reddit. |
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 12 tools
Most tools are cleanly separated by resource and output type: discovery, search, thread reading, community info, and user activity. The main potential confusion is between track_mentions and search_reddit, and to a lesser extent research_topic and harvest_quotes, but the descriptions give enough context to choose correctly.
The vast majority of tools follow a clear verb_noun pattern such as harvest_quotes, find_subreddits, get_thread, and compare_terms. The only deviation is server_status, which uses a noun phrase instead of an action-oriented name, so consistency is strong but not perfect.
Twelve tools is a well-scoped size for a Reddit research agent. The set covers high-level research entry points, community discovery, search, browsing, thread inspection, user checks, and server diagnostics without feeling bloated or redundant.
The tool surface covers the full research lifecycle: discover subreddits, search and browse posts, read threads, assess community size, check rules, track mentions, and verify server status. There are no obvious dead ends or missing operations for the stated research purpose.