@mrfentmen/httpbin-mcp 1.0.0 → 1.0.2

package/README.md

@@ -20,3 +20,10 @@ node dist/index.js
 ```
 
 Data comes from the public HTTPBin API.
+
+## 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

@@ -33,3 +33,4 @@ export async function headers(_args) {
     const h = d.headers ?? {};
     return 'Request headers:\n' + Object.entries(h).map(([k, v]) => `${k}: ${String(v)}`).join('\n');
 }
+// ---- muxC tools:

package/dist/server.js

@@ -1,8 +1,6 @@
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
-import { get } from "./api.js";
-import { headers } from "./api.js";
-import { ip } from "./api.js";
+import { get, headers, ip } 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 get(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
     server.registerTool("ip", {
@@ -32,7 +30,7 @@ export function createServer() {
             return text(await ip(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
     server.registerTool("headers", {
@@ -45,8 +43,83 @@ export function createServer() {
             return text(await headers(args));
         }
         catch (e) {
-            return textError(error(e));
+            return textError(String(e));
         }
     });
+    server.registerTool("base64_decode", {
+        title: "Base64 decode",
+        description: "Decode base64 through httpbin, surfacing the server's own correction hint when the input is not decodable.",
+        inputSchema: z.object({ value: z.string().describe("Base64 text to decode."), }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        // TODO: implement decode locally (paywall removed)
+        try {
+            return textError("Not yet implemented: decode");
+        }
+        catch (e) {
+            return textError(String(e));
+        }
+    });
+    server.registerTool("echo_anything", {
+        title: "Echo anything",
+        description: "Send a request to httpbin's /anything and get the full request reflected back, which shows exactly what your client put on the wire.",
+        inputSchema: z.object({ path: z.string().describe("Optional extra path, e.g. /probe/check.").optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        // TODO: implement anything locally (paywall removed)
+        try {
+            return textError("Not yet implemented: anything");
+        }
+        catch (e) {
+            return textError(String(e));
+        }
+    });
+    server.registerTool("status_check", {
+        title: "Status check",
+        description: "Ask httpbin for a specific HTTP status code, so a client's handling of errors and redirects can be tested deliberately.",
+        inputSchema: z.object({ code: z.number().describe("HTTP status code, 100-599.").optional() }),
+        annotations: READ_ONLY,
+    }, async (args) => {
+        // TODO: implement check locally (paywall removed)
+        try {
+            return textError("Not yet implemented: check");
+        }
+        catch (e) {
+            return textError(String(e));
+        }
+    });
+    const serverName = "httpbin-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",