redditapis-mcp 0.1.3 → 0.1.5

package/CHANGELOG.md

@@ -1,5 +1,26 @@
 # Changelog
 
+## 0.1.5
+- Description honesty pass, three tool descriptions promised fields the live
+  response does not return. All found by the new V-DESC gate
+  (reconcile-description-shape.mjs), which probes EVERY tool against the live API
+  and asserts no description claims a field the response lacks:
+  - `reddit_search_media` claimed a `permalink`; the response carries `url`. Corrected.
+  - `reddit_subreddit_posts` claimed `flair` and `media`; neither is in the
+    `/posts` response (fields are title, author, upvotes, comments, permalink, url,
+    text). Removed.
+  - `reddit_post` claimed `body/selftext` and `media`; `/post/{id}` returns `text`
+    (no `body`, no `selftext`, no `media`). Corrected to `text`.
+
+## 0.1.4
+- New tool `reddit_deep_comment_search`. Where `reddit_search_comments` returns
+  the parent posts (Reddit's comment search never hands back the comment), this
+  returns the ACTUAL matching comments with body, score, author, a comment-deep
+  permalink, and the parent post. It fetches each matching post's comment tree
+  and filters the bodies. Premium call (`limit` = parent posts to expand, 1-10).
+  Best-effort: a deleted or deeply-nested comment may be missed. Also cross-links
+  the two tools in their descriptions.
+
 ## 0.1.3
 - `reddit_search_comments` description no longer overpromises. It previously
   claimed to "Return matching comments with author, body, score" and to find

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "redditapis-mcp",
-  "version": "0.1.3",
+  "version": "0.1.5",
   "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

@@ -69,7 +69,7 @@ export const TOOLS = [
     name: "reddit_subreddit_posts",
     path: "/api/reddit/posts",
     description:
-      "List posts from a subreddit by sort order. Use this to read a community's feed: newest, hot/trending, top-of-week, rising, etc. Returns post title, author, score, comment count, permalink, flair, and media, plus an `after` cursor for paging. Example: subreddit='programming' sort='top' t='week'.",
+      "List posts from a subreddit by sort order. Use this to read a community's feed: newest, hot/trending, top-of-week, rising, etc. Returns post title, author, score, comment count, and permalink, plus an `after` cursor for paging. Example: subreddit='programming' sort='top' t='week'.",
     shape: {
       subreddit: z.string().min(1).describe(
         "Subreddit name WITHOUT the r/ prefix (e.g. 'programming', 'AskReddit'). Required.",
@@ -119,14 +119,29 @@ export const TOOLS = [
     name: "reddit_search_comments",
     path: "/api/reddit/search/comments",
     description:
-      "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'.",
+      "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. For the actual comment bodies, use reddit_deep_comment_search. Example: q='best mechanical keyboard' sort='top'.",
     shape: { ...QUERY, ...SORT_SEARCH, ...TIME_SEARCH, ...AFTER, ...NSFW, ...LIMIT },
   },
+  {
+    name: "reddit_deep_comment_search",
+    path: "/api/reddit/search/comments/deep",
+    description:
+      "Genuine comment search: returns the ACTUAL comments whose body matches your keyword, with body, score, author, a comment-deep permalink, and the parent post. Unlike reddit_search_comments (which returns the parent posts, a Reddit limitation), this fetches each matching post's comment tree and filters the comment bodies for you, so you get first-hand opinions and answers directly. Premium call (it fans out into several reads): `limit` sets how many parent POSTS to expand, 1-10 (default 5), not how many comments come back. Best-effort: a deleted or deeply-nested comment may be missed (a truncated flag says when a tree was too deep). Example: q='best mechanical keyboard' sort='top'.",
+    shape: {
+      ...QUERY,
+      ...SORT_SEARCH,
+      ...TIME_SEARCH,
+      ...NSFW,
+      limit: z.number().int().min(1).max(10).optional().describe(
+        "Number of parent POSTS to expand into their comment trees (1-10, default 5). Each is one upstream read, so higher = deeper coverage but slower and more expensive.",
+      ),
+    },
+  },
   {
     name: "reddit_search_media",
     path: "/api/reddit/search/media",
     description:
-      "Search Reddit posts filtered to media (images, video, gifs). Returns media posts with the media URL/type, author, score, and permalink. Use `kind` to narrow to a media type. Example: q='aurora borealis' kind='image'.",
+      "Search Reddit posts filtered to media (images, video, gifs). Returns media posts with the media URL/type, author, score, and the post url. Use `kind` to narrow to a media type. Example: q='aurora borealis' kind='image'.",
     shape: {
       ...QUERY,
       kind: z.enum(["image", "video", "gif", "all"]).optional().describe(
@@ -164,7 +179,7 @@ export const TOOLS = [
     name: "reddit_post",
     path: "/api/reddit/post/{id}",
     description:
-      "Fetch a single Reddit post by its id. Returns the full post object (title, author, score, body/selftext, media, permalink, subreddit). Use when you already have a post id and want its details. Example: id='abc123' (the base-36 id, no t3_ prefix).",
+      "Fetch a single Reddit post by its id. Returns the full post object (title, author, score, text, permalink, subreddit, url). Use when you already have a post id and want its details. Example: id='abc123' (the base-36 id, no t3_ prefix).",
     shape: {
       id: z.string().min(1).describe(
         "The post's base-36 id (e.g. 'abc123'), without the 't3_' fullname prefix. Required (path parameter).",