# @sylvia/reddit-mcp

MCP server for Reddit data — subreddits, users, search, live comments. **No OAuth required.**

## Install

```bash
npx @sylvia/reddit-mcp
```

Or install globally:

```bash
npm install -g @sylvia/reddit-mcp
sylvia-mcp
```

## Quick Start

1. Get an API key at [sylvia-api.com](https://sylvia-api.com) (free tier: 480 req/min, $0.50 credit)
2. Set environment variable:

```bash
export SYLVIA_API_KEY=your_key_here
```

3. Run the server:

```bash
npx @sylvia/reddit-mcp
```

## Claude Desktop Config

Add to `~/Library/Application Support/Claude/claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "sylvia-reddit": {
      "command": "npx",
      "args": ["@sylvia/reddit-mcp"],
      "env": {
        "SYLVIA_API_KEY": "your_key_here"
      }
    }
  }
}
```

## Available Tools (26)

| Tool | Description |
|------|-------------|
| `subreddit_about` | Get metadata about a subreddit |
| `subreddit_posts` | Get post listings (hot, new, top, rising) |
| `subreddit_comments_live` | Real-time comment stream for a subreddit |
| `user_about` | Get Reddit user profile metadata |
| `user_posts` | Get user's recent post history |
| `user_comments` | Get user's recent comment history |
| `user_overview` | Get combined activity feed (posts + comments) |
| `submission` | Fetch a single Reddit post by URL |
| `comment` | Fetch a single Reddit comment by URL |
| `thread` | Get fully resolved thread with all nested comments |
| `search` | Global keyword search across all subreddits |
| `search_advanced` | Advanced search with subreddit filter & NSFW toggle |
| `comments_live` | Global comment firehose across all of Reddit |
| `subreddit_rules` | Get subreddit rules list |
| `subreddit_moderators` | Get subreddit moderator list |
| `subreddit_sticky` | Get stickied/pinned posts |
| `subreddit_wiki` | Get a subreddit wiki page |
| `subreddit_wiki_pages` | List all wiki pages in a subreddit |
| `subreddit_sidebar` | Get subreddit sidebar content |
| `domain` | Get all posts linking to a specific domain |
| `duplicates` | Get crosspost duplicates of a submission |
| `subreddits` | Get subreddit listings by category |
| `subreddits_search` | Search subreddits by name/description |
| `subreddit_autocomplete` | Autocomplete subreddit names |
| `by_id` | Bulk lookup by fullnames (t3_abc, t1_def) |

## API Key

Get your free API key at [sylvia-api.com](https://sylvia-api.com/login). Free tier includes 480 requests/minute with $0.50 starting credit.

## Data Layer

Data layer: [Sylvia API](https://sylvia-api.com) — no OAuth Reddit data.

## License

MIT © 2026 Sylvia API