@prismnetwork/mcp 0.1.2 → 0.3.0

package/README.md

@@ -1,9 +1,29 @@
 # @prismnetwork/mcp
 
-An MCP server that lets Claude (or any MCP client) lease and run on real GPUs through [Prism Network](https://prismnetwork.tech). Give it a wallet; it handles auth, on-chain payment, provisioning, and SSH.
+An MCP server that lets Claude (or any MCP client) see and lease real GPUs through [Prism Network](https://prismnetwork.tech). Give it a wallet and it handles auth, onchain payment, provisioning, and SSH.
+
+## Try it without a wallet
+
+Looking costs nothing and needs no configuration:
+
+```sh
+claude mcp add prism -- npx -y @prismnetwork/mcp
+```
+
+Then ask what you can rent. `prism_list_gpus` answers from live capacity with
+real prices. Leasing spends money, so those tools ask for a wallet and say so.
 
 ## Tools
 
+| Tool | Wallet |
+| --- | --- |
+| `prism_list_gpus` | no |
+| `prism_wallet` | yes |
+| `prism_lease_and_run` | yes |
+| `prism_lease` | yes |
+| `prism_run` | yes |
+| `prism_end_lease` | yes |
+
 - `prism_wallet`: the agent's address and USDG/ETH balances.
 - `prism_list_gpus`: GPUs available to lease, with price per second and per hour.
 - `prism_lease_and_run`: lease a GPU, run a command, return the output (one shot).

package/package.json

@@ -1,25 +1,43 @@
 {
   "name": "@prismnetwork/mcp",
-  "version": "0.1.2",
+  "version": "0.3.0",
   "description": "MCP server for leasing and running on Prism Network GPUs.",
   "mcpName": "io.github.prismnetwork-tech/mcp",
   "type": "module",
-  "bin": { "prism-mcp": "server.mjs" },
-  "files": ["server.mjs", "README.md"],
-  "engines": { "node": ">=20" },
+  "bin": {
+    "prism-mcp": "server.mjs"
+  },
+  "files": [
+    "server.mjs",
+    "README.md"
+  ],
+  "engines": {
+    "node": ">=20"
+  },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.0.0",
-    "@prismnetwork/agent-sdk": "^0.1.0",
+    "@prismnetwork/agent-sdk": "^0.2.0",
     "viem": "^2"
   },
-  "keywords": ["prism", "mcp", "gpu", "agent", "claude", "compute"],
+  "keywords": [
+    "prism",
+    "mcp",
+    "gpu",
+    "agent",
+    "claude",
+    "compute"
+  ],
   "homepage": "https://prismnetwork.tech",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/prismnetwork-tech/prism.git",
     "directory": "mcp"
   },
-  "bugs": { "url": "https://github.com/prismnetwork-tech/prism/issues" },
+  "bugs": {
+    "url": "https://github.com/prismnetwork-tech/prism/issues"
+  },
   "license": "Apache-2.0",
-  "publishConfig": { "access": "public" }
+  "publishConfig": {
+    "access": "public"
+  }
 }

package/server.mjs

@@ -1,10 +1,11 @@
 #!/usr/bin/env node
-// Prism Network MCP server: lets an MCP client (Claude, agents) lease and run on
-// real GPUs. Configure with a wallet: PRISM_AGENT_KEY, PRISM_ESCROW.
+// Prism Network MCP server: lets an MCP client (Claude, agents) see and lease
+// real GPUs. Looking is free and needs no configuration. Leasing spends money,
+// so it needs a wallet: PRISM_AGENT_KEY, PRISM_ESCROW.
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import { CallToolRequestSchema, ListToolsRequestSchema } from "@modelcontextprotocol/sdk/types.js";
-import { DEFAULT_IMAGE, PrismAgent } from "@prismnetwork/agent-sdk";
+import { DEFAULT_IMAGE, PrismAgent, TRUST_CLASSES } from "@prismnetwork/agent-sdk";
 
 const IMAGE = process.env.PRISM_DEFAULT_IMAGE ?? DEFAULT_IMAGE;
 
@@ -14,7 +15,12 @@ function requireEnv(name) {
   return value;
 }
 
