redditapis-mcp 0.1.9 → 0.1.10

package/CHANGELOG.md

@@ -1,8 +1,21 @@
 # Changelog
 
+## 0.1.10
+- Three new read tools for community DISCOVERY (all $0.002, one upstream read each):
+  - **`reddit_subreddits_popular`** (`GET /api/reddit/subreddits/popular`), browse
+    the most-subscribed, trending subreddits right now, no keyword needed.
+  - **`reddit_subreddits_new`** (`GET /api/reddit/subreddits/new`), browse the
+    newest subreddits, the communities most recently created.
+  - **`reddit_subreddits_default`** (`GET /api/reddit/subreddits/default`), browse
+    Reddit's default front-page set of subreddits.
+  - Each returns a `subreddits` list (same per-item shape as
+    `reddit_subreddit_about`) plus an `after` cursor, and takes only `after` +
+    `limit`. These BROWSE communities; `reddit_search_communities` SEARCHES by
+    keyword. Brings the published read-only tool count to 20.
+
 ## 0.1.9
 - Two new read tools (both $0.002, one upstream read each):
-  - **`reddit_subreddit_rules`** (`GET /api/reddit/sub/{name}/rules`) — a
+  - **`reddit_subreddit_rules`** (`GET /api/reddit/sub/{name}/rules`), a
     subreddit's posting rules: each rule's name, description, what it applies to
     (posts, comments, or all), violation reason, priority, and creation date,
     plus Reddit's site-wide rules. Check a community's rules before posting.
@@ -24,10 +37,10 @@
   - **`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
+  - **`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
+  - **`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.

package/package.json

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

@@ -264,7 +264,7 @@ export const TOOLS = [
     name: "reddit_subreddit_rules",
     path: "/api/reddit/sub/{name}/rules",
     description:
-      "Fetch a subreddit's posting rules by name (Reddit's /r/<name>/about/rules data). Returns a `rules` list — each with name, description, what it applies to (posts, comments, or all), violation reason, priority, and creation date — plus a `site_rules` list of Reddit's site-wide rules. Use it to check a community's rules before posting or commenting. Example: name='python'.",
+      "Fetch a subreddit's posting rules by name (Reddit's /r/<name>/about/rules data). Returns a `rules` list, each with name, description, what it applies to (posts, comments, or all), violation reason, priority, and creation date, plus a `site_rules` list of Reddit's site-wide rules. Use it to check a community's rules before posting or commenting. Example: name='python'.",
     shape: {
       name: z.string().min(1).describe(
         "Subreddit name WITHOUT the r/ prefix (e.g. 'python'). Required (path parameter).",
@@ -282,6 +282,27 @@ export const TOOLS = [
       ),
     },
   },
+  {
+    name: "reddit_subreddits_popular",
+    path: "/api/reddit/subreddits/popular",
+    description:
+      "Browse the most-subscribed, trending subreddits right now, no keyword needed. Returns a `subreddits` list (each with name, title, subscriber count, description, type, and NSFW flag) plus an `after` cursor for paging. This BROWSES communities by popularity; use reddit_search_communities instead to SEARCH communities by keyword.",
+    shape: { ...AFTER, ...LIMIT },
+  },
+  {
+    name: "reddit_subreddits_new",
+    path: "/api/reddit/subreddits/new",
+    description:
+      "Browse the newest subreddits, the communities most recently created, no keyword needed. Returns a `subreddits` list (each with name, title, subscriber count, description, type, and NSFW flag) plus an `after` cursor for paging. This BROWSES communities by recency; use reddit_search_communities instead to SEARCH communities by keyword.",
+    shape: { ...AFTER, ...LIMIT },
+  },
+  {
+    name: "reddit_subreddits_default",
+    path: "/api/reddit/subreddits/default",
+    description:
+      "Browse Reddit's default front-page set of subreddits, no keyword needed. Returns a `subreddits` list (each with name, title, subscriber count, description, type, and NSFW flag) plus an `after` cursor for paging. This BROWSES the default communities; use reddit_search_communities instead to SEARCH communities by keyword.",
+    shape: { ...AFTER, ...LIMIT },
+  },
 ];
 
 // Turn tool args into a URL query string. Skips undefined/null/empty values.