reddit-mcp-server 1.4.7 → 1.5.0

package/CHANGELOG.md

@@ -2,6 +2,27 @@
 
 All notable changes to this project will be documented in this file.
 
+## [1.5.0] - 2026-06-22
+
+### Added
+
+- Cursor pagination (`after`) on listing tools: `get_top_posts`, `browse_subreddit`, `search_reddit`, `get_user_posts`, `get_user_comments` (tools render a "more results" hint with the next cursor)
+- Rate-limit resilience: transparent HTTP 429 retry honoring `Retry-After`/`x-ratelimit-reset` with exponential-backoff fallback (`REDDIT_MAX_RETRIES`, default 3)
+- `get_subreddit_rules` — a subreddit's posting rules
+- `get_post_flairs` — available link flairs; `create_post` now accepts `flair_id`/`flair_text`
+- `get_more_comments` — expand truncated "load more" comment stubs via `/api/morechildren`
+- Authenticated-user reads: `get_me`, `get_my_overview`, `get_my_saved`
+
+### Changed
+
+- Client error channel is now a typed discriminated ADT (`Either<RedditError, T>` — `HttpError`/`NotFoundError`/`ApiError`/`ValidationError`/`NotAuthenticatedError`/`UnknownError`) built on functype `Try`, replacing bare `Error`; observable error messages are unchanged
+- Removed an unused duplicate set of tool modules (`src/tools/*`); tools are defined inline in the server entry
+
+### Fixed
+
+- `get_me` no longer crashes in read-only mode — it now returns a clear `NotAuthenticatedError` when `REDDIT_USERNAME` is not configured
+- Flaky test failures caused by a duplicate `vi.mock` hoist race
+
 ## [1.0.7] - 2025-06-27
 
 ### Fixed

package/README.md

@@ -66,17 +66,18 @@ claude mcp add --transport stdio reddit -- npx reddit-mcp-server
 
 ### Read-only Tools
 
-| Tool                      | Description                                         |
-| ------------------------- | --------------------------------------------------- |
-| `get_reddit_post`         | Get a specific Reddit post with engagement analysis |
-| `get_top_posts`           | Get top posts from a subreddit or home feed         |
-| `get_user_info`           | Get detailed information about a Reddit user        |
-| `get_user_posts`          | Get posts submitted by a specific user              |
-| `get_user_comments`       | Get comments made by a specific user                |
-| `get_subreddit_info`      | Get subreddit details and statistics                |
-| `get_trending_subreddits` | Get currently trending subreddits                   |
-| `get_post_comments`       | Get comments from a specific post with threading    |
-| `search_reddit`           | Search for posts across Reddit                      |
+| Tool                      | Description                                                                 |
+| ------------------------- | --------------------------------------------------------------------------- |
+| `get_reddit_post`         | Get a specific Reddit post with engagement analysis                         |
+| `get_top_posts`           | Get top posts from a subreddit or home feed                                 |
+| `browse_subreddit`        | Browse a subreddit/home feed by sort (hot, new, top, rising, controversial) |
+| `get_user_info`           | Get detailed information about a Reddit user                                |
+| `get_user_posts`          | Get posts submitted by a specific user                                      |
+| `get_user_comments`       | Get comments made by a specific user                                        |
+| `get_subreddit_info`      | Get subreddit details and statistics                                        |
+| `get_trending_subreddits` | Get currently trending subreddits                                           |
+| `get_post_comments`       | Get comments from a specific post with threading                            |
+| `search_reddit`           | Search for posts across Reddit                                              |
 
 ### Write Tools (Require User Credentials)
 
@@ -93,17 +94,20 @@ claude mcp add --transport stdio reddit -- npx reddit-mcp-server
 
 ### Environment Variables
 
