redditapis-mcp 0.1.4 → 0.1.6

package/CHANGELOG.md

@@ -1,5 +1,34 @@
 # Changelog
 
+## 0.1.6
+- `reddit_deep_comment_search` v1.1, driven by a customer report that there was
+  no reliable way to expand a search past the first few posts:
+  - **Pagination.** The response `after` cursor is now honoured on input — pass it
+    back as `after` to expand the next batch of parent posts. Each call stays
+    bounded, so a caller can page as deep as they want. (The cursor was previously
+    returned but ignored.)
+  - **`limit` cap raised 10 -> 25** parent posts per call.
+  - **`max_comments`** optional cap on how many comments are returned; the
+    highest-scored are kept.
+  - Comments now come back **sorted by score** (highest first).
+  - Honest completeness meta: `comments_matched` (found) vs `comments_returned`
+    (after cap) vs `capped`, alongside `truncated`.
+  - Matching now runs on the **visible comment text at word boundaries** (link
+    URLs stripped), so a result always mentions the query where a reader can see
+    it — fixes the false positives from matching inside link URLs / as substrings.
+
+## 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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "redditapis-mcp",
-  "version": "0.1.4",
+  "version": "0.1.6",
   "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.",
@@ -126,14 +126,18 @@ export const TOOLS = [
     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'.",
+      "Genuine comment search: returns the ACTUAL comments whose body matches your keyword, sorted by score (highest first), 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-25 (default 5), not how many comments come back. To go deeper than one call, paginate: pass the response's `after` cursor back as `after` to expand the NEXT batch of parent posts. `max_comments` optionally caps how many comments come back (the top-scored are kept). Matching is on the visible comment text at word boundaries (link URLs are ignored), so a result always mentions your query where a reader can see it. Best-effort: a deleted or deeply-nested comment may be missed (meta.truncated flags 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.",
+      ...AFTER,
+      limit: z.number().int().min(1).max(25).optional().describe(
+        "Number of parent POSTS to expand into their comment trees (1-25, default 5). Each is one upstream read, so higher = deeper coverage but slower and more expensive. To go past 25, paginate with `after`.",
+      ),
+      max_comments: z.number().int().min(1).optional().describe(
+        "Optional cap on how many comments are returned; the highest-scored are kept. Omit to return every match. meta.capped is true when this trimmed the result.",
       ),
     },
   },
@@ -141,7 +145,7 @@ export const TOOLS = [
     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(
@@ -179,7 +183,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).",