uniqueness-mcp 0.8.0 → 0.8.2

package/README.md

@@ -8,7 +8,7 @@ Connect remote-capable clients to:
 
 `https://uniquenessengine.com/mcp`
 
-Send `Authorization: Bearer uq_live_...` on every request. Hosted tool-catalog fixes arrive without reinstalling this package.
+Send `Authorization: Bearer uq_live_...` on every request. Hosted tool-catalog fixes arrive without reinstalling this package. `uniqueness update` updates the CLI only, not this package. There is no rotate-key tool.
 
 Do not pin an old version. `uniqueness-mcp@0.1.1` and `@0.6.0` expose a stale catalog. Use `@latest` or the hosted endpoint.
 
@@ -36,7 +36,7 @@ Requires Node 18+. After changing the pin, start a new client session so the too
 
 Hosted and stdio both expose:
 
-- `get_personal_context` (`get_connection_brief`)
+- `get_personal_context` (`get_connection_brief`) — optional `refresh:true` to force a fresh collection. Omit for ordinary repeat reads. Batch tools do not accept refresh.
 - `resume_personal_context` (`resume_connection_brief`)
 - `get_billing_status`
 - `request_higher_limits`

package/dist/server.js

@@ -2,7 +2,7 @@ import { randomUUID } from "node:crypto";
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { z } from "zod";
 export const MCP_SERVER_NAME = "uniqueness";
-export const MCP_SERVER_VERSION = "0.8.0";
+export const MCP_SERVER_VERSION = "0.8.2";
 export const MCP_TOOL_ALIASES = {
     get_personal_context: ["get_connection_brief"],
     resume_personal_context: ["resume_connection_brief"],
@@ -108,12 +108,18 @@ const briefShape = {
     company: z.string().optional().describe("Company name (use with name)"),
     email: z.string().optional().describe("Work email (optional disambiguator)"),
     detail: detailSchema.describe('Response shape. Defaults to "compact"; use "full" for provenance sub-scores.'),
+    refresh: z
+        .boolean()
+        .optional()
+        .describe("Set true only when the user asks to rerun, refresh, run again, look again, re-enrich, or check whether new UE changes are working. Ordinary repeat reads must omit this. Do not resubmit while polling an existing job."),
 };
 function cleanBriefArgs(args) {
     const body = {};
     for (const key of ["linkedin_url", "name", "company", "email", "detail"])
         if (args[key])
             body[key] = args[key];
+    if (typeof args.refresh === "boolean")
+        body.refresh = args.refresh;
     if (!body.detail)
         body.detail = "compact";
     return body;
@@ -285,7 +291,12 @@ export function createMcpServer(context) {
         });
     };
     const registerBrief = (name, description) => server.registerTool(name, { description, inputSchema: briefShape }, async (args) => submitBrief(args));
-    registerBrief("get_personal_context", "Submit one full-quality written enrichment. Returns an inline result or a job_id for get_connection_brief_job.");
+    registerBrief("get_personal_context", "Submit one full-quality written enrichment. Returns an inline result or a job_id for get_connection_brief_job. " +
+        "Use refresh=true only when the user says rerun, refresh, run again, look again, re-enrich, or asks whether new UE changes are working. " +
+        "Do not use refresh for ordinary repeat reads. Do not resubmit while polling an existing job. " +
+        "A normal repeat lookup is not proof that a fresh enrichment occurred. " +
+        "Only claim a rerun happened when there is a new job, usage.refresh_executed=true, or a new generated timestamp/source inventory. " +
+        "cache_status=hit means this request served an existing result; cache_status=miss means this request ran collection.");
     registerBrief(MCP_TOOL_ALIASES.get_personal_context[0], "Deprecated alias for get_personal_context.");
     const resumeShape = {
         ...briefShape,
@@ -311,7 +322,7 @@ export function createMcpServer(context) {
             });
         return submitBrief(args, args.idempotency_key);
     });
-    registerResume("resume_personal_context", "Verify increased spendable credit, then replay the original request with its idempotency key.");
+    registerResume("resume_personal_context", "Verify increased spendable credit, then replay the original request with its idempotency key. Pass the same refresh value as the 402 request — a refresh 402 resumed without refresh:true is a 409.");
     registerResume(MCP_TOOL_ALIASES.resume_personal_context[0], "Deprecated alias for resume_personal_context.");
     server.registerTool("get_billing_status", {
         description: "Read spendable balance, usage limits (tier, daily limit, used in window, max batch) and auto-recharge state.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "uniqueness-mcp",
-  "version": "0.8.0",
+  "version": "0.8.2",
   "description": "Local stdio fallback for the hosted Uniqueness Engine MCP server.",
   "type": "module",
   "bin": {