home / mcp / mcp reddit server

MCP Reddit Server

A Model Context Protocol (MCP) server that provides tools for fetching and analyzing Reddit content.

Installation

Add the following to your MCP client configuration file.

Configuration

{
  "mcpServers": {
    "adhikasp-mcp-reddit": {
      "command": "uvx",
      "args": [
        "--from",
        "git+https://github.com/adhikasp/mcp-reddit.git",
        "mcp-reddit"
      ]
    }
  }
}

You can run an MCP Reddit Server to fetch and analyze Reddit content through an MCP client. It exposes tools to pull hot threads from subreddits and retrieve detailed post content, including comments, with support for text, link, and gallery posts. This makes it easy to integrate Reddit data and insights into your automated workflows and AI assistants.

How to use

Use an MCP client to interact with the Reddit MCP server and perform common content tasks. Typical patterns include fetching the latest hot threads from a specific subreddit, then requesting detailed post content and related comments. You can combine results from multiple posts to extract highlights, trends, or discussion hotspots.

Example usage flow you can follow: - Ask the client to fetch hot threads from a subreddit of interest (for example, r/victoria3). - Request detailed content for a chosen post to obtain full text, images, and the comment thread. - Filter or summarize results to surface key takeaways, popular topics, or data points relevant to your goal.

How to install

Prerequisites you should have before installing: - Node.js installed on your system (to run tooling that interacts with MCP servers). - A command-line environment with access to install or run MCP server clients. - Internet access to download required packages or containers.

Option A: Install Reddit Content for Claude Desktop automatically via Smithery
- Execute:
```
npx -y @smithery/cli install @adhikasp/mcp-reddit --client claude
```
- This installs the MCP Reddit Server client setup for Claude Desktop and wires it into your environment.

Option B: Manual installation (runtime command provided by the project)
- Create a configuration snippet for the Reddit MCP server runtime as shown:
```
{
  "reddit": {
    "command": "uvx",
    "args": ["--from", "git+https://github.com/adhikasp/mcp-reddit.git", "mcp-reddit"],
    "env": {}
  }
}
```
- Use the snippet with your preferred MCP runner or integration that accepts this format to start the server.

Additional sections

Configuration options and usage details are designed to be straightforward. The server exposes capabilities to fetch hot threads from any subreddit, retrieve full post content including comments, and support for different post types such as text, link, and gallery. If you need to customize behavior or add extra data sources, adjust the server configuration accordingly and verify that your MCP client can access the reddit endpoint.

Available tools

fetch_hot_threads

Fetches hot threads from a specified subreddit, returning a list of posts with basic metadata to help you identify topics of interest.

get_post_content

Retrieves detailed content for a chosen post, including the full text, media, and the accompanying comments thread.

post_type_support

Indicates support for multiple post types (text, link, gallery) and ensures the returned data reflects the post's type.