-| Variable                | Required | Default        | Description                                               |
-| ----------------------- | -------- | -------------- | --------------------------------------------------------- |
-| `REDDIT_CLIENT_ID`      | No\*     | -              | Reddit app client ID                                      |
-| `REDDIT_CLIENT_SECRET`  | No\*     | -              | Reddit app client secret                                  |
-| `REDDIT_USERNAME`       | No       | -              | Reddit username (for write operations)                    |
-| `REDDIT_PASSWORD`       | No       | -              | Reddit password (for write operations)                    |
-| `REDDIT_USER_AGENT`     | No       | Auto-generated | Custom User-Agent string                                  |
-| `REDDIT_AUTH_MODE`      | No       | `auto`         | Authentication mode: `auto`, `authenticated`, `anonymous` |
-| `REDDIT_SAFE_MODE`      | No       | `standard`     | Write safeguards: `off`, `standard`, `strict`             |
-| `REDDIT_BOT_DISCLOSURE` | No       | `off`          | Bot disclosure footer: `auto`, `off`                      |
-| `REDDIT_BOT_FOOTER`     | No       | Built-in       | Custom bot footer text (when disclosure is `auto`)        |
+| Variable                | Required | Default        | Description                                                   |
+| ----------------------- | -------- | -------------- | ------------------------------------------------------------- |
+| `REDDIT_CLIENT_ID`      | No\*     | -              | Reddit app client ID                                          |
+| `REDDIT_CLIENT_SECRET`  | No\*     | -              | Reddit app client secret                                      |
+| `REDDIT_USERNAME`       | No       | -              | Reddit username (for write operations)                        |
+| `REDDIT_PASSWORD`       | No       | -              | Reddit password (for write operations)                        |
+| `REDDIT_USER_AGENT`     | No       | Auto-generated | Custom User-Agent string                                      |
+| `REDDIT_AUTH_MODE`      | No       | `auto`         | Authentication mode: `auto`, `authenticated`, `anonymous`     |
+| `REDDIT_SAFE_MODE`      | No       | `standard`     | Write safeguards: `off`, `standard`, `strict`                 |
+| `REDDIT_BOT_DISCLOSURE` | No       | `off`          | Bot disclosure footer: `auto`, `off`                          |
+| `REDDIT_BOT_FOOTER`     | No       | Built-in       | Custom bot footer text (when disclosure is `auto`)            |
+| `REDDIT_CACHE`          | No       | `on`           | In-memory caching of read requests: `on`, `off`               |
+| `REDDIT_CACHE_MAX_MB`   | No       | `50`           | Cache size cap in MB (LRU eviction beyond this)               |
+| `REDDIT_MAX_RETRIES`    | No       | `3`            | Retries on HTTP 429 with Retry-After backoff (`0` to disable) |
 
 \*Required only if using `authenticated` mode.
 

package/dist/bin.js

