carpool-mcp 0.1.0 → 0.2.0

package/README.md

@@ -15,6 +15,19 @@ Requires Node 20.19 or newer.
 
 ## Install in Claude Code
 
+One command:
+
+```bash
+npx carpool-mcp setup
+```
+
+It asks for a Hedera ECDSA testnet account id and key (press Enter to skip and search only),
+associates the account with test USDC if needed, and adds Carpool to Claude Code for every project.
+The same account buys and earns. To buy, top it up with test USDC at https://faucet.circle.com.
+No account yet? Create one at https://portal.hedera.com.
+
+### Or add it by hand
+
 Search only (no keys, nothing is paid):
 
 ```bash

package/dist/cli.js

@@ -15,6 +15,14 @@ var __export = (target, all) => {
 };
 
 // apps/registry/src/scripts/associate-account-lib.ts
+var associate_account_lib_exports = {};
+__export(associate_account_lib_exports, {
+  InputError: () => InputError,
+  USDC_TESTNET: () => USDC_TESTNET,
+  checkAccountKeyType: () => checkAccountKeyType,
+  parseAccountId: () => parseAccountId,
+  parsePrivateKey: () => parsePrivateKey
+});
 function parseAccountId(value) {
   const v = (value ?? "").trim();
   if (!v) throw new InputError("HEDERA_ACCOUNT_ID is not set. Pass it as an environment variable, e.g. HEDERA_ACCOUNT_ID=0.0.12345");
@@ -147,6 +155,109 @@ var init_associate_account_run = __esm({
   }
 });
 
+// apps/mcp/scripts/npm-setup.ts
+var npm_setup_exports = {};
+__export(npm_setup_exports, {
+  setup: () => setup
+});
+import { spawnSync } from "node:child_process";
+import { createInterface } from "node:readline";
+function ask(question, hidden = false) {
+  return new Promise((resolve) => {
+    const rl = createInterface({ input: process.stdin, output: process.stdout, terminal: true });
+    if (hidden) {
+      const out = rl;
+      let prompted = false;
+      out._writeToOutput = (s) => {
+        if (!prompted) {
+          process.stdout.write(s);
+          prompted = true;
+        }
+      };
+    }
+    rl.question(question, (answer) => {
+      rl.close();
+      if (hidden) process.stdout.write("\n");
+      resolve(answer.trim());
+    });
+  });
+}
+async function usdcBalance(id) {
+  try {
+    const res = await fetch(`${MIRROR2}/api/v1/accounts/${id}/tokens?token.id=${USDC}`);
+    if (!res.ok) return null;
+    const json = await res.json();
+    return json.tokens?.[0]?.balance ?? null;
+  } catch {
+    return null;
+  }
+}
+function hasClaude() {
+  return spawnSync("claude", ["--version"], { stdio: "ignore" }).status === 0;
+}
+async function setup() {
+  const registry2 = process.env.CARPOOL_REGISTRY_URL?.trim() || DEFAULT_REGISTRY;
+  console.log("Carpool setup\n");
+  console.log("A Hedera ECDSA testnet account lets your agent buy research and get paid for its own.");
+  console.log("No account yet? Create one at https://portal.hedera.com, or press Enter to search only.\n");
+  const id = process.env.HEDERA_ACCOUNT_ID?.trim() || await ask("Account id (0.0.x, Enter to skip): ");
+  const env = [["CARPOOL_REGISTRY_URL", registry2]];
+  if (id) {
+    const key = process.env.HEDERA_PRIVATE_KEY?.trim() || await ask("Private key (hex, hidden): ", true);
+    process.env.HEDERA_ACCOUNT_ID = id;
+    process.env.HEDERA_PRIVATE_KEY = key;
+    const { associateAccount: associateAccount2 } = await Promise.resolve().then(() => (init_associate_account_run(), associate_account_run_exports));
+    console.log("\nChecking the account and USDC association...");
+    await associateAccount2();
+    env.push(
+      ["CARPOOL_BUYER_ACCOUNT_ID", id],
+      ["CARPOOL_BUYER_PRIVATE_KEY", key],
+      ["CARPOOL_AUTHOR_ACCOUNT_ID", id],
+      ["CARPOOL_AUTHOR_PRIVATE_KEY", key]
+    );
+  }
+  const args = ["mcp", "add", "carpool", "-s", "user"];
+  for (const [k, v] of env) args.push("-e", `${k}=${v}`);
+  args.push("--", "npx", "-y", "carpool-mcp");
+  if (!hasClaude()) {
+    const shown = args.map((a) => a.includes("PRIVATE_KEY=") ? a.replace(/=.*/, "=<your key>") : a);
+    console.log("\nClaude Code (the `claude` command) was not found. Once installed, run:\n");
+    console.log(`  claude ${shown.join(" ")}`);
+    return 1;
+  }
+  spawnSync("claude", ["mcp", "remove", "carpool", "-s", "user"], { stdio: "ignore" });
+  const added = spawnSync("claude", args, { stdio: ["ignore", "ignore", "inherit"] });
+  if (added.status !== 0) {
+    console.error("\n`claude mcp add` failed; see the message above.");
+    return 1;
+  }
+  console.log("\nDone. Carpool is added to Claude Code for every project. Restart Claude Code to load it.");
+  if (!id) {
+    console.log("Search only. Run `npx carpool-mcp setup` again with an account to buy and publish.");
+    return 0;
+  }
+  const bal = await usdcBalance(id);
+  if (bal === 0) {
+    console.log(`
+${id} holds no USDC yet. To buy, get test USDC (Hedera testnet) at https://faucet.circle.com`);
+    console.log("Publishing needs none: royalties arrive in this account.");
+  } else if (bal !== null) {
+    console.log(`
+${id} holds $${(bal / 1e6).toFixed(2)} test USDC. Ready to buy and publish.`);
+  }
+  console.log("Keys given to `claude mcp add` are stored in plaintext in its config. Use a testnet key.");
+  return 0;
+}
+var DEFAULT_REGISTRY, MIRROR2, USDC;
+var init_npm_setup = __esm({
+  "apps/mcp/scripts/npm-setup.ts"() {
+    "use strict";
+    DEFAULT_REGISTRY = "https://carpool-registry-production.up.railway.app";
+    MIRROR2 = "https://testnet.mirrornode.hedera.com";
+    USDC = "0.0.429274";
+  }
+});
+
 // apps/mcp/src/consent.ts
 var consent_exports = {};
 __export(consent_exports, {
@@ -1174,7 +1285,19 @@ function emitDeny(reason) {
   );
   process.exit(0);
 }
-if (sub === "associate") {
+if (sub === "setup") {
+  const { setup: setup2 } = await Promise.resolve().then(() => (init_npm_setup(), npm_setup_exports));
+  const { InputError: InputError2 } = await Promise.resolve().then(() => (init_associate_account_lib(), associate_account_lib_exports));
+  setup2().then(
+    (code) => process.exit(code),
+    (e) => {
+      console.error(e instanceof InputError2 ? `
+${e.message}` : `
+setup failed: ${e.message}`);
+      process.exit(1);
+    }
+  );
+} else if (sub === "associate") {
   const { associateAccount: associateAccount2, InputError: InputError2 } = await Promise.resolve().then(() => (init_associate_account_run(), associate_account_run_exports));
   associateAccount2().then(
     (code) => process.exit(code),
@@ -1202,11 +1325,12 @@ if (sub === "associate") {
   const { server: server2 } = await init_server().then(() => server_exports);
   await server2.connect(new StdioServerTransport2());
 } else if (sub === "--version" || sub === "-v") {
-  console.log("carpool-mcp 0.1.0");
+  console.log("carpool-mcp 0.2.0");
 } else {
   console.error(
     `carpool-mcp: unknown command "${sub}".
 Usage: carpool-mcp            start the MCP server on stdio
+       carpool-mcp setup      associate an account and add Carpool to Claude Code
        carpool-mcp associate  associate HEDERA_ACCOUNT_ID with test USDC (key from HEDERA_PRIVATE_KEY env)
        carpool-mcp consent-hook  PreToolUse hook for carpool_publish`
   );

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "carpool-mcp",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "MCP server for Carpool: search, buy and sell prior agent research over x402 on Hedera.",
   "type": "module",
   "bin": {