# mcp-reddit

FastMCP server — Reddit via `old.reddit.com` JSON endpoints.

## Usage

```
mcp-reddit [--transport TRANSPORT] [--host HOST] [--port PORT]
```

### Options

| Flag | Default | Description |
|------|---------|-------------|
| `--transport` | `stdio` | `stdio`, `http`, `streamable-http`, `sse` |
| `--host` | `0.0.0.0` | Bind address (HTTP transports) |
| `--port` | `8000` | Bind port (HTTP transports) |

### Environment

| Variable | Equivalent |
|----------|------------|
| `MCP_TRANSPORT` | `--transport` |

### Examples

```bash
# Claude Desktop / Codex (stdio)
uvx --from git+https://... mcp-reddit

# Self-hosted Streamable HTTP
mcp-reddit --transport streamable-http --port 8000
# → clients connect to http://host:8000/mcp

# Env-var style
MCP_TRANSPORT=sse mcp-reddit --port 9000
```

## Tools

| Tool | Description |
|------|-------------|
| `reddit_get_posts` | Fetch posts from a subreddit |
| `reddit_search` | Search Reddit (global or scoped) |
| `reddit_get_comments` | Fetch a post and its comment tree |