Reddit MCP Server

A full-featured Reddit MCP (Model Context Protocol) server built with FastMCP and PRAW. Runs in Docker and integrates with Cursor AI.

Prerequisites

Docker
A Reddit account with API credentials

Reddit API Setup

Go to https://www.reddit.com/prefs/apps
Click "create another app..."
Choose script type
Set redirect URI to http://localhost:8080
Note the client_id (shown under the app name) and client_secret

Build the Docker Image

docker build -t reddit-mcp /home/anton/reddit-mcp

Cursor Configuration

Add to ~/.cursor/mcp.json:

{
  "mcpServers": {
    "reddit": {
      "command": "docker",
      "args": [
        "run", "-i", "--rm",
        "-e", "REDDIT_CLIENT_ID",
        "-e", "REDDIT_CLIENT_SECRET",
        "-e", "REDDIT_USERNAME",
        "-e", "REDDIT_PASSWORD",
        "-e", "REDDIT_USER_AGENT",
        "reddit-mcp"
      ],
      "env": {
        "REDDIT_CLIENT_ID": "your_client_id",
        "REDDIT_CLIENT_SECRET": "your_client_secret",
        "REDDIT_USERNAME": "your_username",
        "REDDIT_PASSWORD": "your_password",
        "REDDIT_USER_AGENT": "cursor:reddit-mcp:v1.0 (by /u/your_username)"
      }
    }
  }
}

Available Tools

Reading

Tool	Description
`get_subreddit_posts`	Fetch hot/new/top/rising posts from a subreddit
`get_post_details`	Get a post with its top comments
`get_user_profile`	View a Reddit user's profile and recent activity
`search_reddit`	Search posts across Reddit or within a subreddit
`search_subreddits`	Find subreddits by keyword
`get_subreddit_info`	Get subreddit metadata (rules, description, subscriber count)

Writing

Tool	Description
`submit_post`	Create a new text or link post
`submit_comment`	Reply to a post or comment
`vote`	Upvote/downvote/unvote on a post or comment
`save_item`	Save or unsave a post or comment

Monitoring

Tool	Description
`get_trending`	Get trending posts across Reddit
`get_my_profile`	View your authenticated profile and karma
`get_saved_items`	List your saved posts and comments

Rate Limits

Reddit allows 60 authenticated requests per minute. PRAW handles this automatically.

reddit-mcp