Skip to main content
Glama
tandat8503

Reddit MCP Server

by tandat8503

Server Quality Checklist

58%
Profile completionA complete profile improves this server's visibility in search results.
  • Latest release: v1.0.0

  • Disambiguation5/5

    Each tool has a clearly distinct purpose targeting specific Reddit entities or actions: crossposts, post comments, subreddit info, subreddit posts, trending subreddits, user profiles, and search. There is no overlap in functionality, and the descriptions clearly differentiate what each tool does, making misselection unlikely.

    Naming Consistency5/5

    All tool names follow a consistent verb_noun pattern using snake_case, starting with 'get_' for retrieval operations or 'search_' for search functionality. This uniformity makes the tool set predictable and easy to understand, with no deviations in naming conventions.

    Tool Count5/5

    With 7 tools, the count is well-scoped for a Reddit server, covering core read-only operations like fetching posts, comments, subreddits, users, and search. Each tool serves a unique and necessary function without bloat, fitting typical expectations for such a domain.

    Completeness4/5

    The tool set provides comprehensive read-only coverage for browsing Reddit content, including posts, comments, subreddits, users, and search. A minor gap exists in write operations (e.g., posting, voting, commenting), but for a retrieval-focused server, the surface is nearly complete and supports common agent workflows without dead ends.

  • Average 4.1/5 across 7 of 7 tools scored.

    See the Tool Scores section below for per-tool breakdowns.

    • No community issues in the last 6 months
    • 0 commits in the last 12 weeks
    • No stable releases found
    • No critical vulnerability alerts
    • No high-severity vulnerability alerts
    • No code scanning findings
    • CI status not available
  • Add a LICENSE file by following GitHub's guide. Once GitHub recognizes the license, the system will automatically detect it within a few hours.

    If the license does not appear after some time, you can manually trigger a new scan using the MCP server admin interface.

    MCP servers without a LICENSE cannot be installed.

  • This repository includes a README.md file.

  • No tool usage detected in the last 30 days. Usage tracking helps demonstrate server value.

    Tip: use the "Try in Browser" feature on the server page to seed initial usage.

  • Add a glama.json file to provide metadata about your server.

  • If you are the author, simply .

    If the server belongs to an organization, first add glama.json to the root of your repository:

    {
      "$schema": "https://glama.ai/mcp/schemas/server.json",
      "maintainers": [
        "your-github-username"
      ]
    }

    Then . Browse examples.

  • Add related servers to improve discoverability.

How to sync the server with GitHub?

Servers are automatically synced at least once per day, but you can also sync manually at any time to instantly update the server profile.

To manually sync the server, click the "Sync Server" button in the MCP server admin interface.

How is the quality score calculated?

The overall quality score combines two components: Tool Definition Quality (70%) and Server Coherence (30%).

Tool Definition Quality measures how well each tool describes itself to AI agents. Every tool is scored 1–5 across six dimensions: Purpose Clarity (25%), Usage Guidelines (20%), Behavioral Transparency (20%), Parameter Semantics (15%), Conciseness & Structure (10%), and Contextual Completeness (10%). The server-level definition quality score is calculated as 60% mean TDQS + 40% minimum TDQS, so a single poorly described tool pulls the score down.

Server Coherence evaluates how well the tools work together as a set, scoring four dimensions equally: Disambiguation (can agents tell tools apart?), Naming Consistency, Tool Count Appropriateness, and Completeness (are there gaps in the tool surface?).

Tiers are derived from the overall score: A (≥3.5), B (≥3.0), C (≥2.0), D (≥1.0), F (<1.0). B and above is considered passing.

