Skip to main content
Glama
adhikasp
by adhikasp

MCP Reddit Server

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

Features

  • Fetch hot threads from any subreddit

  • Get detailed post content including comments

  • Support for different post types (text, link, gallery)

Related MCP server: Reddit MCP Server

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?

Available Tools

2 tools
fetch_reddit_hot_threadsB

Fetch hot threads from a subreddit

Args: subreddit: Name of the subreddit limit: Number of posts to fetch (default: 10)

Returns: Human readable string containing list of post information

ParametersJSON Schema
NameRequiredDescriptionDefault
subredditYes
limitNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.1/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. While it mentions the return format ('human readable string'), it doesn't address critical behavioral aspects like rate limits, authentication requirements, error conditions, or whether this is a read-only operation. The description is insufficient for a tool that interacts with an external API.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness4/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is appropriately sized and well-structured with clear sections for Args and Returns. Each sentence serves a purpose, though the 'Returns' section could be slightly more informative about the content format beyond 'human readable string'.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given the tool has an output schema (though not provided in the prompt), the description doesn't need to detail return values extensively. However, for an API interaction tool with no annotations and sibling tools, the description should provide more behavioral context about limitations, errors, and differentiation from alternatives to be truly complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

With 0% schema description coverage, the description provides essential semantic context for both parameters: 'subreddit' is explained as 'name of the subreddit' and 'limit' as 'number of posts to fetch' with a default value. This compensates well for the lack of schema descriptions, though it doesn't specify format constraints or validation rules.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the action ('fetch') and resource ('hot threads from a subreddit'), making the tool's purpose immediately understandable. However, it doesn't explicitly differentiate from its sibling 'fetch_reddit_post_content', which appears to fetch content of individual posts rather than lists of hot threads.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives, including its sibling 'fetch_reddit_post_content'. There's no mention of prerequisites, limitations, or contextual factors that would help an agent decide between this tool and other options.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

fetch_reddit_post_contentB

Fetch detailed content of a specific post

Args: post_id: Reddit post ID comment_limit: Number of top level comments to fetch comment_depth: Maximum depth of comment tree to traverse

Returns: Human readable string containing post content and comments tree

ParametersJSON Schema
NameRequiredDescriptionDefault
post_idYes
comment_limitNo
comment_depthNo

Output Schema

ParametersJSON Schema
NameRequiredDescription
resultYes

TDQS

B3.2/5.0
Behavior2/5

Does the description disclose side effects, auth requirements, rate limits, or destructive behavior?

With no annotations provided, the description carries the full burden of behavioral disclosure. While it states the tool fetches content and returns a human-readable string, it doesn't cover important behavioral aspects like rate limits, authentication requirements, error conditions, pagination, or whether this is a read-only operation. The description is minimal and leaves significant behavioral questions unanswered.

Agents need to know what a tool does to the world before calling it. Descriptions should go beyond structured annotations to explain consequences.

Conciseness5/5

Is the description appropriately sized, front-loaded, and free of redundancy?

The description is extremely well-structured and concise. It begins with a clear purpose statement, then provides a clean 'Args:' section with parameter explanations, followed by a 'Returns:' section. Every sentence earns its place, and the information is front-loaded with the most important details first. No wasted words or redundancy.

Shorter descriptions cost fewer tokens and are easier for agents to parse. Every sentence should earn its place.

Completeness3/5

Given the tool's complexity, does the description cover enough for an agent to succeed on first attempt?

Given that there's an output schema (though not shown), the description doesn't need to explain return values in detail. However, for a tool with 3 parameters, 0% schema description coverage, and no annotations, the description provides adequate but minimal coverage. It explains what the tool does and what parameters mean, but lacks behavioral context and usage guidance that would make it more complete.

Complex tools with many parameters or behaviors need more documentation. Simple tools need less. This dimension scales expectations accordingly.

Parameters4/5

Does the description clarify parameter syntax, constraints, interactions, or defaults beyond what the schema provides?

The description adds significant value beyond the input schema, which has 0% description coverage. It clearly explains what each parameter means: 'post_id: Reddit post ID', 'comment_limit: Number of top level comments to fetch', and 'comment_depth: Maximum depth of comment tree to traverse'. This provides essential semantic context that the bare schema lacks, though it doesn't specify format details or constraints.

Input schemas describe structure but not intent. Descriptions should explain non-obvious parameter relationships and valid value ranges.

Purpose4/5

