@vultisig/mcp 0.1.14 → 0.1.16

package/CHANGELOG.md

@@ -1,5 +1,24 @@
 # @vultisig/mcp
 
+## 0.1.16
+
+### Patch Changes
+
+- [#683](https://github.com/vultisig/vultisig-sdk/pull/683) [`4561129`](https://github.com/vultisig/vultisig-sdk/commit/45611297a55da72d3c56b1a2ffe6522da1b64d7b) Thanks [@rcoderdev](https://github.com/rcoderdev)! - Update SDK package dependencies and Yarn tooling.
+
+- Updated dependencies [[`4561129`](https://github.com/vultisig/vultisig-sdk/commit/45611297a55da72d3c56b1a2ffe6522da1b64d7b)]:
+  - @vultisig/client-shared@0.2.14
+  - @vultisig/sdk@1.8.10
+
+## 0.1.15
+
+### Patch Changes
+
+- [#642](https://github.com/vultisig/vultisig-sdk/pull/642) [`cc7fc61`](https://github.com/vultisig/vultisig-sdk/commit/cc7fc61f7720f8c218bccc90b276808c71263651) Thanks [@rcoderdev](https://github.com/rcoderdev)! - Accept documented `vmcp --vault <id-or-path>` arguments and reject unknown MCP CLI options.
+
+- Updated dependencies [[`72bbcd1`](https://github.com/vultisig/vultisig-sdk/commit/72bbcd17ee5327390c98784f861b7c6b8829cf2f)]:
+  - @vultisig/sdk@1.8.2
+
 ## 0.1.14
 
 ### Patch Changes

package/README.md

@@ -14,11 +14,15 @@ npm install -g @vultisig/mcp
 # Set up credentials via the CLI first
 vsig auth setup
 
-# Then run the MCP server (stdio)
+# Then run the MCP server (stdio) by vault ID or file path
 vmcp --vault <id-or-path>
 
 # Read-only profile (disables send/swap)
 vmcp --vault <id-or-path> --profile harness
+
+# Explicit forms are also supported
+vmcp --vault-id <id>
+vmcp --vault-file <path>
 ```
 
 ## Tools

package/dist/bin/mcp-server.js

@@ -5,6 +5,126 @@ import { readFileSync } from "node:fs";
 import { executeAuthSetup as executeAuthSetup2, getServerPassword as getServerPassword2 } from "@vultisig/client-shared";
 import { Vultisig } from "@vultisig/sdk";
 
+// src/args.ts
+var PROFILES = ["harness", "defi"];
+function formatMcpHelp() {
+  return `
+vultisig-mcp - MCP server for Vultisig wallet operations
+
+SETUP (first time):
+  vmcp --setup                    Import a vault and store credentials interactively
+  vmcp --setup --vault-file <path>   Import a specific vault file
+  vmcp --setup --vault <path>        Import a specific vault file
+
+USAGE:
+  vmcp [options]
+
+OPTIONS:
+  --profile <harness|defi>   Tool profile (default: defi)
+                             harness = read-only tools only
+                             defi    = all tools including send/swap
+  --vault <id-or-path>       Use a vault by ID, or load a path-like/.vult file
+  --vault-id <id>            Use a specific vault (default: first found)
+  --setup                    Run interactive auth setup, then exit
+
+CI / HEADLESS (skip interactive auth):
+  --vault-file <path>        Load vault directly from a .vult file
+                             Requires VAULT_PASSWORD and/or VAULT_DECRYPT_PASSWORD
+                             environment variables for encrypted vaults
+
+EXAMPLES:
+  # First time setup:
+  vmcp --setup
+
+  # Start the server:
+  vmcp
+  vmcp --vault my-vault-id
+  vmcp --profile harness
+
+  # Claude Code integration:
+  claude mcp add vultisig -- vmcp
+  claude mcp add vultisig -- npx @vultisig/mcp
+
+  # CI / headless:
+  VAULT_PASSWORD=xxx vmcp --vault-file ./vault.vult
+`;
+}
+function parseMcpArgs(args) {
+  let profile = "defi";
+  let vaultId;
+  let vaultFile;
+  let setup = false;
+  const assignVaultId = (value) => {
+    if (vaultId || vaultFile) {
+      throw new Error("Specify only one of --vault, --vault-id, or --vault-file.");
+    }
+    vaultId = value;
+  };
+  const assignVaultFile = (value) => {
+    if (vaultId || vaultFile) {
+      throw new Error("Specify only one of --vault, --vault-id, or --vault-file.");
+    }
+    vaultFile = value;
+  };
+  for (let i = 0; i < args.length; i++) {
+    const arg = args[i];
+    if (arg === "--help" || arg === "-h") {
+      return { profile, help: true };
+    }
+    if (arg === "--setup") {
+      setup = true;
+      continue;
+    }
+    if (arg === "--profile") {
+      const value = readOptionValue(args, i, arg);
+      i++;
+      if (!PROFILES.includes(value)) {
+        throw new Error(`Invalid profile "${value}". Must be one of: ${PROFILES.join(", ")}.`);
+      }
+      profile = value;
+      continue;
+    }
+    if (arg === "--vault-id") {
+      assignVaultId(readOptionValue(args, i, arg));
+      i++;
+      continue;
+    }
+    if (arg === "--vault-file") {
+      assignVaultFile(readOptionValue(args, i, arg));
+      i++;
+      continue;
+    }
+    if (arg === "--vault") {
+      const value = readOptionValue(args, i, arg);
+      i++;
+      if (isVaultFileValue(value)) {
+        assignVaultFile(value);
+      } else {
+        assignVaultId(value);
+      }
+      continue;
+    }
+    if (arg.startsWith("-")) {
+      throw new Error(`Unknown option "${arg}".`);
+    }
+    throw new Error(`Unexpected argument "${arg}".`);
+  }
+  if (setup && vaultId) {
+    throw new Error("Setup can only import a vault file. Use --vault-file <path> or --vault <path>.");
+  }
+  return { profile, vaultId, vaultFile, setup };
+}
+function readOptionValue(args, index, option) {
+  const value = args[index + 1];
+  if (!value || value.startsWith("-")) {
+    throw new Error(`Missing value for ${option}.`);
+  }
+  return value;
+}
+function isVaultFileValue(value) {
+  return value.endsWith(".vult") || value.includes("/") || value.includes("\\") || value.startsWith("~");
+}
+
 // src/index.ts
 import { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
@@ -207,71 +327,6 @@ var toStderr = (...args) => {
 console.log = toStderr;
 console.info = toStderr;
 console.warn = toStderr;
-var PROFILES = ["harness", "defi"];
-function parseArgs() {
-  const args = process.argv.slice(2);
-  if (args.includes("--help") || args.includes("-h")) {
-    process.stderr.write(`
-vultisig-mcp \u2014 MCP server for Vultisig wallet operations
-
-SETUP (first time):
-  vmcp --setup            Import a vault and store credentials interactively
-  vmcp --setup --vault-file <path>   Import a specific vault file
-
-USAGE:
-  vmcp [options]
-
-OPTIONS:
-  --profile <harness|defi>   Tool profile (default: defi)
-                             harness = read-only tools only
-                             defi    = all tools including send/swap
-  --vault-id <id>            Use a specific vault (default: first found)
-  --setup                    Run interactive auth setup, then exit
-
-CI / HEADLESS (skip interactive auth):
-  --vault-file <path>        Load vault directly from a .vult file
-                             Requires VAULT_PASSWORD and/or VAULT_DECRYPT_PASSWORD
-                             environment variables for encrypted vaults
-
-EXAMPLES:
-  # First time setup:
-  vmcp --setup
-
-  # Start the server:
-  vmcp
-  vmcp --profile harness
-
-  # Claude Code integration:
-  claude mcp add vultisig -- vmcp
-  claude mcp add vultisig -- npx @vultisig/mcp
-
-  # CI / headless:
-  VAULT_PASSWORD=xxx vmcp --vault-file ./vault.vult
-`);
-    process.exit(0);
-  }
-  let profile = "defi";
-  let vaultId;
-  let vaultFile;
-  const setup = args.includes("--setup");
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-    if (arg === "--profile" && args[i + 1]) {
-      const value = args[++i];
-      if (!PROFILES.includes(value)) {
-        process.stderr.write(`Invalid profile "${value}". Must be one of: ${PROFILES.join(", ")}
-`);
-        process.exit(1);
-      }
-      profile = value;
-    } else if (arg === "--vault-id" && args[i + 1]) {
-      vaultId = args[++i];
-    } else if (arg === "--vault-file" && args[i + 1]) {
-      vaultFile = args[++i];
-    }
-  }
-  return { profile, vaultId, vaultFile, setup };
-}
 async function runSetup(vaultFile) {
   console.log = process.stdout.write.bind(process.stdout);
   process.stderr.write("[vultisig-mcp] Running auth setup...\n");
@@ -283,7 +338,11 @@ async function runSetup(vaultFile) {
   );
 }
 async function main() {
-  const { profile, vaultId, vaultFile, setup } = parseArgs();
+  const { profile, vaultId, vaultFile, setup, help } = parseMcpArgs(process.argv.slice(2));
+  if (help) {
+    process.stderr.write(formatMcpHelp());
+    return;
+  }
   if (setup) {
     await runSetup(vaultFile);
     return;
@@ -345,7 +404,7 @@ Run vmcp --help for more options.
   await startMcpServer(vault, profile);
 }
 main().catch((err) => {
-  process.stderr.write(`${err}
+  process.stderr.write(`${err instanceof Error ? err.message : err}
 `);
   process.exit(1);
 });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@vultisig/mcp",
-  "version": "0.1.14",
+  "version": "0.1.16",
   "description": "MCP server for Vultisig SDK - Model Context Protocol wrapper over wallet operations",
   "type": "module",
   "bin": {
@@ -42,16 +42,16 @@
   "dependencies": {
     "@modelcontextprotocol/sdk": "~1.29.0",
     "@napi-rs/keyring": "^1.3.0",
-    "@vultisig/client-shared": "^0.2.13",
-    "@vultisig/sdk": "^1.0.0",
-    "zod": "^4.3.6"
+    "@vultisig/client-shared": "^0.2.14",
+    "@vultisig/sdk": "^1.8.10",
+    "zod": "^4.4.3"
   },
   "devDependencies": {
-    "@types/node": "^25.5.0",
-    "esbuild": "^0.27.4",
-    "tsx": "^4.22.3",
+    "@types/node": "^25.9.2",
+    "esbuild": "^0.28.0",
+    "tsx": "^4.22.4",
     "typescript": "^6.0.3",
-    "vitest": "^4.1.6"
+    "vitest": "^4.1.8"
   },
   "engines": {
     "node": ">=20.0.0"