home / mcp / reddit mcp server

Reddit MCP Server

A Model Context Protocol (MCP) server that provides tools for fetching Reddit content, including frontpage posts, subreddit information and hot posts, post details, and comments.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

{
  "mcpServers": {
    "hawstein-mcp-server-reddit": {
      "command": "uvx",
      "args": [
        "mcp-server-reddit"
      ]
    }
  }
}

This MCP Server Reddit lets your models interact with Reddit’s public API to browse frontpage posts, explore subreddit information, and read post comments. It exposes Reddit data through the MCP protocol, enabling you to fetch posts and content programmatically from your preferred MCP client.

How to use

You connect to the MCP server from your MCP client and call the available endpoints to fetch Reddit data. Use the frontpage endpoint to browse hot posts, query specific subreddits to get hot, new, or top posts, and retrieve full post content or comments as needed. You can combine multiple endpoints to build feeds, summarize discussions, or analyze trends directly from your chat or agent workflow.

How to install

Prerequisites: you need Python or a runtime that can execute the server, and an MCP client to connect to the server.

# Option 1: Install via uvx (recommended for MCP environments)
# Ensure uvx is installed on your system
# Run the Reddit MCP server directly
uvx
# Then start the server using the provided command
uvx mcp-server-reddit

Configuration and startup notes

There are multiple ways to run the Reddit MCP server depending on your setup.

If you are using uvx to run the server locally, you can start it with: ``uvx mcp-server-reddit`. You may also run the server through Python if you installed it via pip: `python -m mcp_server_reddit``. Use the approach that matches your installation method.

Examples of usage patterns

- Retrieve current hot posts from the front page to surface trending topics for your agent.

- Get information about a subreddit such as r/Python to inform a topic-aware assistant.

- Fetch hot or new posts from a subreddit to build a live feed for discussions or monitoring.

- Get full post content and a set of top-level comments to analyze discussions or summarize debates.

Available tools

get_frontpage_posts

Fetch hot posts from Reddit frontpage with optional limit to control how many posts are returned.

get_subreddit_info

Retrieve information about a specific subreddit by name.

get_subreddit_hot_posts

Get hot posts from a specific subreddit, with an optional limit for how many posts to return.

get_subreddit_new_posts

Get the newest posts from a specific subreddit, with an optional limit.

get_subreddit_top_posts

Get top posts from a specific subreddit with optional limit and time filter.

get_subreddit_rising_posts

Get rising posts from a specific subreddit with optional limit.

get_post_content

Fetch detailed content for a post by its ID, including a configurable number of top-level comments and depth.

get_post_comments

Retrieve comments from a post by its ID with an optional limit.