MCP Server Reddit

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

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

Video Demo (Click to Watch)

A demo in Clinde 👇

Available Tools

• get_frontpage_posts - Get hot posts from Reddit frontpage

  • Optional arguments:
    • limit (integer): Number of posts to return (default: 10, range: 1-100)

• get_subreddit_info - Get information about a subreddit

  • Required arguments:
    • subreddit_name (string): Name of the subreddit (e.g. 'Python', 'news')

• get_subreddit_hot_posts - Get hot posts from a specific subreddit

  • Required arguments:
    • subreddit_name (string): Name of the subreddit (e.g. 'Python', 'news')
  • Optional arguments:
    • limit (integer): Number of posts to return (default: 10, range: 1-100)

• get_subreddit_new_posts - Get new posts from a specific subreddit

  • Required arguments:
    • subreddit_name (string): Name of the subreddit (e.g. 'Python', 'news')
  • Optional arguments:
    • limit (integer): Number of posts to return (default: 10, range: 1-100)

• get_subreddit_top_posts - Get top posts from a specific subreddit

  • Required arguments:
    • subreddit_name (string): Name of the subreddit (e.g. 'Python', 'news')
  • Optional arguments:
    • limit (integer): Number of posts to return (default: 10, range: 1-100)
    • time (string): Time filter for top posts (default: '', options: 'hour', 'day', 'week', 'month', 'year', 'all')

• get_subreddit_rising_posts - Get rising posts from a specific subreddit

  • Required arguments:
    • subreddit_name (string): Name of the subreddit (e.g. 'Python', 'news')
  • Optional arguments:
    • limit (integer): Number of posts to return (default: 10, range: 1-100)

• get_post_content - Get detailed content of a specific post

  • Required arguments:
    • post_id (string): ID of the post
  • Optional arguments:
    • comment_limit (integer): Number of top-level comments to return (default: 10, range: 1-100)
    • comment_depth (integer): Maximum depth of comment tree (default: 3, range: 1-10)

• get_post_comments - Get comments from a post

  • Required arguments:
    • post_id (string): ID of the post
  • Optional arguments:
    • limit (integer): Number of comments to return (default: 10, range: 1-100)

Installation

Using Clinde (recommended)

The easiest way to use MCP Server Reddit is through the Clinde desktop app. Simply download and install Clinde, then:

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

That's it! No technical knowledge required - Clinde handles all the installation and configuration for you seamlessly.

Using uv (recommended)

When using uv no specific installation is needed. We will use uvx to directly run mcp-server-reddit.

Using PIP

Alternatively you can install mcp-server-reddit via pip:

pip install mcp-server-reddit

After installation, you can run it as a script using:

python -m mcp_server_reddit

Installing via Smithery

To install MCP Server Reddit for Claude Desktop automatically via [Smithery](https://smithery.ai/

... View full README on GitHub