# Reddit MCP Server

This project implements a Model Context Protocol (MCP) server that provides tools for interacting with the Reddit API.

## Features

-   **Get Saved Posts**: Retrieve a list of saved Reddit posts for the authenticated user.
-   **Search Reddit**: Search for posts across all of Reddit or within a specific subreddit.
-   **Get Comments**: Fetch comments from a specific Reddit submission.
-   **Reply to Comment**: Post a reply to an existing Reddit comment.
-   **Fetch Reddit Post Content**: Fetch detailed content of a specific Reddit post, including a comment tree, using the `redditwarp` library.

## Setup

### Prerequisites

-   Python 3.12 or higher.

### Installation

1.  **Clone the repository** (if applicable, otherwise ensure you have the project files):
    ```bash
    git clone https://github.com/netixc/reddit-mcp-server.git
    cd reddit-mcp-server
    ```

2.  **Create a Python virtual environment**:
    ```bash
    uv sync
    ```
   This will install `praw`, `fastmcp`, `python-dotenv`, and `redditwarp`.

## Reddit API Configuration

You need to set up Reddit API credentials for your application. These can be obtained by creating an application on Reddit's developer page (https://www.reddit.com/prefs/apps).


## Running the MCP Server

The server uses both `PRAW` (for `get_saved_posts`, `search_reddit`, `get_comments`, `reply_to_comment`) and `redditwarp` (for `fetch_reddit_post_content`) to interact with the Reddit API.

### `PRAW` API Configuration

```json
{
  "mcpServers": {
    "reddit-mcp-server": {
      "command": "mcp",
      "args": [
        "run",
        "/path/to/reddit-mcp-server/server.py"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "YOUR_REDDIT_CLIENT_ID",
        "REDDIT_CLIENT_SECRET": "YOUR_REDDIT_CLIENT_SECRET",
        "REDDIT_USERNAME": "YOUR_REDDIT_USERNAME",
        "REDDIT_PASSWORD": "YOUR_REDDIT_PASSWORD"
      }
    }
  }
}
```

**Note:** Replace `YOUR_REDDIT_CLIENT_ID`, `YOUR_REDDIT_CLIENT_SECRET`, `YOUR_REDDIT_USERNAME`, and `YOUR_REDDIT_PASSWORD` with your actual Reddit API credentials for `PRAW` authentication. `redditwarp` does not require explicit credential setup in the server.py or .env file as used in this project.

## Available Tools

Once the server is running and configured in your MCP client, you can call its tools.

### `get_saved_posts(limit: int = 25, subreddit: Optional[str] = None)`

Fetches a list of saved Reddit posts for the authenticated user.

-   `limit` (int, optional): The maximum number of saved posts to retrieve. Defaults to 25.
-   `subreddit` (str, optional): If provided, only posts from this specific subreddit will be returned.


### `search_reddit(query: str, subreddit: Optional[str] = None, sort: str = "relevance", limit: int = 10)`

Searches Reddit for posts matching a given query.

-   `query` (str): The search query.
-   `subreddit` (str, optional): If provided, the search will be limited to this specific subreddit.
-   `sort` (str, optional): The sorting method for the search results (e.g., "relevance", "hot", "new", "top", "comments"). Defaults to "relevance".
-   `limit` (int, optional): The maximum number of search results to retrieve. Defaults to 10.


### `get_comments(submission_id: str, limit: int = 25)`

Fetches comments from a specific Reddit submission.

-   `submission_id` (str): The ID of the Reddit submission (post) to fetch comments from.
-   `limit` (int, optional): The maximum number of comments to retrieve. Defaults to 25.


### `reply_to_comment(comment_id: str, text: str)`

Replies to a specific Reddit comment.

-   `comment_id` (str): The ID of the comment to reply to.
-   `text` (str): The text content of the reply.

### `fetch_reddit_post_content(post_id: str, comment_limit: int = 20, comment_depth: int = 3)`

Fetch detailed content of a specific post, including a recursive comment tree. This tool utilizes the `redditwarp` library.

-   `post_id` (str): The ID of the Reddit post to fetch content from.
-   `comment_limit` (int, optional): The number of top-level comments to fetch. Defaults to 20.
-   `comment_depth` (int, optional): The maximum depth of the comment tree to traverse. Defaults to 3.