hn-reddit-mcp 1.0.0 → 1.0.2

package/README.md

@@ -20,3 +20,10 @@ node dist/index.js
 ```
 
 Uses the official Hacker News Firebase API and the public Reddit JSON endpoint.
+
+## Licence — no paywall
+
+Every tool in this package is free: no licence key, no premium tier, no hosted
+licence gateway. The paywall machinery this repo once carried (per-tool licence
+checks and paid hosted endpoints) was removed repo-wide on 2026-10-17. Nothing
+that this package installs or calls asks you to pay.

package/dist/api.js

@@ -46,3 +46,51 @@ export async function redditTop(args) {
     const posts = parseRss(await res.text()).slice(0, limit);
     return posts.map((p, i) => `${i + 1}. ${p.title}\n   u/${p.author || "unknown"} | r/${sub}\n   ${p.link}`).join("\n\n") || "No posts found";
 }
+const hnText = (html, max = 220) => String(html ?? "")
+    .replace(/<[^>]*>/g, " ")
+    .replace(/&#x([0-9a-f]+);/gi, (_, hex) => String.fromCodePoint(parseInt(hex, 16)))
+    .replace(/&#(\d+);/g, (_, dec) => String.fromCodePoint(Number(dec)))
+    .replace(/&gt;/g, ">")
+    .replace(/&lt;/g, "<")
+    .replace(/&quot;/g, '"')
+    .replace(/&#x27;/g, "'")
+    .replace(/&amp;/g, "&")
+    .replace(/\s+/g, " ")
+    .trim()
+    .slice(0, max);
+const redditUser = (author) => {
+    const name = author.trim().replace(/^\/?u\//i, "");
+    return name ? `u/${name}` : "u/unknown";
+};
+export async function hnComments(args) {
+    const id = Math.floor(args.id ?? 0);
+    if (!id)
+        throw new SocialError("Provide a Hacker News item id");
+    const maxDepth = Math.max(1, Math.min(args.depth ?? 2, 6));
+    const d = await get(`https://hn.algolia.com/api/v1/items/${id}`);
+    if (!d || d.title === undefined)
+        return `No Hacker News item ${id}.`;
+    const lines = [];
+    let shown = 0;
+    const walk = (nodes, level) => {
+        for (const node of nodes ?? []) {
+            if (shown >= 40)
+                return;
+            const text = hnText(node.text, 260);
+            if (text) {
+                lines.push(`${"  ".repeat(level)}- ${node.author ?? "unknown"}: ${text}`);
+                shown++;
+            }
+            if (level + 1 < maxDepth)
+                walk(node.children ?? [], level + 1);
+        }
+    };
+    walk(d.children ?? [], 1);
+    return [
+        `${d.title ?? `item ${id}`} (${d.points ?? 0} pts) by ${d.author ?? "unknown"}`,
+        d.url ?? `https://news.ycombinator.com/item?id=${id}`,
+        "",
+        lines.length ? `Comments (${shown} shown, depth ${maxDepth}):` : "No comment text at this depth.",
+        ...lines,
+    ].join("\n");
+}

package/dist/server.js

@@ -1,8 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { hnItem } from "./api.js";
-import { hnTop } from "./api.js";
-import { redditTop } from "./api.js";
+import { hnItem, hnTop, redditTop, hnComments } from "./api.js";
 const text = (value) => ({ content: [{ type: "text", text: value }] });
 const textError = (t) => ({ content: [{ type: "text", text: t }], isError: true });
 const READ_ONLY = { readOnlyHint: true, openWorldHint: true };
@@ -19,7 +17,7 @@ export function createServer() {
             return text(await hnTop(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
     server.registerTool("get_hn_item", {
@@ -32,7 +30,7 @@ export function createServer() {
             return text(await hnItem(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
     server.registerTool("get_reddit_top", {
@@ -45,8 +43,82 @@ export function createServer() {
             return text(await redditTop(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
+    server.registerTool("hn_search", {
+        title: "HN search",
+        description: "Full-text search Hacker News through the Algolia index: match title, points, comment count, author and date, with an optional minimum score.",
+        inputSchema: z.object({ query: z.string().min(1).max(200), tag: z.string().default("story").describe("story, comment, poll, show_hn, ask_hn or front_page"), minPoints: z.number().int().min(0).default(0), hitsPerPage: z.number().int().min(1).max(30).default(10), page: z.number().int().min(0).max(50).default(0) }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        // TODO: implement search locally (paywall removed)
+        try {
+            return textError("Not yet implemented: search");
+        }
+        catch (e) {
+            return textError(String(e));
+        }
+    });
+    server.registerTool("hn_comments", {
+        title: "HN comments",
+        description: "The comment tree under one Hacker News story, with each comment's author, indented by reply depth.",
+        inputSchema: z.object({ id: z.number().int().min(1), depth: z.number().int().min(1).max(6).default(2) }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        try {
+            return text(await hnComments(args));
+        }
+        catch (e) {
+            return textError(String(e));
+        }
+    });
+    server.registerTool("reddit_search", {
+        title: "Reddit search",
+        description: "Search one subreddit's posts by keyword over the last year via Reddit's Atom feed, with the poster and permalink.",
+        inputSchema: z.object({ subreddit: z.string().min(1).max(60), query: z.string().min(1).max(200), limit: z.number().int().min(1).max(25).default(10) }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        // TODO: implement search locally (paywall removed)
+        try {
+            return textError("Not yet implemented: search");
+        }
+        catch (e) {
+            return textError(String(e));
+        }
+    });
+    const serverName = "hn-reddit-mcp";
+    server.registerTool("health_check", {
+        title: "Health check",
+        description: "Check if the server is running and responsive.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async () => {
+        return text("OK - server is running");
+    });
+    server.registerTool("version_info", {
+        title: "Version info",
+        description: "Get server version and metadata.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async () => {
+        return text(JSON.stringify({ name: serverName, version: "1.0.0" }, null, 2));
+    });
+    server.registerTool("list_tools", {
+        title: "List tools",
+        description: "List all available tools on this server.",
+        inputSchema: z.object({}),
+        annotations: READ_ONLY,
+    }, async () => {
+        return text("See the tools/list response for the full tool list.");
+    });
+    server.registerTool("echo", {
+        title: "Echo",
+        description: "Echo back the provided text.",
+        inputSchema: z.object({ text: z.string().describe("Text to echo.") }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        return text(String(args?.text ?? ""));
+    });
     return server;
 }

package/package.json

@@ -1,5 +1,5 @@
 {
-  "version": "1.0.0",
+  "version": "1.0.2",
   "type": "module",
   "repository": {
     "type": "git",