Skip to main content

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


Download files

Download the file for your platform. If you're not sure which to choose, learn more about installing packages.

Source Distribution

reddit_scout_mcp-0.1.0.tar.gz (9.9 kB view details)

Uploaded Source

Built Distribution

If you're not sure about the file name format, learn more about wheel file names.

reddit_scout_mcp-0.1.0-py3-none-any.whl (9.4 kB view details)

Uploaded Python 3

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

Hashes for reddit_scout_mcp-0.1.0.tar.gz
Algorithm Hash digest
SHA256 0b6a5f0a40f1f702c00a3418814e2f99643f8c4b5c4038838ab69cd13608b948
MD5 2451b1bd50e0299eca056df44b790e1a
BLAKE2b-256 f947e9bcce2f61bb24599e08c962795fe4862cc8bb71fe802ae3b3d5e1f7e3c4

See more details on using hashes here.

File details

Details for the file reddit_scout_mcp-0.1.0-py3-none-any.whl.

File metadata

File hashes

Hashes for reddit_scout_mcp-0.1.0-py3-none-any.whl
Algorithm Hash digest
SHA256 f5302c0540e3dffd2c4563d337725f529d3969612627f923228ec2f04d98e92c
MD5 e615a0ddbdc69b3209d439ab43440844
BLAKE2b-256 1957229c355966b0b9776485d4c26830465c68f95bccca195ba3e22a4a651a0e

See more details on using hashes here.

Supported by

AWS Cloud computing and Security Sponsor Datadog Monitoring Depot Continuous Integration Fastly CDN Google Download Analytics Pingdom Monitoring Sentry Error logging StatusPage Status page