x402-proxy 0.9.0 → 0.9.1

package/CHANGELOG.md

@@ -7,6 +7,20 @@ 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
@@ -263,7 +277,8 @@ 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.9.0...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

package/README.md

@@ -19,7 +19,7 @@ Let your AI agent consume any paid MCP server.
 ### Quick setup
 
 ```bash
-npx x402-proxy mcp add my-service https://mcp.example.com/sse
+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.
@@ -31,18 +31,21 @@ 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
 
@@ -110,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,7 +1,7 @@
 #!/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-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-BjyoqzT3.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";
@@ -453,7 +453,7 @@ Examples:
 				process.exit(1);
 			}
 			dim("  No wallet found. Let's set one up first.\n");
-			const { runSetup } = await import("../setup-CJgw4opQ.js");
+			const { runSetup } = await import("../setup-xhtYsp7D.js");
 			await runSetup();
 			console.log();
 			wallet = resolveWallet();
@@ -764,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: {
@@ -808,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}`);
@@ -863,7 +874,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.9.0"
+				version: "0.9.1"
 			});
 			const x402Mcp = new x402MCPClient(remoteClient, x402PaymentClient, {
 				autoPayment: true,
@@ -901,7 +912,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.9.0"
+				version: "0.9.1"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -996,7 +1007,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}));
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.9.0"
+				version: "0.9.1"
 			});
 			await connectTransport(remoteClient);
 			const mppClient = McpClient.wrap(remoteClient, { methods: wrappedMethods });
@@ -1011,7 +1022,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.9.0"
+				version: "0.9.1"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -1197,6 +1208,7 @@ const mcpAddCommand = buildCommand({
 		const generated = generateConfig(clientId, serverName, {
 			command: "npx",
 			args: [
+				"-y",
 				"x402-proxy",
 				"mcp",
 				url
@@ -1415,7 +1427,7 @@ const routes = buildRouteMap({
 });
 const app = buildApplication(routes, {
 	name: "x402-proxy",
-	versionInfo: { currentVersion: "0.9.0" },
+	versionInfo: { currentVersion: "0.9.1" },
 	scanner: { caseStyle: "allow-kebab-for-camel" }
 });
 

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.9.0`];
+				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-BjyoqzT3.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-CAYmX-Yz.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.");
@@ -109,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/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x402-proxy",
-  "version": "0.9.0",
+  "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,

package/skills/SKILL.md

@@ -74,7 +74,7 @@ x402-proxy wallet export-key mnemonic   # bare mnemonic to stdout
 Quick setup (auto-detects installed AI clients):
 
 ```bash
-x402-proxy mcp add my-service https://mcp.example.com/sse
+x402-proxy mcp add surf https://surf.cascade.fyi/mcp
 ```
 
 Or drop into your client config manually:
@@ -82,18 +82,28 @@ 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-CJgw4opQ.js

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