redditapis-mcp 0.1.8 → 0.1.10

package/CHANGELOG.md

@@ -1,5 +1,29 @@
 # 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
+    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.
+  - **`reddit_by_id`** (`GET /api/reddit/by_id/{fullnames}`) — bulk-fetch posts
+    by comma-separated t3_ fullnames (up to 100) in one call. Same post shape as
+    the subreddit listings. Hydrate ids you already have without a call per post.
+  - Brings the published read-only tool count to 17.
+
 ## 0.1.8
 - **`reddit_deep_comment_search`** gains a research mode: pass `group_by="author"`
   to get the distinct PEOPLE who mentioned your query (ranked by matching-comment
@@ -13,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.8",
+  "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

@@ -260,6 +260,49 @@ 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'.",
+    shape: {
+      name: z.string().min(1).describe(
+        "Subreddit name WITHOUT the r/ prefix (e.g. 'python'). Required (path parameter).",
+      ),
+    },
+  },
+  {
+    name: "reddit_by_id",
+    path: "/api/reddit/by_id/{fullnames}",
+    description:
+      "Bulk-fetch posts by their t3_ fullnames in ONE call (up to 100), instead of a request per post. Pass a comma-separated list of fullnames you already have from a search or listing to hydrate them. Returns posts with title, author, score, comment count, and permalink — the same post shape as the listing endpoints. An unknown id is simply absent from the result. Example: fullnames='t3_abc123,t3_def456'.",
+    shape: {
+      fullnames: z.string().min(1).describe(
+        "Comma-separated post fullnames, each a t3_ prefix followed by the base-36 id (e.g. 't3_abc123,t3_def456'). Up to 100. Required (path parameter).",
+      ),
+    },
+  },
+  {
+    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.