@@ -3,12 +3,12 @@
 process.env.TRANSPORT_TYPE ??= "stdio";
 const args = process.argv.slice(2);
 if (args.includes("--version") || args.includes("-v")) {
-	console.log("1.4.7");
+	console.log("1.5.0");
 	process.exit(0);
 }
 if (args.includes("--help") || args.includes("-h")) {
 	console.log(`
-Reddit MCP Server v1.4.7
+Reddit MCP Server v1.5.0
 
 Usage: reddit-mcp-server [options]
 

package/dist/bin.js.map

@@ -1 +1 @@
-{"version":3,"file":"bin.js","names":[],"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n\ndeclare const __VERSION__: string\n\n// Force stdio mode for CLI/npx usage (unless explicitly overridden)\nprocess.env.TRANSPORT_TYPE ??= \"stdio\"\n\n// Handle command line arguments BEFORE any other imports\nconst args = process.argv.slice(2)\n\nif (args.includes(\"--version\") || args.includes(\"-v\")) {\n  console.log(__VERSION__)\n  process.exit(0)\n}\n\nif (args.includes(\"--help\") || args.includes(\"-h\")) {\n  console.log(`\nReddit MCP Server v${__VERSION__}\n\nUsage: reddit-mcp-server [options]\n\nOptions:\n  -v, --version        Show version number\n  -h, --help           Show help\n\nEnvironment Variables:\n  REDDIT_CLIENT_ID      Reddit API client ID (optional, for OAuth)\n  REDDIT_CLIENT_SECRET  Reddit API client secret (optional, for OAuth)\n  REDDIT_USERNAME       Reddit username (optional, for write operations)\n  REDDIT_PASSWORD       Reddit password (optional, for write operations)\n  REDDIT_USER_AGENT     Custom user agent (optional)\n  REDDIT_AUTH_MODE      Authentication mode: auto, authenticated, anonymous (default: auto)\n  REDDIT_SAFE_MODE      Spam protection: off, standard, strict (default: standard)\n  REDDIT_BOT_DISCLOSURE Bot disclosure footer: auto, off (default: off)\n  REDDIT_BOT_FOOTER     Custom bot footer text (optional, used with REDDIT_BOT_DISCLOSURE=auto)\n\nFor more information, visit: https://github.com/jordanburke/reddit-mcp-server\n`)\n  process.exit(0)\n}\n\n// Import and start server if not showing version/help\nasync function main() {\n  await import(\"./index.js\")\n}\n\nvoid main().catch(console.error)\n"],"mappings":";;AAKA,QAAQ,IAAI,mBAAmB;AAG/B,MAAM,OAAO,QAAQ,KAAK,MAAM,EAAE;AAElC,IAAI,KAAK,SAAS,YAAY,IAAI,KAAK,SAAS,KAAK,EAAE;AACrD,SAAQ,IAAA,QAAgB;AACxB,SAAQ,KAAK,EAAE;;AAGjB,IAAI,KAAK,SAAS,SAAS,IAAI,KAAK,SAAS,KAAK,EAAE;AAClD,SAAQ,IAAI;;;;;;;;;;;;;;;;;;;;;EAqBZ;AACA,SAAQ,KAAK,EAAE;;AAIjB,eAAe,OAAO;AACpB,OAAM,OAAO;;AAGV,MAAM,CAAC,MAAM,QAAQ,MAAM"}
+{"version":3,"file":"bin.js","names":[],"sources":["../src/bin.ts"],"sourcesContent":["#!/usr/bin/env node\n\ndeclare const __VERSION__: string\n\n// Force stdio mode for CLI/npx usage (unless explicitly overridden)\nprocess.env.TRANSPORT_TYPE ??= \"stdio\"\n\n// Handle command line arguments BEFORE any other imports\nconst args = process.argv.slice(2)\n\nif (args.includes(\"--version\") || args.includes(\"-v\")) {\n  console.log(__VERSION__)\n  process.exit(0)\n}\n\nif (args.includes(\"--help\") || args.includes(\"-h\")) {\n  console.log(`\nReddit MCP Server v${__VERSION__}\n\nUsage: reddit-mcp-server [options]\n\nOptions:\n  -v, --version        Show version number\n  -h, --help           Show help\n\nEnvironment Variables:\n  REDDIT_CLIENT_ID      Reddit API client ID (optional, for OAuth)\n  REDDIT_CLIENT_SECRET  Reddit API client secret (optional, for OAuth)\n  REDDIT_USERNAME       Reddit username (optional, for write operations)\n  REDDIT_PASSWORD       Reddit password (optional, for write operations)\n  REDDIT_USER_AGENT     Custom user agent (optional)\n  REDDIT_AUTH_MODE      Authentication mode: auto, authenticated, anonymous (default: auto)\n  REDDIT_SAFE_MODE      Spam protection: off, standard, strict (default: standard)\n  REDDIT_BOT_DISCLOSURE Bot disclosure footer: auto, off (default: off)\n  REDDIT_BOT_FOOTER     Custom bot footer text (optional, used with REDDIT_BOT_DISCLOSURE=auto)\n\nFor more information, visit: https://github.com/jordanburke/reddit-mcp-server\n`)\n  process.exit(0)\n}\n\n// Import and start server if not showing version/help\nasync function main() {\n  await import(\"./index.js\")\n}\n\nvoid main().catch(console.error)\n"],"mappings":";;AAKA,QAAQ,IAAI,mBAAmB;AAG/B,MAAM,OAAO,QAAQ,KAAK,MAAM,CAAC;AAEjC,IAAI,KAAK,SAAS,WAAW,KAAK,KAAK,SAAS,IAAI,GAAG;CACrD,QAAQ,IAAA,OAAe;CACvB,QAAQ,KAAK,CAAC;AAChB;AAEA,IAAI,KAAK,SAAS,QAAQ,KAAK,KAAK,SAAS,IAAI,GAAG;CAClD,QAAQ,IAAI;;;;;;;;;;;;;;;;;;;;;CAqBb;CACC,QAAQ,KAAK,CAAC;AAChB;AAGA,eAAe,OAAO;CACpB,MAAM,OAAO;AACf;AAEK,KAAK,CAAC,CAAC,MAAM,QAAQ,KAAK"}