-let agent;
+const PUBLIC_API = process.env.PRISM_PUBLIC_API ?? "https://api.prismnetwork.tech";
+
+// Refusing to start without a wallet meant nobody could ask what a GPU costs
+// without first producing a private key, which is a strange thing to demand of
+// someone deciding whether to use you at all.
+let agent = null;
 try {
   agent = new PrismAgent({
     privateKey: requireEnv("PRISM_AGENT_KEY"),
@@ -22,9 +28,28 @@ try {
     apiBase: process.env.PRISM_API_BASE ?? "https://prismnetwork.tech",
     rpcUrl: process.env.PRISM_RPC_URL,
   });
-} catch (err) {
-  console.error(`prism mcp config error: ${err.message}. Set PRISM_AGENT_KEY and PRISM_ESCROW in the server env.`);
-  process.exit(1);
+} catch {
+  console.error(
+    "prism mcp: no wallet configured, so capacity and pricing are readable and leasing is not. " +
+      "Set PRISM_AGENT_KEY and PRISM_ESCROW to lease.",
+  );
+}
+
+function requireWallet(tool) {
+  if (!agent) {
+    throw new Error(
+      `${tool} spends money, so it needs a wallet. Set PRISM_AGENT_KEY and PRISM_ESCROW in this server's environment and restart it.`,
+    );
+  }
+  return agent;
+}
+
+async function publicOffers(minTrust) {
+  const url = new URL("/v1/offers", PUBLIC_API);
+  if (minTrust) url.searchParams.set("min_trust", minTrust);
+  const response = await fetch(url, { headers: { accept: "application/json" } });
+  if (!response.ok) throw new Error(`prism offers unavailable (${response.status})`);
+  return response.json();
 }
 
 const leases = new Map();
@@ -55,8 +80,17 @@ const TOOLS = [
   },
   {
     name: "prism_list_gpus",
-    description: "List GPUs currently available to lease on Prism Network, with model, VRAM, and price per second in USDG.",
-    inputSchema: { type: "object", properties: {} },
+    description: "List GPUs currently available to lease on Prism Network, with model, VRAM, price per second in USDG, and trust class. Trust class runs open < isolated < attested < confidential; on an 'open' supplier the host operator can read anything the workload touches, so never send secrets, credentials or private model weights to one.",
+    inputSchema: {
+      type: "object",
+      properties: {
+        min_trust: {
+          type: "string",
+          enum: TRUST_CLASSES,
+          description: "Only list suppliers at or above this trust class (default 'open').",
+        },
+      },
+    },
   },
   {
     name: "prism_lease_and_run",
@@ -67,6 +101,11 @@ const TOOLS = [
         command: { type: "string", description: "Shell command to run on the GPU (e.g. 'nvidia-smi')." },
         duration_seconds: { type: "integer", description: "Lease length in seconds (default 900, max 21600)." },
         min_vram_mib: { type: "integer", description: "Minimum GPU memory in MiB (default 16000)." },
+        min_trust_class: {
+          type: "string",
+          enum: TRUST_CLASSES,
+          description: "Refuse suppliers below this trust class (default 'open'). Raise it for anything the host operator must not read.",
+        },
       },
       required: ["command"],
     },
@@ -79,6 +118,11 @@ const TOOLS = [
       properties: {
         duration_seconds: { type: "integer", description: "Lease length in seconds (default 900, max 21600)." },
         min_vram_mib: { type: "integer", description: "Minimum GPU memory in MiB (default 16000)." },
+        min_trust_class: {
+          type: "string",
+          enum: TRUST_CLASSES,
+          description: "Refuse suppliers below this trust class (default 'open'). Raise it for anything the host operator must not read.",
+        },
       },
     },
   },
@@ -108,12 +152,18 @@ const TOOLS = [
 
 async function handle(name, args) {
   if (name === "prism_wallet") {
-    const b = await agent.balances();
+    const b = await requireWallet("prism_wallet").balances();
     return { address: b.address, usdg: usdg(b.usdg), eth_wei: b.eth };
   }
   if (name === "prism_list_gpus") {
-    await ensureAuth();
-    const offers = await agent.offers();
+    const minTrust = args.min_trust ?? "open";
+    let offers;
+    if (agent) {
+      await ensureAuth();
+      offers = await agent.offers({ minTrust });
+    } else {
+      offers = await publicOffers(minTrust);
+    }
     return {
       available: offers.length,
       gpus: offers.map((o) => ({
@@ -121,22 +171,26 @@ async function handle(name, args) {
         vram_mib: o.gpu.vram_mib,
         price_per_second: usdg(o.rate_per_second),
         price_per_hour: usdg(o.rate_per_second * 3600),
+        trust: o.trust_class,
       })),
     };
   }
   if (name === "prism_lease_and_run" || name === "prism_lease") {
     if (name === "prism_lease_and_run" && !args.command) throw new Error("command is required");
+    requireWallet(name);
     await ensureAuth();
     sweepExpiredLeases();
     const lease = await agent.lease({
       image: IMAGE,
       durationSeconds: args.duration_seconds ?? 900,
       minVramMib: args.min_vram_mib ?? 16000,
+      minTrustClass: args.min_trust_class ?? "open",
     });
     leases.set(lease.leaseId, lease);
     const summary = {
       lease_id: lease.leaseId,
       ssh: { host: lease.access.ssh_host, port: lease.access.ssh_port, user: lease.access.ssh_user },
+      trust: lease.quote?.trust_class ?? "open",
       expires_at: lease.access.expires_at,
     };
     if (name === "prism_lease") return summary;