x402-proxy 0.8.6 → 0.9.1

package/CHANGELOG.md

@@ -7,6 +7,37 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.9.1] - 2026-03-26
+
+### Added
+- `setup --non-interactive` flag - auto-generates wallet and outputs addresses as JSON to stdout (`{"base":"0x...","tempo":"0x...","solana":"..."}`)
+- `setup --import-mnemonic` flag - import existing BIP-39 mnemonic non-interactively
+- MCP proxy auto-generates wallet on first run when no wallet exists (no more "No wallet configured" error)
+- OpenClaw integration example in README and SKILL.md: `openclaw mcp set surf '{"command":"npx","args":["-y","x402-proxy","mcp","https://surf.cascade.fyi/mcp"]}'`
+
+### Fixed
+- `npx -y` flag added to all generated MCP configs (`mcp add` command and docs) - prevents npx install prompt from corrupting MCP stdio protocol
+- MCP config examples no longer show `X402_PROXY_WALLET_MNEMONIC` env var as default - wallet file is the primary path, env vars are documented as fallback only
+- All example MCP URLs updated to `https://surf.cascade.fyi/mcp`
+- Non-interactive JSON output uses network names (`base`, `tempo`, `solana`) instead of generic `evm`
+
+## [0.9.0] - 2026-03-25
+
+### Added
+- `mcp add` command - onboarding wizard to install MCP servers into Claude Code, Cursor, VS Code, and 16+ other AI clients via `@getmcp/generators`
+- Auto-detects installed AI clients and highlights them in the selection list
+- Shows config diff preview with green markers before writing
+- Prompts to overwrite if server name already exists (shows current config)
+- Wallet setup runs automatically if not yet configured
+- Balance check and funding hints shown after successful install
+- `-c` / `--config-dir` global flag to override config directory for all commands
+- Custom config directory injected as `XDG_CONFIG_HOME` env var into generated MCP server configs
+- Tempo address shown alongside Base address in setup wizard
+
+### Fixed
+- Solana USDC balance shows `0` instead of `?` for fresh wallets (non-existent ATA means zero balance, not unknown)
+- MPP payment protocol description corrected from "streaming micropayments" to "machine payments over HTTP 402"
+
 ## [0.8.6] - 2026-03-25
 
 ### Fixed
@@ -246,7 +277,9 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 - `appendHistory` / `readHistory` / `calcSpend` - JSONL transaction history
 - Re-exports from `@x402/fetch`, `@x402/svm`, `@x402/evm`
 
