redditapis-mcp 0.1.5 → 0.1.7

package/CHANGELOG.md

@@ -1,5 +1,35 @@
 # Changelog
 
+## 0.1.7
+- Three new read tools (all $0.002, one upstream read each):
+  - **`reddit_user_submitted`** (`GET /api/reddit/user/{name}/submitted`) — a
+    user's submitted POSTS, the sibling of `reddit_user_comments`. Same post
+    shape as the subreddit listings.
+  - **`reddit_subreddit_comments`** (`GET /api/reddit/sub/{name}/comments`) — the
+    subreddit NEW-COMMENT stream (every new comment across a community, not one
+    post's thread). Same comment shape as `reddit_user_comments`.
+  - **`reddit_subreddit_about`** (`GET /api/reddit/sub/{name}/about`) — a
+    subreddit's public metadata (title, public description, subscriber count,
+    active-user count, creation date, type, NSFW flag). Returns a single object.
+  - Brings the published read-only tool count to 15.
+
+## 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

package/package.json

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

@@ -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.",
       ),
     },
   },
@@ -211,6 +215,45 @@ export const TOOLS = [
       ...LIMIT,
     },
   },
+  {
+    name: "reddit_user_submitted",
+    path: "/api/reddit/user/{name}/submitted",
+    description:
+      "List a Reddit user's submitted POSTS (their post history, the sibling of reddit_user_comments). Returns posts with title, author, score, comment count, and permalink, plus an `after` cursor. Use to see what a redditor posts, not just what they comment on. Example: name='spez' sort='top'.",
+    shape: {
+      name: z.string().min(1).describe(
+        "Reddit username WITHOUT the u/ prefix (e.g. 'spez'). Required (path parameter).",
+      ),
+      ...SORT_USER,
+      ...TIME,
+      ...AFTER,
+      ...LIMIT,
+    },
+  },
+  {
+    name: "reddit_subreddit_comments",
+    path: "/api/reddit/sub/{name}/comments",
+    description:
+      "Stream the NEWEST comments across an entire subreddit (Reddit's /r/<name>/comments feed), not one post's thread. Returns comments with body, author, score, subreddit, the parent post link, and timestamp, plus an `after` cursor. Poll it to catch new comments in a community as they are posted. Example: name='python'.",
+    shape: {
+      name: z.string().min(1).describe(
+        "Subreddit name WITHOUT the r/ prefix (e.g. 'python'). Required (path parameter).",
+      ),
+      ...AFTER,
+      ...LIMIT,
+    },
+  },
+  {
+    name: "reddit_subreddit_about",
+    path: "/api/reddit/sub/{name}/about",
+    description:
+      "Fetch a subreddit's public metadata by name (Reddit's /r/<name>/about data). Returns the subreddit's title, public description, subscriber count, active-user count, creation timestamp, type, and NSFW flag. Use it to size or vet a community before listing or searching its posts. Example: name='python'.",
+    shape: {
+      name: z.string().min(1).describe(
+        "Subreddit name WITHOUT the r/ prefix (e.g. 'python'). Required (path parameter).",
+      ),
+    },
+  },
 ];
 
 // Turn tool args into a URL query string. Skips undefined/null/empty values.