# Reddit MCP Server

A Model Context Protocol (MCP) server for accessing Reddit content directly in Claude. **No API keys required** - works with anonymous Reddit access!

## Features

- Get hot, new, top, and rising posts from any subreddit
- Fetch subreddit information
- Get detailed post content with comments
- Full comment tree traversal
- Support for all post types (text, links, galleries)

## Installation

1. Ensure you have Python 3.11+ installed
2. Clone or download this repository
3. Update your Claude Desktop config at `~/.claude_desktop_config.json`:

```json
{
  "mcpServers": {
    "reddit": {
      "command": "uv",
      "args": ["run", "--with-requirements", "requirements.txt", "python3", "/path/to/mcp-reddit/main.py"],
      "cwd": "/path/to/mcp-reddit"
    }
  }
}
```

Replace `/path/to/mcp-reddit` with your actual path.

4. Restart Claude Desktop

That's it! No authentication needed.

## Available Tools

### `get_frontpage_posts`
Get hot posts from Reddit's frontpage
- **limit** (int, default: 10): Number of posts to fetch

### `get_subreddit_info`
Get information about a subreddit
- **subreddit_name** (string, required): Name of the subreddit (e.g., "python")

### `get_subreddit_hot_posts`
Get hot posts from a specific subreddit
- **subreddit_name** (string, required): Name of the subreddit
- **limit** (int, default: 10): Number of posts

### `get_subreddit_new_posts`
Get newest posts from a subreddit
- **subreddit_name** (string, required)
- **limit** (int, default: 10)

### `get_subreddit_top_posts`
Get top posts from a subreddit (filtered by time period)
- **subreddit_name** (string, required)
- **limit** (int, default: 10)
- **time** (string, default: ""): hour, day, week, month, year, or all

### `get_subreddit_rising_posts`
Get rising posts from a subreddit
- **subreddit_name** (string, required)
- **limit** (int, default: 10)

### `get_post_content`
Get detailed content of a specific post with comments
- **post_id** (string, required): Reddit post ID
- **comment_limit** (int, default: 10): Number of top comments
- **comment_depth** (int, default: 3): How deep to traverse comment threads

### `get_post_comments`
Get comments from a post
- **post_id** (string, required)
- **limit** (int, default: 10)

## Usage Examples

Once configured in Claude Desktop, you can ask:

- "Show me the top 5 posts from r/python"
- "What are the latest trends in r/learnprogramming"
- "Get the hot posts from r/news"
- "Show me rising posts in r/programming"
- "Give me information about r/AskReddit"

## Requirements

- Python 3.11+
- `mcp` (Model Context Protocol)
- `pydantic`
- `redditwarp` (for Reddit access)

Install via requirements.txt - `uv` will handle this automatically.

## How It Works

This MCP uses `redditwarp` to access Reddit's public JSON API anonymously. No authentication credentials are needed - it works just like visiting reddit.com in a browser.

## Architecture

- Built with the official MCP framework
- Uses synchronous (`SYNC`) client for simplicity
- Returns structured data via Pydantic models
- Supports comment tree traversal for detailed discussions

## Troubleshooting

### "MCP server failed to start"
- Make sure Python 3.11+ is installed
- Verify `uv` is installed: `uv --version`
- Check that the path in the config is correct

### No posts returned
- Verify the subreddit name is correct (Reddit subreddits are case-insensitive in the API)
- Check your internet connection
- Reddit may have rate limits - wait a moment and try again

## License

MIT