uniqueness-mcp 0.4.0 → 0.4.2

package/index.mjs

@@ -15,7 +15,7 @@ const BASE = process.env.UNIQUENESS_API_URL || "https://uniquenessengine.com";
 const KEY = process.env.UNIQUENESS_API_KEY || "";
 
 // Keep in step with mcp/package.json — cli/release-parity.test.ts asserts they match.
-const server = new McpServer({ name: "uniqueness", version: "0.4.0" });
+const server = new McpServer({ name: "uniqueness", version: "0.4.2" });
 
 server.tool(
   "get_connection_brief",
@@ -23,7 +23,9 @@ server.tool(
     "verified personal + professional signal, each claim grounded in a source (`evidence_quote` + " +
     "`source_url`), identity-gated (returns needs_review rather than guessing). Each delivered brief " +
     "carries a `usage` object (cache_status, credits_charged, credits_remaining) and a `capabilities` " +
-    "block; a refusal or 0-fact brief is free. The response is COMPACT by default (identity + " +
+    "block; optional `usage.card_gate_notice` is the server-authored pre-wall next action and should " +
+    "be shown as-is rather than inferred from the balance. A refusal or 0-fact brief is free. " +
+    "The response is COMPACT by default (identity + " +
     "top-ranked facts + capabilities) — pass detail:'full' for the complete brief; set detail " +
     "explicitly. The removed fields outreach_angles / gift_hook / safe_to_use_in_outreach are declared " +
     "in `capabilities`, never returned. Machine-readable contract: " +
@@ -69,7 +71,23 @@ server.tool(
     });
     const subJson = await sub.json().catch(() => ({}));
     if (sub.status === 401) return { isError: true, content: [{ type: "text", text: "401 unauthorized — invalid API key." }] };
-    if (sub.status === 402) return { isError: true, content: [{ type: "text", text: "Out of credits. " + (subJson.message || "") }] };
+    if (sub.status === 402) {
+      if (subJson.error === "payment_method_required") {
+        const reason = subJson.reason === "daily_free_budget_reached"
+          ? "The shared daily free lookup budget is used. It resets daily; cached lookups still work. A completed purchase removes this cap."
+          : subJson.reason === "uncached_live_run"
+            ? "A card is required for another uncached live lookup. Any remaining credits still work on cached lookups."
+            : "This lookup is blocked by the card gate. Cached lookups still work.";
+        const setup = subJson.setup_url
+          ? ` POST ${subJson.setup_url} with the Bearer key and follow the Stripe URL it returns.`
+          : "";
+        return { isError: true, content: [{ type: "text", text: `Card gate: ${reason}${setup}` }] };
+      }
+      if (subJson.error === "insufficient_credits") {
+        return { isError: true, content: [{ type: "text", text: "Out of credits. Add credits or save a card with POST /api/billing/setup." }] };
+      }
+      return { isError: true, content: [{ type: "text", text: subJson.error || "Payment required." }] };
+    }
 
     // Fast path: cache hit / immediate brief.
     let brief = subJson.brief || null;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniqueness-mcp",
-  "version": "0.4.0",
+  "version": "0.4.2",
   "description": "MCP server for Uniqueness Engine — fact-checked connection briefs as an agent tool.",
   "type": "module",
   "bin": {