A Model Context Protocol (MCP) server that provides access to Reddit's public API through streamable HTTP transport
Server has 8 well-named tools with complete input schemas and descriptions. All tools follow verb_noun naming (get_*) and are READ_ONLY. Schemas include proper types, descriptions, and constraints (min/max for numeric params, enums for time filter). However, output schemas are not documented, LLMs cannot predict response structure. Parameter descriptions are adequate but generic (e.g., 'ID of the post' lacks format guidance). No error handling guidance visible in tool definitions. Missing tool annotations (readOnlyHint present implicitly via Risk field, but not in MCP schema). Tool composition is sound, each tool has one responsibility and names distinguish clearly (hot vs new vs top vs rising posts).
Get hot posts from Reddit frontpage
Get comments from a post
Get detailed content of a specific post
Get hot posts from a specific subreddit
Get information about a subreddit
Get new posts from a specific subreddit
Get rising posts from a specific subreddit
Output schemas not documented. Tool descriptions state what is returned (e.g., 'Get hot posts') but do not specify the structure of the response object, field names, or types. LLMs cannot plan downstream operations or extract specific fields without knowing the response schema.
Parameter descriptions lack format guidance and constraints. 'ID of the post' does not specify format (alphanumeric, length, prefix). 'Name of the subreddit' does not clarify case sensitivity or whether spaces are allowed. LLMs may pass invalid values.
| Scored | Grade | Overall | Spec posture | Rubric |
|---|---|---|---|---|
| 2026-09-23 | C | 64 | 2026-07-28+ | v2 |
Get top posts from a specific subreddit
No error handling guidance in tool definitions. If a subreddit does not exist or a post is deleted, the tool response does not guide the LLM on recovery (e.g., 'Try search_subreddits() with a partial name'). Agents cannot self-correct.
Tool annotations missing from MCP schema. Risk field (READ_ONLY) is present in metadata but not exposed as readOnlyHint in the tool definition. MCP clients cannot automatically infer tool safety properties.
No result limits documented in tool descriptions. Tools accept 'limit' parameter (max 100) but description does not state the default behavior if limit is omitted or the performance implications of large limits. LLMs may request excessive data.