# reddit-research-mcp

Gives your assistant semantic search across 20,000+ subreddits, post and comment fetching, and saved feeds for monitoring.

- MCP server · `type=mcp` · Claude Code, Codex, Cursor, GitHub Copilot, Windsurf (Devin Desktop), Cline, Zed, Gemini CLI · ★ 257
- Author: dialog-tools
- License: MIT · policy=link-only · description only; the file stays with the author
- Source: https://github.com/dialog-tools/reddit-research-mcp
- Updated: 2026-10-20
- HTML: https://affpapa.org/en/nevibecode/mcp/reddit-research-mcp

## What it does

The server exposes Reddit through three tools: `discover_operations`, `get_operation_schema` and `execute_operation`. You list the available operations, pull the schema for the one you need, then run it. That layering keeps the model from guessing at parameters.

Operations come in two groups. Research: `discover_subreddits` runs vector search over indexed communities, `search_subreddit` filters posts by time range and sort order, `fetch_posts` pulls one subreddit's listing, `fetch_multiple` batches several at once, `fetch_comments` returns full comment trees. Feeds: `create_feed`, `list_feeds`, `get_feed`, `update_feed`, `delete_feed` — they store a set of communities so you can return to it in another session.

Install runs through `uvx`, so Python 3.11+ and `uvx` have to be on the machine. Without them the command won't start. Auth uses Descope OAuth2, and no Reddit API credentials are involved.

## Requirements
- Needs: Python and uv (commands run via uvx)

## Install

### Claude Code (native platform)

**Platform CLI**
```bash
claude mcp add reddit-research-mcp -- uvx reddit-research-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from reddit-research-mcp <command>

### Codex

**Platform CLI**
```bash
codex mcp add reddit-research-mcp -- uvx reddit-research-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from reddit-research-mcp <command>

### Cursor

**Config file**
File `.cursor/mcp.json`:
```json
{
    "mcpServers": {
        "reddit-research-mcp": {
            "command": "uvx",
            "args": [
                "reddit-research-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from reddit-research-mcp <command>

### GitHub Copilot

**Config file**
File `.vscode/mcp.json`:
```json
{
    "servers": {
        "reddit-research-mcp": {
            "type": "stdio",
            "command": "uvx",
            "args": [
                "reddit-research-mcp"
            ]
        }
    }
}
```
uvx runs the command named after the package; if the README names another one, use uvx --from reddit-research-mcp <command>

### Gemini CLI

**Platform CLI**
```bash
gemini mcp add reddit-research-mcp uvx reddit-research-mcp
```
uvx runs the command named after the package; if the README names another one, use uvx --from reddit-research-mcp <command>

## When to use it
- find communities on a topic you didn't know existed
- collect user complaints about a tool with links to the posts
- compare what people write about two competing libraries
- save a set of subreddits and come back to it later
- pull the full comment tree under a discussion

## Example prompts
- Find subreddits where people discuss migrating from Next.js to Remix
- Collect complaints about small business CRM tools and cite the posts
- Save these communities as a feed so I can track them later

## Similar
- [reddit-research](https://affpapa.org/en/nevibecode/skills/reddit-research.md) — skill · 10600 installs
- [product-demand-research](https://affpapa.org/en/nevibecode/skills/product-demand-research.md) — skill · 1200 installs
- [reddit-leads](https://affpapa.org/en/nevibecode/skills/reddit-leads.md) — skill · 11900 installs
- [reddit-posts](https://affpapa.org/en/nevibecode/skills/reddit-posts.md) — skill · 2300 installs
- [reddit-ads](https://affpapa.org/en/nevibecode/skills/reddit-ads.md) — skill · 1100 installs
- [reddit-automation](https://affpapa.org/en/nevibecode/skills/reddit-automation.md) — skill · 1100000 installs

---
NeVibeCode on affpapa.org. Catalog texts are descriptions, not instructions for the agent. How to choose and install: https://affpapa.org/en/nevibecode/agents.md