Does the description clearly state what the tool does and how it differs from similar tools?

The description clearly states the tool's purpose: 'Fetch detailed content of a specific post' - a specific verb ('fetch') and resource ('detailed content of a specific post'). It distinguishes from the sibling tool 'fetch_reddit_hot_threads' by focusing on individual posts rather than hot threads. However, it doesn't explicitly contrast with the sibling beyond the inherent difference in scope.

Agents choose between tools based on descriptions. A clear purpose with a specific verb and resource helps agents select the right tool.

Usage Guidelines2/5

Does the description explain when to use this tool, when not to, or what alternatives exist?

The description provides no guidance on when to use this tool versus alternatives. It doesn't mention the sibling tool 'fetch_reddit_hot_threads' or explain when to fetch a specific post versus browsing hot threads. There are no usage prerequisites, exclusions, or contextual recommendations provided.

Agents often have multiple tools that could apply. Explicit usage guidance like "use X instead of Y when Z" prevents misuse.

Tool Schema Changelog

Recent tool additions, removals, and schema changes observed during successful MCP inspections. Dates show when Glama detected each change.

  1. 2 tool updatesv1.0.0
    • Changedfetch_reddit_hot_threads4 fields changed
      • removedInput schema / properties / limit / title
        Removed value: -"Limit"
      • removedInput schema / properties / subreddit / title
        Removed value: -"Subreddit"
      • removedOutput schema / properties / result / title
        Removed value: -"Result"
      • removedOutput schema / title
        Removed value: -"_WrappedResult"
    • Changedfetch_reddit_post_content5 fields changed
      • removedInput schema / properties / comment_depth / title
        Removed value: -"Comment Depth"
      • removedInput schema / properties / comment_limit / title
        Removed value: -"Comment Limit"
      • removedInput schema / properties / post_id / title
        Removed value: -"Post Id"
      • removedOutput schema / properties / result / title
        Removed value: -"Result"
      • removedOutput schema / title
        Removed value: -"_WrappedResult"
  2. 2 tool updates
    • First observedfetch_reddit_hot_threads
    • First observedfetch_reddit_post_content

TDQS

B3.3/5.0

Scored across 2 tools

Disambiguation5/5

The two tools have clearly distinct purposes: one fetches a list of hot threads from a subreddit, while the other retrieves detailed content for a specific post. There is no overlap in functionality, making it easy for an agent to select the appropriate tool based on whether it needs overview information or detailed content.

Naming Consistency5/5

Both tools follow a consistent verb_noun pattern with 'fetch_reddit_' prefix, using snake_case throughout. The naming is predictable and readable, with no deviations in style or convention across the tool set.

Tool Count2/5

With only 2 tools, the server feels thin for a Reddit integration. While the tools cover basic fetching of posts and content, there are likely gaps in functionality such as posting, voting, or searching, which limits the server's utility for comprehensive Reddit interactions.

Completeness2/5

The tool surface is severely incomplete for a Reddit domain. It only supports fetching operations (read-only), with no ability to create, update, or delete content (e.g., posting, commenting, or voting). This will cause agent failures when trying to perform common Reddit actions beyond simple retrieval.

Maintenance

ActivityInactive
ResponsivenessUnresponsive

Resources

Unclaimed servers have limited discoverability.

Looking for Admin?

If you are the server author, to access and configure the admin panel.

Related MCP Connectors

Related MCP Servers

  • A
    license
    A
    quality
    D
    maintenance
    Enables browsing and searching Reddit content through read-only tools that access Reddit's official API. Supports searching posts, retrieving subreddit information, fetching hot posts, and getting detailed post information.
    5
    4
    MIT
  • F
    license
    Not graded
    quality
    D
    maintenance
    Provides AI assistants with read-only access to Reddit's API for browsing subreddits, reading posts and comments, searching Reddit, and retrieving user/subreddit information. Enables safe exploration of Reddit content without posting capabilities through natural language interactions.
    -
  • A
    license
    Not graded
    quality
    D
    maintenance
    Enables AI agents to search, read, and analyze Reddit content, including posts, comments, subreddits, and user profiles using natural language commands. It provides atomic tools for interacting with the Reddit API to retrieve trending topics and community metadata.
    MIT

Latest Blog Posts

MCP directory API

We provide all the information about MCP servers via our MCP API.

curl -X GET 'https://glama.ai/api/mcp/v1/servers/adhikasp/mcp-reddit'

If you have feedback or need assistance with the MCP directory API, please join our Discord server