redditapis-mcp 0.5.0 → 0.5.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # Changelog
 
+## 0.5.2 (2026-09-06)
+
+### Added
+
+- **`reddit_post_visibility`.** Is a post still publicly visible, or did it quietly stop being so? A removed Reddit post still returns when you fetch it by id, with its title and score, so asking the post does not answer the question. This fetches the post and then one page of its author's submitted listing and compares them, returning a verdict of `live`, `not_visible` or `undecidable` with a plain-language reason and a `confident` flag. It never says WHY a post is not visible: a moderator removal, an admin removal, a spam filter and an author who has hidden their post history are indistinguishable from outside, and only one of them is a removal. `undecidable` is a real answer, not a failure. Two upstream calls, billed as one request at $0.004.
+
+## 0.5.1 (2026-09-06)
+
+### Fixed
+
+- **The npm package page was showing a description cut off mid-word.** `package.json` carried a 394-character description; npm stores at most 255 and truncates the rest without an error or a warning, so the visible end of the description on npmjs.com was the fragment `register/test/dele`. 139 characters were being silently discarded. Measured against `registry.npmjs.org` rather than guessed. The description is now 249 characters and ends as a sentence, and `scripts/prepublish-tenant-check.mjs` refuses to publish one that is over the bound or that does not end in a full stop, the second check being the one that catches a cut string regardless of its length.
+
 ## 0.5.0 (2026-09-06)
 
 ### Added

package/README.md

@@ -139,6 +139,7 @@ A few conventions across the catalog:
 
 | Tool | Endpoint | What it does |
 |---|---|---|
+| `reddit_post_visibility` | `GET /api/reddit/post/{id}/visibility` | Is a post still publicly visible, or did it quietly stop being so? Fetches the post and one page of its author's listing and compares. Returns `live`, `not_visible` or `undecidable` with a reason, and never claims to know WHY. Two upstream calls, $0.004. |
 | `reddit_post` | `GET /api/reddit/post/{id}` | A single post by its base-36 `id` (no `t3_` prefix): title, author, score, text, permalink, subreddit, url. |
 | `reddit_post_comments` | `GET /api/reddit/comments` | A post plus its full threaded comment tree, fetched by `permalink`. |
 | `reddit_by_id` | `GET /api/reddit/by_id/{fullnames}` | Bulk-hydrate up to 100 posts in one call from a comma-separated list of `t3_` fullnames. |
@@ -183,6 +184,7 @@ Modelled on Claude Code's own feedback tool. When a call fails in a way that is
 | Tool | Endpoint | What it does |
 |------|----------|--------------|
 | `reddit_feedback_send` | `POST /feedback` | `action: "draft"` (default) queues a report locally and sends nothing; `"list"` shows the queue; `"send"` posts only the drafts you name; `"discard"` drops them. |
+| `reddit_account_me` | `GET /account/me` | How much credit this key has left, before spending any. Free, never metered. |
 | `reddit_feedback_get` | `GET /feedback/{id}` | Read a sent report's status (`new`, `triaged`, `shipped`, `declined`) and the team's response. |
 
 ## Usage examples

package/package.json

@@ -1,8 +1,8 @@
 {
   "name": "redditapis-mcp",
-  "version": "0.5.0",
+  "version": "0.5.2",
   "mcpName": "io.github.redditapis/redditapis-mcp",
-  "description": "Official MCP server for redditapis.com, the Reddit API (subreddit listings, post + comment + community + user + media search, comment trees, top posts, user profiles) plus monitor/webhook management (create/list/update/remove a monitor, register/test/delete a webhook, read delivery history) and user-reviewed product feedback to the team as native tools for Claude, Cursor, and any MCP client.",
+  "description": "Official MCP server for redditapis.com. Search Reddit posts, comments, communities, users and media; read subreddits, comment trees, top posts and profiles; create and manage monitors and webhooks. Native tools for Claude, Cursor and any MCP client.",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/redditapis/redditapis-mcp.git"

package/src/tools.js

@@ -290,6 +290,21 @@ export const TOOLS = [
       sort_type: z.enum(["score", "num_comments", "created"]).optional().describe("Re-sort the filtered page (descending) by this field."),
     },
   },
+  {
+    name: "reddit_post_visibility",
+    path: "/api/reddit/post/:id/visibility",
+    description:
+      "Is a post still publicly visible, or did it quietly stop being so? A removed Reddit post still " +
+      "returns when you fetch it by id, so asking the post does not answer this. This fetches the post " +
+      "and then one page of its author's submitted listing and compares them. Returns a verdict of live, " +
+      "not_visible or undecidable, a plain-language reason, and a confident flag. It deliberately never " +
+      "says WHY a post is not visible: a moderator removal, an admin removal, a spam filter and an author " +
+      "who has hidden their history are indistinguishable from outside. undecidable is a real answer, not " +
+      "a failure. Two upstream calls, billed as one $0.004 dual read.",
+    shape: {
+      id: z.string().min(1).describe("Reddit post id, base36, with or without the t3_ prefix"),
+    },
+  },
   {
     name: "reddit_post_comments",
     path: "/api/reddit/comments",
@@ -762,6 +777,26 @@ export const TOOLS = [
       ),
     },
   },
+  {
+    // CHECK BEFORE YOU SPEND. An agent planning a costed run has no way to ask
+    // how much credit is left, so it either runs blind and hits a 402 partway
+    // through, or it asks the user to go and look. Both are avoidable: the
+    // endpoint already exists and is already free.
+    //
+    // GET /account/me is mounted OUTSIDE /api (server.js), ahead of bearerAuth,
+    // under a comment reading "Free account endpoints live in apps/backend". So
+    // this tool bills nothing and is safe to call before every plan.
+    //
+    // Path verified against the live origin rather than read off the route
+    // tree: /account/me returns 401 unauthenticated while /account/<nonsense>
+    // returns 404, which is how we know the route exists. (/api/<anything>
+    // returns 401 for everything, so that path could not have told us.)
+    name: "reddit_account_me",
+    path: "/account/me",
+    description:
+      "How much credit this API key has left, before spending any. Returns the account's remaining credit balance and usage totals. FREE: this call is not metered and never costs a credit, so call it whenever you are about to run something expensive rather than guessing. Use it to decide whether a planned batch fits in the remaining balance, and to tell the user how much is left if a call returns 402. A 402 from any other tool means the balance is exhausted; its response carries a top-up URL to give the user.",
+    shape: {},
+  },
   {
     name: "reddit_feedback_get",
     path: "/feedback/{id}",