cascrow-mcp 1.0.2 → 1.1.1

package/index.js

@@ -241,6 +241,42 @@ const TOOLS = [
       },
     },
   },
+  {
+    name: "cascrow_handoff",
+    description:
+      "Send a contract invite to a Builder agent by Agent ID. " +
+      "Use this after cascrow_create_contract to delegate the work to another agent. " +
+      "The Builder agent will automatically pick up the invite via cascrow_check_invites.",
+    inputSchema: {
+      type: "object",
+      required: ["inviteCode", "builderAgentId", "contractId"],
+      properties: {
+        inviteCode: { type: "string", description: "The invite code returned by cascrow_create_contract" },
+        builderAgentId: { type: "string", description: "The Agent ID of the Builder agent (from cascrow_get_agent_id)" },
+        contractId: { type: "string", description: "The contract ID returned by cascrow_create_contract" },
+        message: { type: "string", description: "Optional instructions for the Builder agent" },
+      },
+    },
+  },
+  {
+    name: "cascrow_get_agent_id",
+    description: "Get this agent's own Agent ID. Share this with Requester agents so they can send you work via cascrow_handoff.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+    },
+  },
+  {
+    name: "cascrow_check_invites",
+    description:
+      "Check for pending contract invites sent to this agent. " +
+      "Use this as a Builder agent to discover work assigned to you. " +
+      "Returns unclaimed invites and marks them as claimed. Poll every few seconds until an invite appears.",
+    inputSchema: {
+      type: "object",
+      properties: {},
+    },
+  },
 ];
 
 // ─── Tool handlers ────────────────────────────────────────────────────────────
@@ -346,6 +382,34 @@ async function handleGetContract({ contractId }) {
   return data;
 }
 
+async function handleHandoff({ inviteCode, builderAgentId, contractId, message }) {
+  const data = await apiPost("/api/agent/handoff", { inviteCode, builderAgentId, contractId, message });
+  return {
+    handoffId: data.handoffId,
+    message: `Contract handed off to Agent ${builderAgentId}. They will pick it up automatically via cascrow_check_invites.`,
+  };
+}
+
+async function handleGetAgentId() {
+  const data = await apiGet("/api/agent/me");
+  return {
+    agentId: data.agentId,
+    message: `Your Agent ID is: ${data.agentId}. Share this with Requester agents so they can send you work.`,
+  };
+}
+
+async function handleCheckInvites() {
+  const data = await apiGet("/api/agent/pending-invites");
+  const invites = data.invites ?? [];
+  if (invites.length === 0) {
+    return { invites: [], message: "No pending invites. Poll again in a few seconds." };
+  }
+  return {
+    invites,
+    message: `Found ${invites.length} invite(s). Use cascrow_join_contract with the inviteCode to accept.`,
+  };
+}
+
 // ─── MCP Server ───────────────────────────────────────────────────────────────
 
 const server = new Server(
@@ -381,6 +445,15 @@ server.setRequestHandler(CallToolRequestSchema, async (request) => {
       case "cascrow_get_contract":
         result = await handleGetContract(args);
         break;
+      case "cascrow_handoff":
+        result = await handleHandoff(args);
+        break;
+      case "cascrow_check_invites":
+        result = await handleCheckInvites();
+        break;
+      case "cascrow_get_agent_id":
+        result = await handleGetAgentId();
+        break;
       default:
         throw new Error(`Unknown tool: ${name}`);
     }

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "cascrow-mcp",
-  "version": "1.0.2",
+  "version": "1.1.1",
   "description": "MCP server for Cascrow — agentic escrow and verification",
   "type": "module",
   "main": "index.js",