redditapis-mcp 0.1.1 → 0.1.3

package/CHANGELOG.md

@@ -1,5 +1,28 @@
 # Changelog
 
+## 0.1.3
+- `reddit_search_comments` description no longer overpromises. It previously
+  claimed to "Return matching comments with author, body, score" and to find
+  "opinions/answers buried in threads", but the endpoint returns PARENT POSTS,
+  not comment objects: Reddit's comment search is a MODE that matches comment
+  text and hands back the t3 posts, and does not expose which comment matched or
+  its body. The openapi spec already said this; the MCP tool description and the
+  README table had drifted and still promised comment bodies/scores the response
+  never contained. A customer relied on the old text and reported it as a bug.
+  The description now states the real behaviour. No API surface change.
+
+## 0.1.2
+- `reddit_search` and `reddit_search_comments` now describe the `t` time window
+  accurately. Unlike a subreddit listing, search applies `t` to the `relevance`
+  and `top` sorts as well, and when it is omitted Reddit defaults to `all` — so a
+  broad relevance query surfaces old high-upvote posts that only loosely match.
+  The tool description now says so, which materially changes the queries an agent
+  writes. No API surface change.
+
+## 0.1.1
+- Corrected package metadata.
+
+
 ## 0.1.0
 - Initial release: 11 read tools over the redditapis.com API (subreddit listings,
   post/comment/community/user/media search, comment tree, subreddit top posts,

package/README.md

@@ -47,7 +47,7 @@ authenticated surface and are intentionally not exposed here.
 | `reddit_search` | `GET /api/reddit/search` | Search posts across Reddit or one subreddit |
 | `reddit_post_comments` | `GET /api/reddit/comments` | A post + its comment tree, by permalink |
 | `reddit_search_communities` | `GET /api/reddit/search/communities` | Find subreddits by name/topic |
-| `reddit_search_comments` | `GET /api/reddit/search/comments` | Search comments (not posts) |
+| `reddit_search_comments` | `GET /api/reddit/search/comments` | Search by comment text; returns the parent posts (Reddit limitation) |
 | `reddit_search_media` | `GET /api/reddit/search/media` | Search image/video/gif posts |
 | `reddit_search_users` | `GET /api/reddit/search/users` | Find redditors by name |
 | `reddit_subreddit_top` | `GET /api/reddit/sub/{name}/top` | Top posts of a subreddit for a time window |

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "redditapis-mcp",
-  "version": "0.1.1",
+  "version": "0.1.3",
   "description": "Official MCP server for redditapis.com, the Reddit API (subreddit listings, post + comment + community + user + media search, comment trees, top posts, user profiles) as native tools for Claude, Cursor, and any MCP client.",
   "repository": {
     "type": "git",

package/src/tools.js

@@ -43,6 +43,15 @@ const TIME = {
     "Time window, only applied when sort is 'top' or 'controversial'. E.g. 'week' = top of the past week. Ignored for other sorts.",
   ),
 };
+// Search honours `t` differently from a subreddit listing: it bounds the whole
+// result set (including the 'relevance' and 'top' sorts), not just top/controversial.
+// Omitting it makes Reddit default to 'all', which lets old high-upvote posts win a
+// broad 'relevance' query, so search gets a separate, search-accurate description.
+const TIME_SEARCH = {
+  t: z.enum(["hour", "day", "week", "month", "year", "all"]).optional().describe(
+    "Time window that bounds which posts the search returns, e.g. 'week' = only posts from the past week. Unlike a subreddit listing, search applies this to the 'relevance' and 'top' sorts too. When omitted, Reddit defaults to 'all', so a broad 'relevance' query surfaces old high-upvote posts that only loosely match. Pass 'week' or 'month' to keep results recent and on-topic.",
+  ),
+};
 const NSFW = {
   nsfw: z.enum(["true", "false"]).optional().describe(
     "Set 'true' to include over-18 / NSFW results. Omit or 'false' to exclude them (default).",
@@ -82,7 +91,7 @@ export const TOOLS = [
         "Optional subreddit name (without r/) to restrict the search to one community. Omit to search all of Reddit.",
       ),
       ...SORT_SEARCH,
-      ...TIME,
+      ...TIME_SEARCH,
       ...AFTER,
       ...NSFW,
       ...LIMIT,
@@ -110,8 +119,8 @@ export const TOOLS = [
     name: "reddit_search_comments",
     path: "/api/reddit/search/comments",
     description:
-      "Search Reddit COMMENTS (not posts) by keyword across Reddit. Returns matching comments with author, body, score, subreddit, and the parent post link. Use to find first-hand opinions/answers buried in threads. Example: q='best mechanical keyboard' sort='top'.",
-    shape: { ...QUERY, ...SORT_SEARCH, ...TIME, ...AFTER, ...NSFW, ...LIMIT },
+      "Search Reddit by COMMENT text. Reddit's comment search matches your keyword against comment bodies but returns the PARENT POSTS, not the individual comments, so each result is a post whose discussion mentions your query, carrying that post's title, selftext, score, and comment count. Use it to surface threads where a topic comes up in the replies that plain post-title search would miss. Reddit does not expose which specific comment matched or its text, so this returns posts, not comment bodies. Example: q='best mechanical keyboard' sort='top'.",
+    shape: { ...QUERY, ...SORT_SEARCH, ...TIME_SEARCH, ...AFTER, ...NSFW, ...LIMIT },
   },
   {
     name: "reddit_search_media",
@@ -124,7 +133,7 @@ export const TOOLS = [
         "Media type filter. 'image', 'video', 'gif', or 'all' (default). Filters the raw Reddit results to that media kind.",
       ),
       ...SORT_SEARCH,
-      ...TIME,
+      ...TIME_SEARCH,
       ...AFTER,
       ...NSFW,
       ...LIMIT,