plures-mcp 1.0.0 → 1.1.0

package/README.md

@@ -22,7 +22,7 @@ Get a free test key at [plures.si](https://plures.si/?for=developers#join), then
 
 Claude Code: `claude mcp add plures --env PLURES_API_KEY=pk_test_... -- npx -y plures-mcp`
 
-A `pk_test_` key answers instantly with a simulated result, so you can try the flow for free. A `pk_live_` key sends tasks to real verified people and is billed per answer.
+A `pk_test_` key answers instantly with a simulated result (always the first option, clearly marked as a test), so you can try the flow for free. A `pk_live_` key sends tasks to real verified people and is billed per answer.
 
 ## Tools
 
@@ -38,7 +38,7 @@ A `pk_test_` key answers instantly with a simulated result, so you can try the f
 
 **`cancel_human_task`**: cancel a task that no longer matters.
 
-Each result tells the agent the answer, how many people agreed and whether it is safe to act on: unanimous answers are, anything less should be escalated.
+Each result tells the agent the answer, how many people agreed and whether it is safe to act on. If you've added your team at plures.si/dashboard/team, decisions verified people don't all agree on go to your team, and the agent gets their decision as the final answer.
 
 ## When agents should use it
 

package/dist/index.js

@@ -5,28 +5,38 @@ import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { z } from "zod";
 import { Plures, PluresError } from "plures";
-var VERSION = "1.0.0";
+var VERSION = "1.1.0";
 var KEY = process.env.PLURES_API_KEY;
 var plures = KEY ? new Plures(KEY, { baseUrl: process.env.PLURES_BASE_URL }) : null;
 var MAX_WAIT = 240;
 var server = new McpServer({ name: "plures", version: VERSION }, {
   instructions: "Plures sends a decision to ID verified people, who answer independently, and returns their consensus. Use ask_humans before you act on a judgment call you are not sure about, where a wrong call costs money, trust or safety: reading a customer's tone or intent, approving a refund or payment, checking that an invoice, listing or document matches, moderating an edge case, or confirming a fact that needs human eyes. Don't use it for things you can check with code or a lookup. Act on the answer when agreement is 1; below that, treat it as uncertain and escalate or ask for more verifiers."
 });
+var TEST_NOTE = "TEST MODE: this answer is simulated; no person saw the question. It always picks the first option, so don't act on it. Use a live key for real answers.";
 var fmt = (t) => {
+  const text = describe(t);
+  return t.mode === "test" ? `${TEST_NOTE}
+${text}` : text;
+};
+var describe = (t) => {
   const label = (id) => t.options.find((o) => o.id === id)?.label ?? id;
+  if (t.status === "pending" && t.escalation)
+    return `Verified people didn't all agree, so the decision went to your team, who decide within a day. Task ${t.id}. Call get_human_answer with this task_id later; don't act until it's decided.`;
   if (t.status === "pending")
     return `Still waiting for people to answer. Task ${t.id}. Call get_human_answer with this task_id later.`;
   if (t.status === "canceled") return `Task ${t.id} was canceled.`;
   const r = t.result;
   const votes = r ? Object.entries(r.votes).map(([k, v]) => `${label(k)}: ${v}`).join(", ") : "none";
   if (t.status === "expired") return `Task ${t.id} expired before enough people answered. Votes so far: ${votes}. Treat this as unverified.`;
+  if (r?.decided_by === "team" && r.answer !== null)
+    return `Your team decided: ${label(r.answer)}${r.reviewer ? ` (${r.reviewer})` : ""}, after verified people didn't all agree (${votes}). This is the final answer; act on it.${r.note ? ` Their note: "${r.note}"` : ""}`;
   if (!r || r.answer === null) return `People were split${r?.tie ? " (a tie)" : ""}. Votes: ${votes}. Treat this as uncertain and escalate to a person on your team.`;
   const strength = r.agreement >= 1 ? "Everyone agreed, so it is safe to act on." : `Agreement is ${Math.round(r.agreement * 100)}%, so treat it as uncertain.`;
-  return `Verified people answered: ${label(r.answer)}. ${Math.round(r.agreement * r.answers)} of ${r.answers} agreed. ${strength} Votes: ${votes}.${t.mode === "test" ? " (Test mode: this answer is simulated, no real people saw it.)" : ""}`;
+  return `Verified people answered: ${label(r.answer)}. ${Math.round(r.agreement * r.answers)} of ${r.answers} agreed. ${strength} Votes: ${votes}.`;
 };
 var out = (t) => ({
   content: [{ type: "text", text: fmt(t) }],
-  structuredContent: { task_id: t.id, status: t.status, mode: t.mode, answer: t.result?.answer ?? null, label: t.result?.label ?? null, agreement: t.result?.agreement ?? null, answers: t.result?.answers ?? 0, votes: t.result?.votes ?? {} }
+  structuredContent: { task_id: t.id, status: t.status, mode: t.mode, decided_by: t.result?.decided_by ?? null, with_team: !!t.escalation && t.status === "pending", answer: t.result?.answer ?? null, label: t.result?.label ?? null, agreement: t.result?.agreement ?? null, answers: t.result?.answers ?? 0, votes: t.result?.votes ?? {} }
 });
 var fail = (e) => ({
   isError: true,
@@ -52,7 +62,7 @@ var progressFor = (extra, total) => {
   if (token === void 0) return void 0;
   return (n) => extra.sendNotification({ method: "notifications/progress", params: { progressToken: token, progress: n, total, message: "Waiting for verified people to answer" } });
 };
-var result = { task_id: z.string(), status: z.string(), mode: z.string(), answer: z.string().nullable(), label: z.string().nullable(), agreement: z.number().nullable(), answers: z.number(), votes: z.record(z.number()) };
+var result = { task_id: z.string(), status: z.string(), mode: z.string(), decided_by: z.string().nullable(), with_team: z.boolean(), answer: z.string().nullable(), label: z.string().nullable(), agreement: z.number().nullable(), answers: z.number(), votes: z.record(z.number()) };
 server.registerTool("ask_humans", {
   title: "Ask verified humans",
   description: "Send a decision to ID verified people before you act on it. Several people answer independently, each confirmed with Face ID, and you get back the consensus answer and how strongly they agreed. Use it for judgment calls where being wrong is costly: tone and intent, refunds and payments, whether two things match, moderation edge cases. Write the question so a stranger can answer it from the context alone, and never include secrets or more personal data than the decision needs. Live keys are billed per answer; test keys are free and simulated.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plures-mcp",
-  "version": "1.0.0",
+  "version": "1.1.0",
   "mcpName": "io.github.plureslabs/plures",
   "description": "MCP server for Plures: lets any AI agent ask ID verified people to check a decision before it acts.",
   "keywords": [
@@ -39,7 +39,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.32.0",
-    "plures": "^1.0.0",
+    "plures": "^1.1.0",
     "zod": "^3.25.0"
   },
   "devDependencies": {