plures-mcp 1.0.1 → 1.2.0

package/README.md

@@ -31,6 +31,8 @@ A `pk_test_` key answers instantly with a simulated result (always the first opt
 - `options` (required): 2 to 8 possible answers
 - `context`: the material to judge, as plain text
 - `image_url`, `instructions`
+- `audio_url` or `video_url` with `media_seconds`: a clip up to 3 minutes that people play through before answering
+- `sensitive`: disturbing content, shown only to people who opted in
 - `verifiers`: 1, 3, 5, 7 or 9 (default 3)
 - `wait_seconds`: how long to wait for the answer, 0 to 240 (default 45). If people haven't answered by then, the tool returns a `task_id` to check later.
 
@@ -38,7 +40,7 @@ A `pk_test_` key answers instantly with a simulated result (always the first opt
 
 **`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,7 +5,7 @@ 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.1";
+var VERSION = "1.2.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;
@@ -20,19 +20,23 @@ ${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}.`;
 };
 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,
@@ -58,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.",
@@ -67,6 +71,10 @@ server.registerTool("ask_humans", {
     options: z.array(z.string().min(1).max(200)).min(2).max(8).describe('2 to 8 possible answers, e.g. ["Yes", "No"]'),
     context: z.string().max(2e4).optional().describe("The material to judge, as plain text: the message, the invoice lines, the listing"),
     image_url: z.string().url().optional().describe("An https image shown with the question"),
+    audio_url: z.string().url().optional().describe("An https recording people listen to in full before answering, such as a call your voice agent handled. Up to 3 minutes; needs media_seconds"),
+    video_url: z.string().url().optional().describe("An https video (MP4) people watch in full before answering. Up to 3 minutes; needs media_seconds. Not with audio_url"),
+    media_seconds: z.number().int().min(1).max(180).optional().describe("Length of the audio or video in seconds. Required with a clip"),
+    sensitive: z.boolean().optional().describe("Set true for violent, graphic or disturbing content, so only people who opted in see it, behind a warning"),
     instructions: z.string().max(2e3).optional().describe("Short guidance shown under the question"),
     verifiers: z.union([z.literal(1), z.literal(3), z.literal(5), z.literal(7), z.literal(9)]).optional().describe("How many people answer. Default 3; use 5 for higher stakes"),
     wait_seconds: z.number().int().min(0).max(MAX_WAIT).optional().describe(`How long to wait for the answer before returning a task_id to check later. Default 45, up to ${MAX_WAIT}`)

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "plures-mcp",
-  "version": "1.0.1",
+  "version": "1.2.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.2.0",
     "zod": "^3.25.0"
   },
   "devDependencies": {