home / mcp / reddit mcp server

Reddit MCP Server

Queries Reddit data via MCP with TOON format for efficient token usage; supports hot/new/top posts, content, search, user and subreddit info, with optional proxy support.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "jing-yilin-reddit-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@yilin-jing/reddit-mcp"
      ],
      "env": {
        "PROXY_URL": "<PROXY_URL>",
        "HTTP_PROXY": "<HTTP_PROXY>",
        "HTTPS_PROXY": "<HTTPS_PROXY>"
      }
    }
  }
}

You can access Reddit data through a unified MCP interface and obtain responses in TOON format, which helps reduce token usage while you fetch posts, users, subreddits, and post content from Reddit.

How to use

Use this MCP server with your MCP client to query Reddit data such as hot posts, new posts, top posts, user profiles, and subreddit information. The server exposes a set of tools you can call through your MCP client to fetch content, search posts, and retrieve comments and user activity. Responses arrive in TOON format for efficient token usage.

How to install

Prerequisites: ensure you have Node.js and npm installed on your system.

Install the MCP package globally or locally as shown.

Then run the MCP server using the provided NPX command to start the local stdio server.

Additional setup and configuration

Configure the Reddit MCP server in Claude Desktop to enable seamless integration with your Claude environment. Use the following JSON configuration to point Claude Desktop at the MCP server.

{
  "mcpServers": {
    "reddit": {
      "command": "npx",
      "args": ["-y", "@yilin-jing/reddit-mcp"],
      "env": {}
    }
  }
}

Environment variables

Optional environment variables help you route traffic through proxies or customize runtime behavior.

PROXY_URL=YOUR_PROXY_URL
HTTP_PROXY=YOUR_HTTP_PROXY
HTTPS_PROXY=YOUR_HTTPS_PROXY

Available tools

get_subreddit_hot

Fetch hot posts from a subreddit with a specified limit.

get_subreddit_new

Fetch new posts from a subreddit with a specified limit.

get_subreddit_top

Fetch top posts from a subreddit with a time filter and limit.

get_post_content

Retrieve detailed post content including the comments tree for a given post ID.

search_posts

Search Reddit posts by a query, optionally scoped to a subreddit and sorted by a criterion.

get_user_info

Get profile information for a Reddit user.

get_user_posts

Get posts submitted by a Reddit user.

get_user_comments

Get comments made by a Reddit user.

get_subreddit_info

Get information about a subreddit.