Tool Scores

  • Behavior2/5

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

    No annotations are provided, so the description carries the full burden. It mentions output format but lacks details on rate limits, authentication needs, error handling, or whether this is a read-only operation. For a tool with zero annotation coverage, this leaves significant behavioral gaps.

    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 well-structured with emoji sections and bullet points, making it easy to scan. However, the 'Examples' section could be more concise, and some decorative elements like emojis don't add functional value, slightly reducing efficiency.

    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?

    For a simple 1-parameter tool with no output schema, the description covers purpose and output format adequately but lacks context on behavioral aspects like rate limits or error cases. Given the low complexity, it's minimally complete but could be more informative.

    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 100% schema description coverage, the baseline is 3. The description adds value by specifying that post_id is a 'Reddit post ID to find crossposts for' and provides concrete examples, enhancing understanding beyond the schema's basic type information.

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

    Purpose5/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 with specific verb ('Find crossposts') and resource ('Reddit post'), distinguishing it from siblings like get_post_comments or get_subreddit_posts by focusing on crosspost relationships rather than comments, subreddit info, or general posts.

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

    Usage Guidelines3/5

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

    Usage is implied through examples showing post_id usage, but there's no explicit guidance on when to use this tool versus alternatives like search_reddit or get_subreddit_posts for related content. The description doesn't mention prerequisites or exclusions.

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

  • Behavior3/5

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

    With no annotations provided, the description carries the full burden. It discloses that the tool fetches data (implied read-only) and describes the output format, but does not mention rate limits, authentication needs, pagination, or error handling. It adds some behavioral context (output format) but is incomplete for a tool with no annotations.

    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 well-structured with emoji sections, front-loaded purpose, and efficient bullet points. Every sentence earns its place by providing purpose, requirements, examples, and output details without redundancy or fluff.

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

    Completeness4/5

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

    Given the tool's moderate complexity (2 parameters, no output schema, no annotations), the description is fairly complete—it covers purpose, parameters with examples, and output format. However, it lacks details on behavioral aspects like rate limits or error handling, which would be beneficial since there are no annotations.

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

    Parameters3/5

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

    The schema description coverage is 100%, so the schema already documents both parameters thoroughly. The description adds minimal value beyond the schema by listing examples and noting that subreddit is required and sort is optional, but does not provide additional semantics like format constraints or usage tips beyond what's in the schema.

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

    Purpose5/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 with specific verbs ('fetches posts') and resources ('from any Reddit subreddit'), and distinguishes it from siblings like get_subreddit_info (which gets metadata) or get_post_comments (which gets comments). The emoji section 'What it does' explicitly defines the action.

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

    Usage Guidelines4/5

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

    The description provides clear context for when to use this tool (to fetch posts from a subreddit) but does not explicitly mention when not to use it or name alternatives like get_trending_subreddits or search_reddit. The examples imply usage scenarios but lack explicit exclusions.

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

  • Behavior3/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. It mentions the output format (formatted results with specific fields) and implies read-only behavior through 'search', but lacks details on rate limits, authentication needs, or pagination. It adds some context but is incomplete for a search tool.

    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 well-structured with emoji icons and bullet points, making it easy to scan. It is front-loaded with the core purpose, followed by required/optional parameters, examples, and output details—all in a compact format with no wasted sentences.

    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 no annotations and no output schema, the description provides basic purpose, parameters, and output format, but lacks deeper behavioral context (e.g., error handling, result limits). It is adequate for a simple search tool but could be more complete, especially in explaining limitations or integration with sibling tools.

    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?

    Schema description coverage is 100%, so the baseline is 3. The description adds value by explicitly labeling 'query' as required and 'subreddit' as optional, and providing examples that clarify usage (e.g., global vs. subreddit search). This enhances understanding beyond the schema's basic descriptions.

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

    Purpose5/5

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

    The description clearly states the tool searches Reddit posts and comments, specifying both global and subreddit-specific searches. It distinguishes itself from siblings like get_subreddit_posts (which likely fetches posts without search) and get_post_comments (which focuses on comments for a specific post), making the purpose specific and differentiated.

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

    Usage Guidelines4/5

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

    The description provides clear context for when to use this tool (searching across Reddit or within a subreddit) and includes examples that illustrate different scenarios. However, it does not explicitly state when not to use it or mention alternatives among sibling tools, such as using get_subreddit_posts for non-search-based retrieval.

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

  • Behavior4/5

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

    With no annotations provided, the description carries the full burden. It discloses key behavioral traits: it fetches comments and replies (read operation), specifies the output format ('formatted comment tree with author, score, timestamp, and nested replies'), and mentions optional sorting. However, it doesn't cover potential rate limits, authentication needs, or pagination behavior, which are gaps for a Reddit API tool.

    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 front-loaded with a clear purpose and uses bullet points efficiently for examples. Every sentence earns its place: the emoji sections (💬, 🎯, etc.) organize information without waste, and the output description is succinct. No redundant or verbose content is present.

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

    Completeness4/5

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

    Given the tool's moderate complexity (2 parameters, no output schema, no annotations), the description is mostly complete. It covers purpose, parameters with examples, and output format. However, it lacks details on error handling, rate limits, or authentication—common for API tools. With no output schema, the output description is helpful but could be more detailed (e.g., structure of the tree).

    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?

    Schema description coverage is 100%, so the schema already documents both parameters well. The description adds value by explaining post_id ('found in post URLs'), providing examples of parameter usage, and clarifying sort options with examples. This goes beyond the schema's basic descriptions, though it doesn't add deep semantic nuances.

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

    Purpose5/5

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

    The description clearly states the verb 'fetches' and resource 'comments and replies for any Reddit post', making the purpose specific. It distinguishes from siblings like get_subreddit_posts (which gets posts, not comments) and get_user_profile (user-focused rather than post-focused). The emoji '💬 Get comments for a Reddit post' reinforces this distinction.

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

    Usage Guidelines3/5

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

    The description implies usage when needing comments for a Reddit post, but provides no explicit guidance on when to use this tool versus alternatives like search_reddit (which might find comments via search) or get_cross_posts (which focuses on cross-posting). There's no mention of prerequisites or exclusions, leaving usage context inferred rather than stated.

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

  • Behavior3/5

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

    With no annotations provided, the description carries the full burden. It discloses that the tool 'fetches' (read operation) and lists output details, but does not mention behavioral traits like rate limits, authentication needs, error handling, or whether it's idempotent. The description adds some context about the output format, but lacks comprehensive behavioral disclosure for a tool with no annotations.

    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 appropriately sized and front-loaded with key information (purpose and required parameter) using emoji sections. Each section ('🎯', '📝', '💡', '🔍') earns its place by adding distinct value without redundancy. The structure is efficient and easy to scan.

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

    Completeness4/5

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

    Given the tool's low complexity (1 parameter, no output schema, no annotations), the description is mostly complete: it covers purpose, parameter details, examples, and output format. However, it lacks information on error cases or limitations (e.g., invalid subreddit names), which would be helpful for a tool with no annotations or output schema.

    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 schema description coverage is 100%, so the baseline is 3. The description adds value by clarifying the parameter semantics: it specifies 'subreddit name (without r/ prefix)' and provides examples, which goes beyond the schema's generic 'Subreddit name to get information about'. This extra detail compensates adequately, but doesn't fully explain edge cases.

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

    Purpose5/5

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

    The description clearly states the tool 'fetches detailed info about any Reddit subreddit' with specific verb ('fetches') and resource ('subreddit'), and distinguishes it from sibling tools like get_subreddit_posts (which gets posts) or get_user_profile (which gets user info). The emoji '🏠' and '🎯' sections reinforce this specific purpose.

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

    Usage Guidelines4/5

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

    The description provides clear context for when to use this tool (to get subreddit details like description, subscribers, etc.), but does not explicitly state when not to use it or name alternatives among siblings. The '📝 Required' section implies usage for subreddit info retrieval, but lacks explicit comparison to tools like get_trending_subreddits or search_reddit.

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

  • Behavior3/5

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

    No annotations are provided, so the description carries the full burden. It discloses that no parameters are needed and describes the output format, but lacks details on rate limits, authentication needs, or data freshness (e.g., how 'trending' is defined). The description adds value beyond annotations but is not comprehensive.

    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 well-structured with emoji-led sections, front-loads the purpose, and includes only essential elements (what it does, parameters, examples, output). Every sentence earns its place without redundancy, making it efficient and easy to scan.

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

    Completeness4/5

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

    Given the tool's simplicity (0 parameters, no output schema, no annotations), the description is largely complete—it explains the purpose, parameter requirements, and output format. However, it could improve by mentioning limitations (e.g., no filtering options) or linking to siblings for more specific data.

    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 schema has 0 parameters with 100% coverage, so no parameter documentation is needed. The description explicitly states 'Required: None (no parameters needed)', which adds clarity beyond the empty schema, earning a baseline above 3 for addressing the parameterless nature.

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

    Purpose5/5

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

    The description explicitly states 'Fetches list of currently popular and trending subreddits' with a specific verb ('fetches') and resource ('subreddits'), clearly distinguishing it from sibling tools like get_subreddit_info (single subreddit) or search_reddit (search queries). The emoji '🔥 Get trending/popular subreddits' reinforces the purpose.

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

    Usage Guidelines4/5

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

    The description provides clear context for when to use it ('currently popular and trending subreddits'), but does not explicitly state when not to use it or name alternatives. It distinguishes from siblings by focusing on trending lists rather than specific subreddits or posts, though not with explicit 'vs' statements.

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

  • Behavior4/5

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

    With no annotations provided, the description carries full burden and does well by disclosing what information is returned (karma, account age, gold status, moderator status, profile link). It also clarifies the username format requirement ('without u/ prefix'), which is valuable behavioral context not in the schema. It doesn't mention rate limits or authentication needs, but provides solid operational transparency.

    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 efficiently structured with emoji-labeled sections, each sentence earns its place. It's front-loaded with the core purpose, then provides requirements, examples, and output details without redundancy. The information density is high with zero wasted text.

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

    Completeness4/5

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

    For a single-parameter read operation with no annotations and no output schema, the description does an excellent job covering what the tool does, parameter requirements, examples, and expected output format. The only minor gap is the lack of explicit guidance on when to use versus sibling tools, but otherwise it's quite complete for this complexity level.

    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 100% schema description coverage for the single parameter, the baseline would be 3. However, the description adds significant value by clarifying the username format ('without u/ prefix') and providing multiple concrete examples of valid usernames, which goes beyond what the schema provides about parameter semantics.

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

    Purpose5/5

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

    The description explicitly states 'Fetches detailed profile info for any Reddit user' with a clear verb ('Fetches') and resource ('profile info for any Reddit user'). It distinguishes from sibling tools like get_subreddit_info by focusing specifically on user profiles rather than subreddits or posts.

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

    Usage Guidelines3/5

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

    The description provides implied usage through examples and the 'Required' section, showing this is for fetching user profiles. However, it doesn't explicitly state when to use this tool versus alternatives (like search_reddit for finding users) or provide exclusion criteria for when not to use it.

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

GitHub Badge

Glama performs regular codebase and documentation scans to:

  • Confirm that the MCP server is working as expected.
  • Confirm that there are no obvious security issues.
  • Evaluate tool definition quality.

Our badge communicates server capabilities, safety, and installation instructions.

Card Badge

mcp-reddit MCP server

Copy to your README.md:

Score Badge

mcp-reddit MCP server

Copy to your README.md:

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/tandat8503/mcp-reddit'

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