Reddit

Provides access to Reddit public data for LLMs via MCP endpoints (frontpage, subreddits, posts, and comments).

javascript

0

GitHub Stars

javascript

Language

7 months ago

First Indexed

3 months ago

Catalog Refreshed

Documentation & install

Readme and setup notes from the catalogue, plus a client-ready config you can copy for your MCP host.

Installation

Add the following to your MCP client configuration file.

Configuration

View docs

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

You can connect to the MCP Server Reddit to let your LLMs browse Reddit content, subreddits, and post discussions through a dedicated MCP interface. This server translates Reddit public data into MCP endpoints you can call from your agent, enabling practical interactions like checking frontpage posts, querying subreddits, and reading comments.

How to use

Use an MCP client to connect to the Reddit MCP server. You’ll access functions like getting frontpage posts, subreddit info, and post content through clearly named actions. Typical workflows include browsing hot content, exploring a subreddit’s latest posts, and fetching a post with comments for deeper context.

How to install

Prerequisites: make sure you have a runtime that can run MCP servers and a client ready to call MCP endpoints.

Install via Claude app (recommended): download ClaudeMind, then install the Reddit MCP server from the Servers page by selecting mcp-server-reddit and clicking Install.

Install via uvx (recommended): no separate installation is required. You will run the server directly with uvx.

Install via Python (PIP): run the following to install the package and then start it as a script.

pip install mcp-server-reddit

python -m mcp_server_reddit

Configuration

Configure your MCP client or environment to connect to the Reddit MCP server. You can use either the uvx/stdio command or the Python-based runtime, depending on your setup.

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

Examples of questions

Here are example prompts you can use to exercise the server’s capabilities.

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

If you need to debug the server, use the MCP inspector to verify runtime behavior.

npx @modelcontextprotocol/inspector uvx mcp-server-reddit

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

Available tools

get_frontpage_posts

Fetches hot posts from Reddit's frontpage with an optional limit of up to 100 posts.

get_subreddit_info

Retrieves information about a specified subreddit by name.

get_subreddit_hot_posts

Returns hot posts from a given subreddit with an optional limit.

get_subreddit_new_posts

Returns new posts from a given subreddit with an optional limit.

get_subreddit_top_posts

Returns top posts from a given subreddit, with optional limit and time filter.

get_subreddit_rising_posts

Returns rising posts from a given subreddit with an optional limit.

get_post_content

Fetches detailed content for a specific post, including an optional top-level comment set and depth.

get_post_comments

Retrieves comments for a specific post with an optional limit.