MCP server for multi-pass Reddit research — consensus, dissent, and full thread reading. No API key required.
Project description
reddit-research-mcp
Gives Claude structured access to Reddit discussions — no API key required.
Better than Google's AI overview: multi-pass search, full thread reading, time-aware filtering, explicit counter-evidence surfacing.
Quickstart (uvx — no install needed)
Add to your Claude Code .mcp.json:
{
"mcpServers": {
"reddit-research": {
"command": "uvx",
"args": ["reddit-research-mcp"]
}
}
}
Restart Claude Code. Done.
Quickstart (pip)
pip install reddit-research-mcp
{
"mcpServers": {
"reddit-research": {
"command": "reddit-research-mcp"
}
}
}
Tools
| Tool | What it does |
|---|---|
research_topic |
Multi-pass search, returns verdict + highly-upvoted + controversial posts |
compare |
Side-by-side Reddit sentiment for 2+ subjects |
find_dissent |
Actively surfaces posts that contradict a claim |
get_thread |
Fetches a full thread with top comments |
Output shape
{
"ok": true,
"summary_text": "Reddit is broadly positive on '...' — ...",
"data": {
"verdict": "broadly_positive | broadly_critical | mixed",
"highly_upvoted": [...],
"controversial": [...],
"cited_posts": [...],
"split": { "highly_upvoted": 5, "controversial": 2, "total": 93 }
}
}
Each post: id, title, url, score, upvote_ratio, created_utc, subreddit, flair
Parameters
research_topic(query, since="12m", depth=2)
since:"1m""3m""6m""12m""2y"depth:1= single pass,2= multi-pass (recommended)
Caveats
- No auth required — uses Reddit's public JSON API + Arctic Shift
- Reddit consensus can be confidently wrong on medical, legal, and finance topics
- This tool surfaces what Reddit says, not what is true
Project details
Release history Release notifications | RSS feed
Download files
Download the file for your platform. If you're not sure which to choose, learn more about installing packages.
Source Distribution
Built Distribution
Filter files by name, interpreter, ABI, and platform.
If you're not sure about the file name format, learn more about wheel file names.
Copy a direct link to the current filters
File details
Details for the file reddit_scout_mcp-0.1.0.tar.gz.
File metadata
- Download URL: reddit_scout_mcp-0.1.0.tar.gz
- Upload date:
- Size: 9.9 kB
- Tags: Source
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
0b6a5f0a40f1f702c00a3418814e2f99643f8c4b5c4038838ab69cd13608b948
|
|
| MD5 |
2451b1bd50e0299eca056df44b790e1a
|
|
| BLAKE2b-256 |
f947e9bcce2f61bb24599e08c962795fe4862cc8bb71fe802ae3b3d5e1f7e3c4
|
File details
Details for the file reddit_scout_mcp-0.1.0-py3-none-any.whl.
File metadata
- Download URL: reddit_scout_mcp-0.1.0-py3-none-any.whl
- Upload date:
- Size: 9.4 kB
- Tags: Python 3
- Uploaded using Trusted Publishing? No
- Uploaded via: twine/6.2.0 CPython/3.11.9
File hashes
| Algorithm | Hash digest | |
|---|---|---|
| SHA256 |
f5302c0540e3dffd2c4563d337725f529d3969612627f923228ec2f04d98e92c
|
|
| MD5 |
e615a0ddbdc69b3209d439ab43440844
|
|
| BLAKE2b-256 |
1957229c355966b0b9776485d4c26830465c68f95bccca195ba3e22a4a651a0e
|