@clearedby/mcp 0.0.1 → 0.0.2

package/dist/index.js

@@ -17,13 +17,19 @@ async function main() {
     }
     const cb = new ClearedBy({ apiKey, baseUrl: process.env.CLEAREDBY_BASE_URL });
     const server = new McpServer({ name: 'clearedby', version: '0.0.1' });
-    server.tool('request_clearance', 'Gate a consequential action before doing it. Returns whether it is cleared (safe to proceed), rejected (do NOT proceed), or — if held for a human — waits up to 10 minutes for a decision.', {
+    server.tool('request_clearance', 'Gate a consequential action before doing it. Returns whether it is cleared (safe to proceed), rejected (do NOT proceed), or — if held for a human — waits up to 10 minutes for a decision. Pass model + confidence + reason so the reviewer sees a real proof case, not placeholders.', {
         action: z.string().describe('e.g. refund.create, ad.launch'),
         params: z.record(z.unknown()).optional().describe('the action parameters, e.g. { amount: 250 }'),
         policy: z.string().optional(),
         summary: z.string().optional().describe('one-line human summary for the reviewer'),
+        model: z.string().optional().describe('the model proposing this action, e.g. claude-opus-4-8'),
+        confidence: z.number().min(0).max(1).optional().describe('your confidence this should be cleared, 0..1'),
+        reason: z.string().optional().describe('why this should be cleared — your justification/evidence'),
     }, async (args) => {
-        const r = await requestClearance(cb, args);
+        // agent_id from the connecting MCP client (e.g. "claude-code") so the
+        // provenance record shows the real agent rather than the 'agent' default.
+        const agentId = server.server.getClientVersion()?.name;
+        const r = await requestClearance(cb, { ...args, agentId });
         return { content: [{ type: 'text', text: r.text }], isError: r.isError, structuredContent: r.structured };
     });
     server.tool('check_policy', 'Dry-run: preview what the policy WOULD decide for an action, without recording anything.', {

package/dist/tools.d.ts

@@ -10,6 +10,10 @@ export declare function requestClearance(cb: ClearedBy, args: {
     params?: Record<string, unknown>;
     policy?: string;
     summary?: string;
+    agentId?: string;
+    model?: string;
+    confidence?: number;
+    reason?: string;
 }): Promise<ToolResult>;
 /** check_policy: dry-run — what would the policy do, with nothing persisted. */
 export declare function checkPolicy(cb: ClearedBy, args: {

package/dist/tools.js

@@ -6,11 +6,27 @@ const hash8 = (h) => (h ? ` · attestation ${h.slice(0, 8)}` : '');
 /** request_clearance: gate the action; if held, wait for a human (≤10 min). */
 export async function requestClearance(cb, args) {
     try {
+        // Real provenance + proof case so the review card shows who proposed this,
+        // on what model, with what confidence — not the 'agent'/'—'/'90%' defaults.
+        const proof = {};
+        if (typeof args.confidence === 'number')
+            proof.confidence = args.confidence;
+        if (args.reason)
+            proof.reason = args.reason;
+        const context = {};
+        if (args.summary)
+            context.summary = args.summary;
+        if (args.agentId)
+            context.agent_id = args.agentId;
+        if (args.model)
+            context.model = args.model;
+        if (Object.keys(proof).length > 0)
+            context.proof = proof;
         const r = await cb.gate({
             action: args.action,
             params: args.params ?? {},
             ...(args.policy ? { policy: args.policy } : {}),
-            ...(args.summary ? { context: { summary: args.summary } } : {}),
+            ...(Object.keys(context).length > 0 ? { context } : {}),
         });
         if (r.shadow) {
             return { text: `Shadow mode — not blocking. Would have been: ${r.would?.verdict ?? 'n/a'}.`, structured: { cleared: true, shadow: true, result: r } };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@clearedby/mcp",
-  "version": "0.0.1",
+  "version": "0.0.2",
   "description": "ClearedBy MCP server — request_clearance, check_policy, get_ledger from any MCP client.",
   "license": "MIT",
   "homepage": "https://clearedby.com",