-[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.4...HEAD
+[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.9.1...HEAD
+[0.9.1]: https://github.com/cascade-protocol/x402-proxy/compare/v0.9.0...v0.9.1
+[0.9.0]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.6...v0.9.0
 [0.8.6]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.5...v0.8.6
 [0.8.5]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.4...v0.8.5
 [0.8.4]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.3...v0.8.4

package/README.md

@@ -14,23 +14,38 @@ No wallet? It'll walk you through setup automatically. One mnemonic derives both
 
 ## MCP Proxy
 
-Let your AI agent consume any paid MCP server. Configure in Claude, Cursor, or any MCP client:
+Let your AI agent consume any paid MCP server.
+
+### Quick setup
+
+```bash
+npx x402-proxy mcp add surf https://surf.cascade.fyi/mcp
+```
+
+Auto-detects installed AI clients (Claude Code, Cursor, VS Code, and 16+ others), shows a config preview, and writes it for you. Runs wallet setup if needed.
+
+### Manual config
+
+Or add to your client config directly:
 
 ```json
 {
   "mcpServers": {
-    "paid-service": {
+    "surf": {
       "command": "npx",
-      "args": ["x402-proxy", "mcp", "https://mcp.example.com/sse"],
-      "env": {
-        "X402_PROXY_WALLET_MNEMONIC": "your 24 words here"
-      }
+      "args": ["-y", "x402-proxy", "mcp", "https://surf.cascade.fyi/mcp"]
     }
   }
 }
 ```
 
-The proxy sits between your agent and the remote server, intercepting 402 responses, paying automatically, and forwarding the result. Supports both x402 and MPP protocols. Your agent never touches crypto.
+The proxy auto-generates a wallet on first run and uses `~/.config/x402-proxy/wallet.json`. No env vars needed. Your agent never touches crypto.
+
+For OpenClaw:
+
+```bash
+openclaw mcp set surf '{"command":"npx","args":["-y","x402-proxy","mcp","https://surf.cascade.fyi/mcp"]}'
+```
 
 ## HTTP Requests
 
@@ -67,6 +82,7 @@ $ npx x402-proxy https://api.example.com/data | jq '.results'
 ```bash
 $ npx x402-proxy <url>                    # paid HTTP request (default command)
 $ npx x402-proxy mcp <url>                # MCP stdio proxy for agents
+$ npx x402-proxy mcp add <name> <url>     # install MCP server into your AI client
 $ npx x402-proxy setup                    # onboarding wizard
 $ npx x402-proxy status                   # config + wallet + spend summary
 $ npx x402-proxy config                   # show current configuration
@@ -77,7 +93,7 @@ $ npx x402-proxy wallet history           # payment history
 $ npx x402-proxy wallet export-key <target> # bare key/mnemonic to stdout (evm|solana|mnemonic)
 ```
 
-All commands support `--help` for details.
+All commands support `--help` for details. Use `-c <dir>` to override the config directory.
 
 ## Wallet
 
@@ -97,7 +113,7 @@ $ MY_MNEMONIC=$(npx x402-proxy wallet export-key mnemonic)
 
 ## Env Vars
 
-Override wallet per-instance (useful for MCP configs):
+Override wallet per-instance (fallback for environments where the wallet file isn't accessible):
 
 ```
 X402_PROXY_WALLET_MNEMONIC     # BIP-39 mnemonic (derives both chains)

package/dist/bin/cli.js

@@ -1,10 +1,13 @@
 #!/usr/bin/env node
-import { a as getHistoryPath, c as loadConfig, i as getConfigDirShort, l as loadWalletFile, s as isConfigured, u as saveConfig } from "../derive-BR6N1ZjI.js";
-import { _ as error, b as warn, c as resolveWallet, d as displayNetwork, f as formatAmount, g as dim, h as readHistory, l as appendHistory, m as formatUsdcValue, o as walletInfoCommand, p as formatTxLine, s as buildX402Client, u as calcSpend, v as info, y as isTTY } from "../wallet-BiX5_XFY.js";
-import { n as setupCommand } from "../setup-B1r-Opou.js";
-import { n as statusCommand } from "../status-DvSu8reM.js";
+import { a as getHistoryPath, c as loadConfig, i as getConfigDirShort, l as loadWalletFile, s as isConfigured, u as saveConfig } from "../derive-CAYmX-Yz.js";
+import { _ as error, b as warn, c as resolveWallet, d as displayNetwork, f as formatAmount, g as dim, h as readHistory, l as appendHistory, m as formatUsdcValue, n as fetchAllBalances, o as walletInfoCommand, p as formatTxLine, s as buildX402Client, u as calcSpend, v as info, y as isTTY } from "../wallet-DZsXptY7.js";
+import { n as setupCommand, t as runSetup } from "../setup-B7YJa7s6.js";
+import { n as statusCommand } from "../status-D3f5IVf6.js";
+import { dirname, join, normalize, resolve } from "node:path";
 import { buildApplication, buildCommand, buildRouteMap, run } from "@stricli/core";
 import pc from "picocolors";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { homedir } from "node:os";
 import { decodePaymentResponseHeader, wrapFetchWithPayment } from "@x402/fetch";
 import { base58 } from "@scure/base";
 import * as prompts from "@clack/prompts";
@@ -398,7 +401,7 @@ Examples:
 		};
 		if (!url) {
 			if (isConfigured()) {
-				const { displayStatus } = await import("../status-DjudJ6fD.js");
+				const { displayStatus } = await import("../status-BkURZYDA.js");
 				await displayStatus();
 				console.log();
 				console.log(pc.dim("  Commands:"));
@@ -450,7 +453,7 @@ Examples:
 				process.exit(1);
 			}
 			dim("  No wallet found. Let's set one up first.\n");
-			const { runSetup } = await import("../setup-CH4woul8.js");
+			const { runSetup } = await import("../setup-xhtYsp7D.js");
 			await runSetup();
 			console.log();
 			wallet = resolveWallet();
@@ -463,7 +466,7 @@ Examples:
 		verbose(`protocol: ${resolvedProtocol ?? "auto-detect"}, maxDeposit: ${maxDeposit}`);
 		let preferredNetwork = config?.defaultNetwork;
 		if (!preferredNetwork && wallet.evmAddress && wallet.solanaAddress) {
-			const { fetchAllBalances } = await import("../wallet-BkZ0DOJL.js");
+			const { fetchAllBalances } = await import("../wallet-BM0ngyqk.js");
 			const balances = await fetchAllBalances(wallet.evmAddress, wallet.solanaAddress);
 			const evmUsdc = balances.evm ? Number(balances.evm.usdc) : 0;
 			const solUsdc = balances.sol ? Number(balances.sol.usdc) : 0;
@@ -630,7 +633,7 @@ Examples:
 			const hasSolana = accepts.some((a) => a.network.startsWith("solana:"));
 			const hasMpp = detected.mpp;
 			const hasOther = accepts.some((a) => !a.network.startsWith("eip155:") && !a.network.startsWith("solana:"));
-			const { fetchAllBalances } = await import("../wallet-BkZ0DOJL.js");
+			const { fetchAllBalances } = await import("../wallet-BM0ngyqk.js");
 			const balances = await fetchAllBalances(wallet.evmAddress, wallet.solanaAddress);
 			const evmUsdc = hasEvm && balances.evm ? Number(balances.evm.usdc) : 0;
 			const solUsdc = hasSolana && balances.sol ? Number(balances.sol.usdc) : 0;
@@ -761,8 +764,9 @@ const mcpCommand = buildCommand({
 
 Add to your MCP client config (Claude, Cursor, etc.):
   "command": "npx",
-  "args": ["x402-proxy", "mcp", "https://mcp.example.com/sse"],
-  "env": { "X402_PROXY_WALLET_MNEMONIC": "your 24 words" }`
+  "args": ["-y", "x402-proxy", "mcp", "https://surf.cascade.fyi/mcp"]
+
+Wallet is auto-generated on first run. No env vars needed.`
 	},
 	parameters: {
 		flags: {
@@ -805,8 +809,18 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			solanaKey: flags.solanaKey
 		});
 		if (wallet.source === "none") {
-			error("No wallet configured.\nRun:\n  $ npx x402-proxy setup\n\nOr set X402_PROXY_WALLET_MNEMONIC");
-			process.exit(1);
+			dim("No wallet found. Auto-generating...");
+			const { runSetup } = await import("../setup-xhtYsp7D.js");
+			await runSetup({ nonInteractive: true });
+			const fresh = resolveWallet({
+				evmKey: flags.evmKey,
+				solanaKey: flags.solanaKey
+			});
+			if (fresh.source === "none") {
+				error("Wallet auto-setup failed. Run: $ npx x402-proxy setup");
+				process.exit(1);
+			}
+			Object.assign(wallet, fresh);
 		}
 		dim(`x402-proxy MCP proxy -> ${remoteUrl}`);
 		if (wallet.evmAddress) dim(`  EVM:    ${wallet.evmAddress}`);
@@ -840,7 +854,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 		async function startX402Proxy() {
 			let preferredNetwork = config?.defaultNetwork;
 			if (!preferredNetwork && wallet.evmAddress && wallet.solanaAddress) {
-				const { fetchAllBalances } = await import("../wallet-BkZ0DOJL.js");
+				const { fetchAllBalances } = await import("../wallet-BM0ngyqk.js");
 				const balances = await fetchAllBalances(wallet.evmAddress, wallet.solanaAddress);
 				const evmUsdc = balances.evm ? Number(balances.evm.usdc) : 0;
 				const solUsdc = balances.sol ? Number(balances.sol.usdc) : 0;
@@ -860,7 +874,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.8.6"
+				version: "0.9.1"
 			});
 			const x402Mcp = new x402MCPClient(remoteClient, x402PaymentClient, {
 				autoPayment: true,
@@ -898,7 +912,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.8.6"
+				version: "0.9.1"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -993,7 +1007,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}));
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.8.6"
+				version: "0.9.1"
 			});
 			await connectTransport(remoteClient);
 			const mppClient = McpClient.wrap(remoteClient, { methods: wrappedMethods });
@@ -1008,7 +1022,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.8.6"
+				version: "0.9.1"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -1085,6 +1099,190 @@ Add to your MCP client config (Claude, Cursor, etc.):
 	}
 });
 
+//#endregion
+//#region src/commands/mcp-add.ts
+function resolvePlatformPath(raw) {
+	let p = raw;
+	if (p.startsWith("~/")) p = join(homedir(), p.slice(2));
+	p = p.replace(/%UserProfile%/gi, homedir());
+	p = p.replace(/%AppData%/gi, process.env.APPDATA ?? join(homedir(), "AppData", "Roaming"));
+	p = p.replace(/%LocalAppData%/gi, process.env.LOCALAPPDATA ?? join(homedir(), "AppData", "Local"));
+	return normalize(p);
+}
+function parseConfigFile(path, format) {
+	if (!existsSync(path)) return {};
+	const raw = readFileSync(path, "utf-8").trim();
+	if (!raw) return {};
+	if (format === "json" || format === "jsonc") {
+		const stripped = format === "jsonc" ? raw.replace(/\/\/.*$/gm, "").replace(/\/\*[\s\S]*?\*\//g, "") : raw;
+		return JSON.parse(stripped);
+	}
+	return JSON.parse(raw);
+}
+const mcpAddCommand = buildCommand({
+	docs: {
+		brief: "Add an MCP server to your AI client",
+		fullDescription: "Add a remote MCP server to Claude Code, Cursor, VS Code, or other AI clients with automatic x402 payment proxy."
+	},
+	parameters: {
+		flags: {
+			client: {
+				kind: "parsed",
+				brief: "Target client (claude-code, cursor, vscode, etc.)",
+				parse: String,
+				optional: true
+			},
+			yes: {
+				kind: "boolean",
+				brief: "Skip confirmation prompt",
+				default: false
+			}
+		},
+		positional: {
+			kind: "tuple",
+			parameters: [{
+				brief: "Server name",
+				parse: String
+			}, {
+				brief: "Remote MCP server URL",
+				parse: String
+			}]
+		}
+	},
+	async func(flags, name, url) {
+		prompts.intro(pc.cyan("Add MCP server"));
+		try {
+			new URL(url);
+		} catch {
+			prompts.log.error(`Invalid URL: ${url}`);
+			prompts.cancel("Aborted.");
+			process.exit(1);
+		}
+		const serverName = name;
+		if (!isConfigured()) {
+			prompts.log.warn("No wallet configured. Let's set one up first.\n");
+			await runSetup();
+			console.log();
+			prompts.log.step(pc.cyan("Continuing MCP setup..."));
+		}
+		const { generators, getAppIds, generateConfig, deepMerge } = await import("@getmcp/generators");
+		let clientId;
+		if (flags.client) {
+			const appIds = getAppIds();
+			if (!appIds.includes(flags.client)) {
+				prompts.log.error(`Unknown client: ${flags.client}`);
+				prompts.log.info(`Supported: ${appIds.join(", ")}`);
+				prompts.cancel("Aborted.");
+				process.exit(1);
+			}
+			clientId = flags.client;
+		} else {
+			const appIds = getAppIds();
+			const detected = appIds.filter((id) => generators[id].detectInstalled());
+			const selected = await prompts.select({
+				message: "Where would you like to install the MCP server?",
+				options: appIds.map((id) => ({
+					value: id,
+					label: `${generators[id].app.name}${detected.includes(id) ? pc.dim(" (detected)") : ""}`
+				})),
+				initialValue: detected.includes("claude-code") ? "claude-code" : detected[0] ?? "claude-code"
+			});
+			if (prompts.isCancel(selected)) {
+				prompts.cancel("Cancelled.");
+				process.exit(0);
+			}
+			clientId = selected;
+		}
+		const generator = generators[clientId];
+		const globalPaths = generator.app.globalConfigPaths;
+		const platform = process.platform;
+		const rawPath = globalPaths?.[platform];
+		if (!rawPath) {
+			prompts.log.error(`No global config path for ${generator.app.name} on ${platform}`);
+			prompts.cancel("Aborted.");
+			process.exit(1);
+		}
+		const configPath = resolvePlatformPath(rawPath);
+		const configFormat = generator.app.configFormat;
+		const configDirOverride = process.env.X402_PROXY_CONFIG_DIR_OVERRIDE;
+		const generated = generateConfig(clientId, serverName, {
+			command: "npx",
+			args: [
+				"-y",
+				"x402-proxy",
+				"mcp",
+				url
+			],
+			env: configDirOverride ? { XDG_CONFIG_HOME: configDirOverride } : {},
+			transport: "stdio"
+		});
+		let existing;
+		if (configFormat === "yaml") {
+			const { default: YAML } = await import("yaml");
+			if (existsSync(configPath)) {
+				const raw = readFileSync(configPath, "utf-8").trim();
+				existing = raw ? YAML.parse(raw) ?? {} : {};
+			} else existing = {};
+		} else existing = parseConfigFile(configPath, configFormat);
+		const rootKey = Object.keys(generated)[0] ?? "mcpServers";
+		const existingServers = existing[rootKey] ?? {};
+		if (existingServers[serverName]) {
+			prompts.log.warn(`Server ${pc.bold(serverName)} already exists in config`);
+			prompts.log.message(pc.dim(JSON.stringify({ [serverName]: existingServers[serverName] }, null, 2)));
+			const overwrite = await prompts.confirm({ message: "Overwrite?" });
+			if (prompts.isCancel(overwrite) || !overwrite) {
+				prompts.cancel("Cancelled.");
+				process.exit(0);
+			}
+		}
+		prompts.log.info(`Config will be added to ${pc.dim(configPath)}`);
+		const previewLines = generator.serialize(generated).split("\n");
+		const formatted = previewLines.map((line, i) => {
+			if (i === 0 || i === previewLines.length - 1) return line;
+			const trimmed = line.trimStart();
+			if (trimmed.startsWith(`"${rootKey}"`) || trimmed.startsWith(`${rootKey}:`)) return line;
+			return `${pc.green("+")} ${line}`;
+		}).join("\n");
+		prompts.log.message(formatted);
+		if (!flags.yes) {
+			const proceed = await prompts.confirm({ message: "Would you like to proceed?" });
+			if (prompts.isCancel(proceed) || !proceed) {
+				prompts.cancel("Cancelled.");
+				process.exit(0);
+			}
+		}
+		const merged = deepMerge(existing, generated);
+		const dir = dirname(configPath);
+		if (!existsSync(dir)) mkdirSync(dir, { recursive: true });
+		const serialized = generator.serialize(merged);
+		writeFileSync(configPath, serialized.endsWith("\n") ? serialized : `${serialized}\n`);
+		prompts.log.success(`Added ${pc.bold(serverName)} MCP to ${pc.bold(generator.app.name)}`);
+		const wallet = resolveWallet();
+		if (wallet.source !== "none") {
+			const balances = await fetchAllBalances(wallet.evmAddress, wallet.solanaAddress);
+			const evmUsdc = balances.evm ? Number(balances.evm.usdc) : 0;
+			const solUsdc = balances.sol ? Number(balances.sol.usdc) : 0;
+			const tempoUsdc = balances.tempo ? Number(balances.tempo.usdc) : 0;
+			if (evmUsdc === 0 && solUsdc === 0 && tempoUsdc === 0) {
+				prompts.log.warn("Balance: 0 USDC");
+				prompts.log.info("To use paid MCP tools, send USDC to your wallet:");
+				if (wallet.evmAddress) prompts.log.message(`  Base:   ${pc.cyan(wallet.evmAddress)}`);
+				if (wallet.solanaAddress) prompts.log.message(`  Solana: ${pc.cyan(wallet.solanaAddress)}`);
+			} else {
+				const parts = [];
+				if (balances.evm) parts.push(`Base: ${balances.evm.usdc} USDC`);
+				if (balances.sol) parts.push(`Solana: ${balances.sol.usdc} USDC`);
+				if (balances.tempo) parts.push(`Tempo: ${balances.tempo.usdc} USDC`);
+				prompts.log.success(`Balance: ${parts.join(" | ")}`);
+			}
+		}
+		prompts.log.step("Try your first request:");
+		prompts.log.message(`  ${pc.cyan("$ npx x402-proxy https://twitter.surf.cascade.fyi/users/cascade_fyi")}`);
+		prompts.log.message(`  ${pc.dim("Run")} ${pc.cyan("npx x402-proxy")} ${pc.dim("to see your wallet and balance")}`);
+		prompts.outro(pc.green(`MCP server ${pc.bold(serverName)} is ready to use!`));
+	}
+});
+
 //#endregion
 //#region src/commands/wallet-export.ts
 const walletExportCommand = buildCommand({
@@ -1190,28 +1388,37 @@ const walletHistoryCommand = buildCommand({
 
 //#endregion
 //#region src/app.ts
+const walletRoutes = buildRouteMap({
+	routes: {
+		info: walletInfoCommand,
+		history: walletHistoryCommand,
+		"export-key": walletExportCommand
+	},
+	defaultCommand: "info",
+	docs: { brief: "Wallet management" }
+});
+const configRoutes = buildRouteMap({
+	routes: {
+		show: configShowCommand,
+		set: configSetCommand,
+		unset: configUnsetCommand
+	},
+	defaultCommand: "show",
+	docs: { brief: "Manage configuration" }
+});
 const routes = buildRouteMap({
 	routes: {
 		fetch: fetchCommand,
-		mcp: mcpCommand,
-		wallet: buildRouteMap({
+		mcp: buildRouteMap({
 			routes: {
-				info: walletInfoCommand,
-				history: walletHistoryCommand,
-				"export-key": walletExportCommand
+				proxy: mcpCommand,
+				add: mcpAddCommand
 			},
-			defaultCommand: "info",
-			docs: { brief: "Wallet management" }
-		}),
-		config: buildRouteMap({
-			routes: {
-				show: configShowCommand,
-				set: configSetCommand,
-				unset: configUnsetCommand
-			},
-			defaultCommand: "show",
-			docs: { brief: "Manage configuration" }
+			defaultCommand: "proxy",
+			docs: { brief: "MCP proxy and management" }
 		}),
+		wallet: walletRoutes,
+		config: configRoutes,
 		setup: setupCommand,
 		status: statusCommand
 	},
@@ -1220,7 +1427,7 @@ const routes = buildRouteMap({
 });
 const app = buildApplication(routes, {
 	name: "x402-proxy",
-	versionInfo: { currentVersion: "0.8.6" },
+	versionInfo: { currentVersion: "0.9.1" },
 	scanner: { caseStyle: "allow-kebab-for-camel" }
 });
 
@@ -1232,7 +1439,23 @@ function buildContext(process) {
 
 //#endregion
 //#region src/bin/cli.ts
-await run(app, process.argv.slice(2).map((a) => a === "-H" ? "--header" : a), buildContext(process));
+process.on("SIGINT", () => process.exit(130));
+const rawArgs = process.argv.slice(2);
+const args = [];
+for (let i = 0; i < rawArgs.length; i++) {
+	const a = rawArgs[i];
+	if (a === "-H") args.push("--header");
+	else if ((a === "--config-dir" || a === "-c") && i + 1 < rawArgs.length) {
+		const dir = resolve(rawArgs[++i]);
+		process.env.XDG_CONFIG_HOME = dir;
+		process.env.X402_PROXY_CONFIG_DIR_OVERRIDE = dir;
+	} else if (a.startsWith("--config-dir=")) {
+		const dir = resolve(a.slice(13));
+		process.env.XDG_CONFIG_HOME = dir;
+		process.env.X402_PROXY_CONFIG_DIR_OVERRIDE = dir;
+	} else args.push(a);
+}
+await run(app, args, buildContext(process));
 
 //#endregion
 export {  };

package/dist/{derive-BR6N1ZjI.js → derive-CAYmX-Yz.js}

@@ -1,7 +1,7 @@
 #!/usr/bin/env node
+import path from "node:path";
 import fs from "node:fs";
 import os from "node:os";
-import path from "node:path";
 import { parse, stringify } from "yaml";
 import { ed25519 } from "@noble/curves/ed25519.js";
 import { base58 } from "@scure/base";

package/dist/openclaw/plugin.js

@@ -726,7 +726,7 @@ function createWalletCommand(ctx) {
 			try {
 				const snap = await getWalletSnapshot(ctx.rpcUrl, walletAddress, ctx.historyPath);
 				const solscanUrl = `https://solscan.io/account/${walletAddress}`;
-				const lines = [`x402-proxy v0.8.6`];
+				const lines = [`x402-proxy v0.9.1`];
 				const defaultModel = ctx.allModels[0];
 				if (defaultModel) lines.push("", `**Model** - ${defaultModel.name} (${defaultModel.provider})`);
 				lines.push("", `**[Wallet](${solscanUrl})**`, `\`${walletAddress}\``);

package/dist/{setup-B1r-Opou.js → setup-B7YJa7s6.js}

@@ -1,15 +1,55 @@
 #!/usr/bin/env node
-import { d as saveWalletFile, i as getConfigDirShort, n as deriveSolanaKeypair, o as getWalletPath, r as generateMnemonic, s as isConfigured, t as deriveEvmKeypair, u as saveConfig } from "./derive-BR6N1ZjI.js";
+import { d as saveWalletFile, i as getConfigDirShort, l as loadWalletFile, n as deriveSolanaKeypair, o as getWalletPath, r as generateMnemonic, s as isConfigured, t as deriveEvmKeypair, u as saveConfig } from "./derive-CAYmX-Yz.js";
 import { buildCommand } from "@stricli/core";
 import pc from "picocolors";
 import * as prompts from "@clack/prompts";
 
 //#region src/commands/setup.ts
 async function runSetup(opts) {
+	const nonInteractive = opts?.nonInteractive ?? false;
+	if (nonInteractive && isConfigured() && !opts?.force) {
+		const walletFile = loadWalletFile();
+		if (walletFile) {
+			process.stdout.write(`${JSON.stringify({
+				base: walletFile.addresses.evm,
+				tempo: walletFile.addresses.evm,
+				solana: walletFile.addresses.solana
+			})}\n`);
+			return;
+		}
+	}
 	if (isConfigured() && !opts?.force) {
 		prompts.log.warn(`Already configured. Wallet at ${pc.dim(getWalletPath())}\nTo reconfigure, run:\n  ${pc.cyan("$ npx x402-proxy setup --force")}`);
 		return;
 	}
+	let mnemonic;
+	if (nonInteractive) {
+		if (opts?.importMnemonic) {
+			const words = opts.importMnemonic.trim().split(/\s+/);
+			if (words.length !== 12 && words.length !== 24) {
+				process.stderr.write("Error: mnemonic must be 12 or 24 words\n");
+				process.exit(1);
+			}
+			mnemonic = opts.importMnemonic.trim();
+		} else mnemonic = generateMnemonic();
+		const evm = deriveEvmKeypair(mnemonic);
+		const sol = deriveSolanaKeypair(mnemonic);
+		saveWalletFile({
+			version: 1,
+			mnemonic,
+			addresses: {
+				evm: evm.address,
+				solana: sol.address
+			}
+		});
+		saveConfig({ preferredProtocol: "x402" });
+		process.stdout.write(`${JSON.stringify({
+			base: evm.address,
+			tempo: evm.address,
+			solana: sol.address
+		})}\n`);
+		return;
+	}
 	prompts.intro(pc.cyan("x402-proxy setup"));
 	prompts.log.info("This will generate a single BIP-39 mnemonic that derives wallets for both Solana and EVM chains.");
 	const action = await prompts.select({
@@ -26,7 +66,6 @@ async function runSetup(opts) {
 		prompts.cancel("Setup cancelled.");
 		process.exit(0);
 	}
-	let mnemonic;
 	if (action === "generate") {
 		mnemonic = generateMnemonic();
 		prompts.log.warn("Write down your mnemonic and store it safely. It will NOT be shown again.");
@@ -48,6 +87,7 @@ async function runSetup(opts) {
 	const evm = deriveEvmKeypair(mnemonic);
 	const sol = deriveSolanaKeypair(mnemonic);
 	prompts.log.success(`Base address:   ${pc.green(evm.address)}`);
+	prompts.log.success(`Tempo address:  ${pc.green(evm.address)}`);
 	prompts.log.success(`Solana address: ${pc.green(sol.address)}`);
 	saveWalletFile({
 		version: 1,
@@ -64,7 +104,7 @@ async function runSetup(opts) {
 			label: "x402 - on-chain payments (Base, Solana)"
 		}, {
 			value: "mpp",
-			label: "MPP - streaming micropayments (Tempo)"
+			label: "MPP - machine payments over HTTP 402 (Tempo)"
 		}]
 	});
 	if (prompts.isCancel(protocol)) {
@@ -108,20 +148,49 @@ async function runSetup(opts) {
 	prompts.outro(pc.green("Setup complete!"));
 }
 const setupCommand = buildCommand({
-	docs: { brief: "Set up x402-proxy with a new wallet" },
+	docs: {
+		brief: "Set up x402-proxy wallet (generate new or import existing mnemonic)",
+		fullDescription: `Set up x402-proxy wallet interactively, or use --non-interactive for automated environments.
+
+Non-interactive mode auto-generates a wallet and outputs JSON to stdout:
+  $ npx x402-proxy setup --non-interactive
+  {"base":"0x...","tempo":"0x...","solana":"..."}
+
+Import an existing mnemonic non-interactively:
+  $ npx x402-proxy setup --non-interactive --import-mnemonic "word1 word2 ... word24"
+
+If a wallet already exists, --non-interactive outputs the existing addresses.`
+	},
 	parameters: {
-		flags: { force: {
-			kind: "boolean",
-			brief: "Overwrite existing configuration",
-			default: false
-		} },
+		flags: {
+			force: {
+				kind: "boolean",
+				brief: "Overwrite existing configuration",
+				default: false
+			},
+			nonInteractive: {
+				kind: "boolean",
+				brief: "Auto-generate wallet and output addresses as JSON (no prompts)",
+				default: false
+			},
+			importMnemonic: {
+				kind: "parsed",
+				brief: "Import a BIP-39 mnemonic (use with --non-interactive)",
+				parse: String,
+				optional: true
+			}
+		},
 		positional: {
 			kind: "tuple",
 			parameters: []
 		}
 	},
 	async func(flags) {
-		await runSetup({ force: flags.force });
+		await runSetup({
+			force: flags.force,
+			nonInteractive: flags.nonInteractive,
+			importMnemonic: flags.importMnemonic
+		});
 	}
 });
 

package/dist/setup-xhtYsp7D.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { n as setupCommand, t as runSetup } from "./setup-B7YJa7s6.js";
+
+export { runSetup };

package/dist/{status-DjudJ6fD.js → status-BkURZYDA.js}

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import { n as statusCommand, t as displayStatus } from "./status-DvSu8reM.js";
+import { n as statusCommand, t as displayStatus } from "./status-D3f5IVf6.js";
 
 export { displayStatus };

package/dist/{status-DvSu8reM.js → status-D3f5IVf6.js}

@@ -1,6 +1,6 @@
 #!/usr/bin/env node
-import { a as getHistoryPath, c as loadConfig, i as getConfigDirShort } from "./derive-BR6N1ZjI.js";
-import { c as resolveWallet, f as formatAmount, g as dim, h as readHistory, m as formatUsdcValue, n as fetchAllBalances, p as formatTxLine, t as balanceLine, u as calcSpend } from "./wallet-BiX5_XFY.js";
+import { a as getHistoryPath, c as loadConfig, i as getConfigDirShort } from "./derive-CAYmX-Yz.js";
+import { c as resolveWallet, f as formatAmount, g as dim, h as readHistory, m as formatUsdcValue, n as fetchAllBalances, p as formatTxLine, t as balanceLine, u as calcSpend } from "./wallet-DZsXptY7.js";
 import { buildCommand } from "@stricli/core";
 import pc from "picocolors";
 

package/dist/{wallet-BkZ0DOJL.js → wallet-BM0ngyqk.js}

@@ -1,4 +1,4 @@
 #!/usr/bin/env node
-import { a as fetchTempoBalances, i as fetchSolanaBalances, n as fetchAllBalances, o as walletInfoCommand, r as fetchEvmBalances, t as balanceLine } from "./wallet-BiX5_XFY.js";
+import { a as fetchTempoBalances, i as fetchSolanaBalances, n as fetchAllBalances, o as walletInfoCommand, r as fetchEvmBalances, t as balanceLine } from "./wallet-DZsXptY7.js";
 
 export { fetchAllBalances };

package/dist/{wallet-BiX5_XFY.js → wallet-DZsXptY7.js}

@@ -1,9 +1,9 @@
 #!/usr/bin/env node
-import { a as getHistoryPath, l as loadWalletFile, n as deriveSolanaKeypair, t as deriveEvmKeypair } from "./derive-BR6N1ZjI.js";
+import { a as getHistoryPath, l as loadWalletFile, n as deriveSolanaKeypair, t as deriveEvmKeypair } from "./derive-CAYmX-Yz.js";
+import { dirname } from "node:path";
 import { buildCommand } from "@stricli/core";
 import pc from "picocolors";
 import { appendFileSync, existsSync, mkdirSync, readFileSync, statSync, writeFileSync } from "node:fs";
-import { dirname } from "node:path";
 import { x402Client } from "@x402/fetch";
 import { ed25519 } from "@noble/curves/ed25519.js";
 import { base58 } from "@scure/base";
@@ -374,7 +374,7 @@ async function fetchSolanaBalances(ownerAddress) {
 	const usdcVal = usdcRes.result?.value;
 	return {
 		sol,
-		usdc: usdcVal ? formatUsdcValue(Number(usdcVal.uiAmountString)) : usdcVal === void 0 ? "?" : "0"
+		usdc: usdcVal ? formatUsdcValue(Number(usdcVal.uiAmountString)) : "0"
 	};
 }
 function balanceLine(usdc, native, nativeSymbol) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x402-proxy",
-  "version": "0.8.6",
+  "version": "0.9.1",
   "description": "curl for x402 paid APIs. Auto-pays any endpoint on Base, Solana, and Tempo. Also works as an OpenClaw plugin.",
   "type": "module",
   "sideEffects": false,
@@ -27,21 +27,22 @@
   },
   "dependencies": {
     "@clack/prompts": "^1.1.0",
+    "@getmcp/generators": "^0.10.1",
     "@modelcontextprotocol/sdk": "^1.27.1",
     "@noble/curves": "^2.0.1",
     "@noble/hashes": "^2.0.1",
     "@scure/base": "^2.0.0",
     "@scure/bip32": "^2.0.1",
     "@scure/bip39": "^2.0.1",
-    "@solana/kit": "^6.0.0",
     "@sinclair/typebox": "^0.34.48",
+    "@solana/kit": "^6.0.0",
     "@stricli/core": "^1.2.6",
     "@x402/evm": "^2.6.0",
     "@x402/fetch": "^2.6.0",
     "@x402/mcp": "^2.6.0",
-    "mppx": "^0.4.9",
     "@x402/svm": "^2.6.0",
     "ethers": "^6.0.0",
+    "mppx": "^0.4.9",
     "picocolors": "^1.1.1",
     "viem": "^2.0.0",
     "yaml": "^2.8.2"

package/skills/SKILL.md

@@ -42,6 +42,7 @@ npx x402-proxy https://api.example.com/data > response.json
 ```
 x402-proxy <url>                        # paid HTTP request (default)
 x402-proxy mcp <url>                    # MCP stdio proxy for AI agents
+x402-proxy mcp add <name> <url>         # install MCP server into AI client
 x402-proxy setup                        # wallet onboarding wizard
 x402-proxy setup --force                # re-run setup (overwrite existing wallet)
 x402-proxy status                       # config + wallet + daily spend summary
@@ -70,23 +71,39 @@ x402-proxy wallet export-key mnemonic   # bare mnemonic to stdout
 
 ## MCP proxy for AI agents
 
-Drop into Claude, Cursor, or any MCP client config:
+Quick setup (auto-detects installed AI clients):
+
+```bash
+x402-proxy mcp add surf https://surf.cascade.fyi/mcp
+```
+
+Or drop into your client config manually:
 
 ```json
 {
   "mcpServers": {
-    "paid-service": {
+    "surf": {
       "command": "npx",
-      "args": ["x402-proxy", "mcp", "https://mcp.example.com/sse"],
-      "env": {
-        "X402_PROXY_WALLET_MNEMONIC": "your 24 words here"
-      }
+      "args": ["-y", "x402-proxy", "mcp", "https://surf.cascade.fyi/mcp"]
     }
   }
 }
 ```
 
-The proxy intercepts 402 responses, pays automatically, forwards the result. Supports StreamableHTTP and SSE.
+For OpenClaw:
+
+```bash
+openclaw mcp set surf '{"command":"npx","args":["-y","x402-proxy","mcp","https://surf.cascade.fyi/mcp"]}'
+```
+
+The wallet is auto-generated on first run and stored at `~/.config/x402-proxy/wallet.json`. No env vars needed. The proxy intercepts 402 responses, pays automatically, forwards the result. Supports StreamableHTTP and SSE.
+
+For non-interactive setup (e.g. automated provisioning):
+
+```bash
+npx x402-proxy setup --non-interactive
+# outputs: {"evm":"0x...","solana":"..."}
+```
 
 ## Wallet & env vars
 

package/dist/setup-CH4woul8.js

@@ -1,4 +0,0 @@
-#!/usr/bin/env node
-import { n as setupCommand, t as runSetup } from "./setup-B1r-Opou.js";
-
-export { runSetup };