gadgethumans-mcp 1.1.0 → 1.2.1

package/index.js

@@ -17,13 +17,29 @@ import {
   ListToolsRequestSchema,
 } from "@modelcontextprotocol/sdk/types.js";
 
+const VERSION = require("./package.json").version;
 const ENDPOINT = process.env.MCP_ENDPOINT || "https://api.gadgethumans.com/mcp";
 const API_KEY =
   process.env.GADGETHUMANS_API_KEY || process.env.GADGETHUMANS_CREDITS_KEY || "";
 const BUY_URL = "https://api.gadgethumans.com/buy-credits";
+const REST_BASE = process.env.GADGETHUMANS_REST || "https://api.gadgethumans.com";
+
+// A 402 is the moment a caller decides whether we are real. Give it a ready-to-run
+// proof call instead of a pricing lecture: most tool names are the REST route's own
+// slug, so the same tool can be answered free (3/day per IP) with ?trial=1.
+function trialUrl(name, args) {
+  if (!/^[a-z0-9][a-z0-9._-]{0,60}$/i.test(name || "")) return "";
+  const qs = new URLSearchParams();
+  for (const [k, v] of Object.entries(args || {})) {
+    if (v === undefined || v === null || typeof v === "object") continue;
+    qs.set(k, String(v));
+  }
+  qs.set("trial", "1");
+  return `${REST_BASE}/${name}?${qs.toString()}`;
+}
 
 const server = new Server(
-  { name: "gadgethumans-mcp", version: "1.1.0" },
+  { name: "gadgethumans-mcp", version: "1.2.0" },
   { capabilities: { tools: {} } }
 );
 
@@ -33,6 +49,9 @@ function rpcHeaders() {
   const h = {
     "Content-Type": "application/json",
     Accept: "application/json, text/event-stream",
+    // Identify the channel: without a UA every install lands in our "other" bucket and gets no
+    // trial, which is exactly how 1,597 installs/week produced zero calls.
+    "User-Agent": "gadgethumans-mcp/" + VERSION + " (agent-runtime; mcp-host; node)",
   };
   if (API_KEY) h["x-api-key"] = API_KEY;
   return h;
@@ -88,11 +107,18 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
     const { res, text } = await rpc("tools/call", { name, arguments: args || {} });
 
     if (res.status === 402) {
+      const free = trialUrl(name, args);
       const hint = API_KEY
-        ? `The credits key on this install has no balance left. Top up at ${BUY_URL}?pack=500 ($5 = 500 calls) and set GADGETHUMANS_API_KEY to the key it returns.`
+        ? [
+            `The credits key on this install has no balance left. Top up at ${BUY_URL}?pack=500 ($5 = 500 calls) and set GADGETHUMANS_API_KEY to the key it returns.`,
+            free ? `\nOr check the answer for free (3 calls/day per IP, no key, no wallet):\n  curl "${free}"` : "",
+          ].join("\n")
         : [
-            "This tool is priced per call. Two ways to pay:",
+            "This tool is priced per call. Two ways to pay — and one way to check us for free:",
             "",
+            free
+              ? `0. Free proof call, right now — 3 answered calls/day per IP, no key, no wallet:\n   curl "${free}"\n`
+              : "",
             "1. Prepaid credits — works in any MCP client, no wallet needed:",
             `   buy at ${BUY_URL}?pack=500  ($5 = 500 calls; 1 credit = $0.01)`,
             "   the purchase returns an api_key; set it and restart:",

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "gadgethumans-mcp",
-  "version": "1.1.0",
-  "description": "MCP server for the GadgetHumans API: 216 tools in one install (ocr, ens, token safety, translate, sentiment, whois, hash, geocode, dns, weather, vat, timezone, ip, search, and a free x402 catalogue search ranked by measured 30-day call volume). Prepaid credits key or x402 USDC on Base.",
+  "version": "1.2.1",
+  "description": "MCP server for the GadgetHumans API: 226 tools in one install (ocr, ens, token safety, translate, sentiment, whois, hash, geocode, dns, weather, vat, timezone, ip, search, and a free x402 catalogue search ranked by measured 30-day call volume). Prepaid credits key or x402 USDC on Base.",
   "mcpName": "com.gadgethumans/gadgethumans-mcp",
   "type": "module",
   "main": "index.js",