README

MCP Reddit Server

smithery badge

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

mcp-reddit MCP server

Features

Fetch hot threads from any subreddit
Get detailed post content including comments
Support for different post types (text, link, gallery)

Installation

Installing via Smithery

To install Reddit Content for Claude Desktop automatically via Smithery:

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

Manual Installation

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

Usage

Using mcp-client-cli:

$ llm what are latest hot thread in r/victoria3

I'll fetch the latest hot threads from the Victoria 3 subreddit for you.

Tool Calls:
  fetch_hot_threads
  Args:
    subreddit: victoria3


Based on the hot threads, here are the key highlights from the Victoria 3 subreddit:

1. Dev Diary #126 - Update 1.8 Overview
   - Major updates planned for the game, including:
     - Political Movement Rework (Ideological Forces)
     - Discrimination Rework
     - Food Availability, Famines, and Harvest Incidents
     - Additional features like Companies owning buildings and Bulk Nationalization

2. Dev Diary #138 - Pivot of Empire Update
   - Update 1.8 "Masala Chai" has been released
   - Focuses on India with new Journal Entries, Events, and Immersion Pack
   - 10 new achievements added
   - Save games from 1.7.7 are not compatible with 1.8

3. Interesting Community Discussions:
   - A player shared a detailed experience of retaking Constantinople as Greece, highlighting the complex population dynamics
   - Humorous posts about game mechanics, such as investment rights and political movements
   - Various memes and gameplay screenshots showcasing unique game situations

The most upvoted thread is the Dev Diary #126, which provides an in-depth look at the upcoming game mechanics improvements, particularly the reworks to political movements and discrimination systems.

Would you like me to elaborate on any of these points or provide more details about the Victoria 3 update?

mcp-reddit FAQ

How do I install the mcp-reddit server via Smithery?

Use the command `npx -y @smithery/cli install @adhikasp/mcp-reddit --client claude` to install automatically for Claude Desktop. Manual installation is also supported.

What types of Reddit posts does mcp-reddit support?

It supports text posts, link posts, and gallery posts, providing detailed content and comments for each.

Can mcp-reddit fetch posts from any subreddit?

Yes, it can fetch hot threads from any subreddit specified by the user.

Is mcp-reddit compatible with multiple LLM providers?

Yes, it works with various LLMs including OpenAI, Anthropic Claude, and Google Gemini by providing structured Reddit content.

How does mcp-reddit handle Reddit comments?

It retrieves detailed comments along with the post content, enabling comprehensive analysis of discussions.

What is required to run mcp-reddit manually?

You need to clone the repository and run the server with the specified command and arguments as per the manual installation instructions.

Does mcp-reddit provide real-time Reddit data?

It fetches current hot threads and post details at request time, enabling near real-time data access.

Can I use mcp-reddit to analyze Reddit galleries?

Yes, it supports gallery post types, allowing access to image collections within posts.