# Reddit Mcp Server

> MCP server for Reddit — search posts, read comments, and inspect profiles/subreddits. Works with Claude, Cursor, Windsurf, and any MCP client.

- **Type:** MCP server
- **Install:** `agentstack add mcp-shellydeng08-reddit-mcp-server`
- **Verified:** Yes — security-reviewed for prompt injection and unsafe behavior
- **Seller:** [ShellyDeng08](https://agentstack.voostack.com/s/shellydeng08)
- **Installs:** 0
- **Category:** [AI & ML](https://agentstack.voostack.com/c/ai-and-ml)
- **Latest version:** 0.1.0
- **License:** MIT
- **Upstream author:** [ShellyDeng08](https://github.com/ShellyDeng08)
- **Source:** https://github.com/ShellyDeng08/reddit-mcp-server
- **Website:** https://www.npmjs.com/package/reddit-mcp-server

## Install

```sh
agentstack add mcp-shellydeng08-reddit-mcp-server
```

Requires the [AgentStack CLI](https://agentstack.voostack.com/docs/cli). Works with Claude Code, Cursor, and any MCP-compatible agent.

## About

# reddit-connector-mcp

[](https://www.npmjs.com/package/reddit-connector-mcp)
[](https://github.com/ShellyDeng08/reddit-connector-mcp/blob/master/LICENSE)

A [Model Context Protocol (MCP)](https://modelcontextprotocol.io/) server that lets AI assistants browse Reddit. Search posts, read comments, and view user profiles — no API key required.

  

## Features

- **Search Reddit** — search across all of Reddit or within a specific subreddit
- **Browse Subreddits** — get posts sorted by hot, new, top, or rising
- **Read Comments** — fetch full comment threads with nested replies
- **User Profiles** — view karma, account age, and recent activity
- **No API Key Required** — uses Reddit's public JSON API
- **Dual Output** — supports both JSON and Markdown response formats
- **Resilient** — automatic retry with exponential backoff on rate limits

## Quick Start

### Claude Code (CLI)

```bash
claude mcp add reddit -- npx -y reddit-connector-mcp
```

### Claude Desktop

Add to your config (`~/Library/Application Support/Claude/claude_desktop_config.json` on macOS, `%APPDATA%\Claude\claude_desktop_config.json` on Windows):

```json
{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["-y", "reddit-connector-mcp"]
    }
  }
}
```

### Cursor / Windsurf / Other MCP Clients

```json
{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["-y", "reddit-connector-mcp"]
    }
  }
}
```

### Install Globally (Optional)

```bash
npm install -g reddit-connector-mcp
```

## Tools

| Tool | Description |
|------|-------------|
| `reddit_search_posts` | Search for posts across Reddit or within a specific subreddit |
| `reddit_get_subreddit_posts` | Get posts from a subreddit sorted by hot, new, top, or rising |
| `reddit_get_post_comments` | Get comments for a specific Reddit post by URL |
| `reddit_get_user_profile` | Get profile information for a Reddit user |
| `reddit_get_user_posts` | Get recent posts and comments by a Reddit user |

All tools support a `response_format` parameter (`json` or `markdown`).

### Examples

**Search posts:**
```json
{ "query": "machine learning", "subreddit": "programming", "limit": 10 }
```

**Get subreddit posts:**
```json
{ "subreddit": "science", "sort": "top", "limit": 5 }
```

**Get post comments:**
```json
{ "post_url": "https://www.reddit.com/r/programming/comments/abc123/my_post/" }
```

**Get user profile:**
```json
{ "username": "spez" }
```

**Get user posts:**
```json
{ "username": "spez", "limit": 10 }
```

## How It Works

This server uses Reddit's public `.json` endpoints (e.g., `reddit.com/r/programming.json`), which don't require authentication. This means:

- **Zero configuration** — no OAuth, no API keys, no Reddit account needed
- **Rate limited** — ~60 requests/minute (Reddit's unauthenticated limit)
- **Read-only** — browse and search, no posting or voting
- **Automatic retry** — exponential backoff on 429/5xx errors (up to 3 retries)
- **Token-efficient** — text truncated to minimize token usage (25KB max response)

## Development

```bash
git clone https://github.com/ShellyDeng08/reddit-connector-mcp.git
cd reddit-connector-mcp
npm install
npm run build
npm start
```

## License

MIT

## Source & license

This open-source MCP server is cataloged on AgentStack and links to its original source — we do not rehost the code.

- **Author:** [ShellyDeng08](https://github.com/ShellyDeng08)
- **Source:** [ShellyDeng08/reddit-mcp-server](https://github.com/ShellyDeng08/reddit-mcp-server)
- **License:** MIT
- **Homepage:** https://www.npmjs.com/package/reddit-mcp-server

Install and usage instructions live in the source repository linked above.

## Pricing

- **Free** — Free

## Security capabilities

Automated source analysis of v0.1.0 — what this tool can access:

- **Network access:** no
- **Filesystem access:** no
- **Shell / process execution:** no
- **Environment & secrets:** no
- **Dynamic code execution:** no

*"Yes" means the capability is present in the source — more access means more to trust, not that it is unsafe.*


## Versions

- **0.1.0** — security scan: passed — Imported from the upstream source.

## Links

- Listing page: https://agentstack.voostack.com/l/mcp-shellydeng08-reddit-mcp-server
- Seller: https://agentstack.voostack.com/s/shellydeng08
- Browse the marketplace: https://agentstack.voostack.com/browse

---
Listed on AgentStack — the marketplace for AI agent skills and MCP servers. Every listing is security-reviewed. Creators keep 70%.