Skip to main content

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

Metadata

Release files for reddit-scout-mcp 0.1.0

For a detailed explanation of source distributions (sdists) and built distributions (wheels), please see the package formats documentation.

Source distribution (sdist)

Source distribution for reddit-scout-mcp 0.1.0
File Size Uploaded Provenance Actions
reddit_scout_mcp-0.1.0.tar.gz 9.9 kB Without provenance Details for reddit_scout_mcp-0.1.0.tar.gz

Built distribution (wheel)

Table of built distributions (wheels) for reddit-scout-mcp 0.1.0
File Interpreter ABI Platform Actions
reddit_scout_mcp-0.1.0-py3-none-any.whl Python 3 none any Details for reddit_scout_mcp-0.1.0-py3-none-any.whl

Total release size: 19.2 kB

Release files / reddit_scout_mcp-0.1.0.tar.gz

Download URL reddit_scout_mcp-0.1.0.tar.gz
Size 9.9 kB
Tags Source
SHA-256 checksum
How to use checksums
0b6a5f0a40f1f702c00a3418814e2f99643f8c4b5c4038838ab69cd13608b948
BLAKE2b-256 checksum
How to use checksums
f947e9bcce2f61bb24599e08c962795fe4862cc8bb71fe802ae3b3d5e1f7e3c4
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.9

Release files / reddit_scout_mcp-0.1.0-py3-none-any.whl

Download URL reddit_scout_mcp-0.1.0-py3-none-any.whl
Size 9.4 kB
Tags Python 3
SHA-256 checksum
How to use checksums
f5302c0540e3dffd2c4563d337725f529d3969612627f923228ec2f04d98e92c
BLAKE2b-256 checksum
How to use checksums
1957229c355966b0b9776485d4c26830465c68f95bccca195ba3e22a4a651a0e
Upload date
Uploaded using Trusted Publishing?
What is trusted publishing?
No
Uploaded via twine/6.2.0 CPython/3.11.9

Security for reddit-scout-mcp 0.1.0

Provenance

Provenance describes where a file came from. On PyPI, provenance is shared via attestations, which provide a verifiable record of the build or publishing details. View details, limitations and caveats.

No provenance found

None of the files in this release were uploaded with provenance metadata.

A note on package security

PyPI is a repository for distributing packages, not a service for auditing them. While third-party security researchers and our staff do their best to detect and remove malicious packages, PyPI cannot guarantee the quality, security or suitability of any given package.

To learn more about protecting yourself from malicious actors, visit our package security documentation.

Release history Release notifications | RSS feed

This release

0.1.0 This release

2 release files No provenance

Anthropic, PBC Visionary sponsor Bloomberg Visionary sponsor Hudson River Trading Visionary sponsor Meta Visionary sponsor NVIDIA Visionary sponsor Microsoft Sustainability sponsor Depot Continuous Integration AWS Cloud computing and Security Sponsor Datadog Monitoring Fastly CDN Google Download Analytics Sentry Error logging StatusPage Status page