npm package: @pullapi/reddit-scraper-mcp
Description: Reddit MCP server — posts, comments, subreddits, user profiles & search. For Claude, Cursor & AI agents.
Latest version: 1.0.0

# Reddit Scraper MCP Server

An MCP server that provides real-time Reddit data — posts, comments, subreddit feeds, user profiles, and cross-subreddit search — for use with Claude, Cursor, and other MCP-compatible AI tools.

## Features

- **Get Post** — Get a Reddit post by ID including title, body, score, and metadata
- **Get Comments** — Get comments on a Reddit post with sorting options
- **Get Subreddit** — Get subreddit info and posts from a subreddit
- **Get User** — Get a Reddit user's profile and recent posts
- **Search** — Search Reddit for posts across all subreddits or within a specific one

## Tools

### get_post

Get a Reddit post by ID including title, body, score, and metadata

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `post_id` | string | Yes | Reddit post ID |

### get_comments

Get comments on a Reddit post with sorting options

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `post_id` | string | Yes | Reddit post ID |
| `sort` | string | No | Comment sort order (default: best) — one of: `best`, `top`, `new`, `controversial`, `old` |
| `limit` | number | No | Maximum number of comments (default: 100) |

### get_subreddit

Get subreddit info and posts from a subreddit

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `subreddit` | string | Yes | Subreddit name (without r/) |
| `sort` | string | No | Post sort order (default: hot) — one of: `hot`, `new`, `top`, `rising` |
| `limit` | number | No | Number of posts to return (default: 25) |

### get_user

Get a Reddit user's profile and recent posts

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `username` | string | Yes | Reddit username (without u/) |
| `sort` | string | No | Post sort order (default: new) — one of: `new`, `hot`, `top` |
| `limit` | number | No | Number of posts to return (default: 25) |

### search

Search Reddit for posts across all subreddits or within a specific one

**Parameters:**

| Name | Type | Required | Description |
|------|------|----------|-------------|
| `query` | string | Yes | Search query |
| `sort` | string | No | Sort order (default: relevance) — one of: `relevance`, `hot`, `top`, `new`, `comments` |
| `time_filter` | string | No | Time filter (default: all) — one of: `all`, `year`, `month`, `week`, `day`, `hour` |
| `subreddit` | string | No | Limit search to a specific subreddit |
| `limit` | number | No | Number of results (default: 25) |

## Configuration

Get your API key from [RapidAPI](https://rapidapi.com/pullapi/api).

## Usage with Claude Desktop

Add to your `claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["-y", "@pullapi/reddit-scraper-mcp"],
      "env": {
        "RAPIDAPI_KEY": "your-rapidapi-key"
      }
    }
  }
}
```

## Usage with Cursor

Add to your Cursor MCP settings (`.cursor/mcp.json`):

```json
{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["-y", "@pullapi/reddit-scraper-mcp"],
      "env": {
        "RAPIDAPI_KEY": "your-rapidapi-key"
      }
    }
  }
}
```

## License

MIT