📌Overview

Purpose: To provide a Model Context Protocol server that enables LLMs to seamlessly access and interact with the Reddit public API.

Overview: The MCP Server Reddit allows LLMs to browse Reddit's content, including current frontpage posts, subreddit details, and comments on posts. It utilizes the redditwarp library for efficient API interactions, providing a robust platform for developers to integrate Reddit functionalities into their applications through the MCP protocol.

Key Features:

• Get Hot Posts: Fetches trending posts from Reddit's frontpage and specified subreddits to keep LLMs updated with popular content.

• Subreddit Information Access: Retrieves details about specific subreddits, facilitating contextual understanding for LLM responses.

• Post Content and Comments Retrieval: Offers capabilities to access detailed content of posts and their associated comments, enhancing interactivity and analysis of Reddit discussions.

MCP Server Reddit

A Model Context Protocol server providing access to Reddit's public API for LLMs. This server enables LLMs to interact with Reddit's content, including browsing frontpage posts and accessing subreddit information.

This server uses redditwarp to interact with Reddit's public API and exposes the functionality through the MCP protocol.

Available Tools

• get_frontpage_posts: Get hot posts from Reddit frontpage

  • Optional: limit (default: 10, range: 1-100)

• get_subreddit_info: Get information about a subreddit

  • Required: subreddit_name (e.g. 'Python', 'news')

• get_subreddit_hot_posts: Get hot posts from a specific subreddit

  • Required: subreddit_name
  • Optional: limit (default: 10, range: 1-100)

• get_subreddit_new_posts: Get new posts from a specific subreddit

  • Required: subreddit_name
  • Optional: limit (default: 10, range: 1-100)

• get_subreddit_top_posts: Get top posts from a specific subreddit

  • Required: subreddit_name
  • Optional: limit (default: 10, range: 1-100), time (options: 'hour', 'day', 'week', 'month', 'year', 'all')

• get_subreddit_rising_posts: Get rising posts from a specific subreddit

  • Required: subreddit_name
  • Optional: limit (default: 10, range: 1-100)

• get_post_content: Get detailed content of a specific post

  • Required: post_id
  • Optional: comment_limit (default: 10, range: 1-100), comment_depth (default: 3, range: 1-10)

• get_post_comments: Get comments from a post

  • Required: post_id
  • Optional: limit (default: 10, range: 1-100)

Installation

Using ClaudeMind (recommended)

1. Open the ClaudeMind app
2. Navigate to the Servers page
3. Find mcp-server-reddit and click Install

Using pip

Install mcp-server-reddit via pip:

pip install mcp-server-reddit

Run it as a script using:

python -m mcp_server_reddit

Installing via Smithery

To install MCP Server Reddit automatically via Smithery:

npx -y @smithery/cli install @Hawstein/mcp-server-reddit --client claude

Configuration

Configure for Claude.app

Add to your Claude settings:

"mcpServers": {
  "reddit": {
    "command": "python",
    "args": ["-m", "mcp_server_reddit"]
  }
}

Configure for Zed

Add to your Zed settings.json:

"context_servers": {
  "mcp-server-reddit": {
    "command": "python",
    "args": ["-m", "mcp_server_reddit"]
  }
},

Examples of Questions

• "What are the current hot posts on Reddit's frontpage?"
• "Tell me about the r/ClaudeAI subreddit"
• "What are the hot posts in the r/ClaudeAI subreddit?"
• "Show me the newest posts from r/ClaudeAI"
• "What are the top posts of all time in r/ClaudeAI?"
• "What posts are trending in r/ClaudeAI right now?"
• "Get the full content and comments of this Reddit post: [post_url]"
• "Summarize the comments on this Reddit post: [post_url]"

Debugging

Use the MCP inspector to debug the server:

For uvx installations:

npx @modelcontextprotocol/inspector uvx mcp-server-reddit

For local installations:

cd path/to/mcp_server_reddit
npx @modelcontextprotocol/inspector uv run mcp-server-reddit

License

mcp-server-reddit is licensed under the MIT License. You are free to use, modify, and distribute the software, subject to the terms and conditions of the MIT License. For more details, please see the LICENSE file in the project repository.