x402-proxy 0.8.5 → 0.9.0

package/CHANGELOG.md

@@ -7,6 +7,28 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [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
+- Example URLs in help output and setup wizard: `/user/` corrected to `/users/` (was returning 404)
+
 ## [0.8.5] - 2026-03-24
 
 ### Fixed
@@ -241,7 +263,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.0...HEAD
+[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
 [0.8.3]: https://github.com/cascade-protocol/x402-proxy/compare/v0.8.2...v0.8.3

package/README.md

@@ -14,7 +14,19 @@ 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 my-service https://mcp.example.com/sse
+```
+
+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
 {
@@ -67,6 +79,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 +90,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
 

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-Di_b5Vp9.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-BjyoqzT3.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";
@@ -310,7 +313,7 @@ const fetchCommand = buildCommand({
 		fullDescription: `Make a paid HTTP request. Payment is automatic when the server returns 402.
 
 Examples:
-  $ x402-proxy https://twitter.surf.cascade.fyi/user/cascade_fyi
+  $ x402-proxy https://twitter.surf.cascade.fyi/users/cascade_fyi
   $ x402-proxy -X POST -d '{"url":"https://x402.org"}' https://web.surf.cascade.fyi/v1/crawl
   $ x402-proxy https://api.example.com/data | jq '.results'`
 	},
@@ -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:"));
@@ -408,7 +411,7 @@ Examples:
 				console.log(`    ${pc.cyan("$ npx x402-proxy wallet")}             Addresses and balances`);
 				console.log(`    ${pc.cyan("$ npx x402-proxy wallet history")}     Full payment history`);
 				console.log();
-				console.log(pc.dim("  try: ") + pc.cyan("$ npx x402-proxy https://twitter.surf.cascade.fyi/user/cascade_fyi"));
+				console.log(pc.dim("  try: ") + pc.cyan("$ npx x402-proxy https://twitter.surf.cascade.fyi/users/cascade_fyi"));
 				console.log();
 				console.log(pc.dim("  https://github.com/cascade-protocol/x402-proxy"));
 				console.log();
@@ -450,7 +453,7 @@ Examples:
 				process.exit(1);
 			}
 			dim("  No wallet found. Let's set one up first.\n");
-			const { runSetup } = await import("../setup-CJwYRd78.js");
+			const { runSetup } = await import("../setup-CJgw4opQ.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;
@@ -840,7 +843,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 +863,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.8.5"
+				version: "0.9.0"
 			});
 			const x402Mcp = new x402MCPClient(remoteClient, x402PaymentClient, {
 				autoPayment: true,
@@ -898,7 +901,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.8.5"
+				version: "0.9.0"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -993,7 +996,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}));
 			const remoteClient = new Client({
 				name: "x402-proxy",
-				version: "0.8.5"
+				version: "0.9.0"
 			});
 			await connectTransport(remoteClient);
 			const mppClient = McpClient.wrap(remoteClient, { methods: wrappedMethods });
@@ -1008,7 +1011,7 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			}
 			const localServer = new Server({
 				name: "x402-proxy",
-				version: "0.8.5"
+				version: "0.9.0"
 			}, { capabilities: {
 				tools: tools.length > 0 ? {} : void 0,
 				resources: remoteResources.length > 0 ? {} : void 0
@@ -1085,6 +1088,189 @@ 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: [
+				"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 +1376,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 +1415,7 @@ const routes = buildRouteMap({
 });
 const app = buildApplication(routes, {
 	name: "x402-proxy",
-	versionInfo: { currentVersion: "0.8.5" },
+	versionInfo: { currentVersion: "0.9.0" },
 	scanner: { caseStyle: "allow-kebab-for-camel" }
 });
 
@@ -1232,7 +1427,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.5`];
+				const lines = [`x402-proxy v0.9.0`];
 				const defaultModel = ctx.allModels[0];
 				if (defaultModel) lines.push("", `**Model** - ${defaultModel.name} (${defaultModel.provider})`);
 				lines.push("", `**[Wallet](${solscanUrl})**`, `\`${walletAddress}\``);

package/dist/{setup-Di_b5Vp9.js → setup-BjyoqzT3.js}

@@ -1,5 +1,5 @@
 #!/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, 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";
@@ -48,6 +48,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 +65,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)) {
@@ -104,7 +105,7 @@ async function runSetup(opts) {
 	prompts.log.message(`  Solana (USDC): Send USDC to ${pc.cyan(sol.address)}`);
 	prompts.log.message(`  Base (USDC):   Send USDC to ${pc.cyan(evm.address)}`);
 	prompts.log.step("Try your first request:");
-	prompts.log.message(`  ${pc.cyan("$ npx x402-proxy https://twitter.surf.cascade.fyi/user/cascade_fyi")}`);
+	prompts.log.message(`  ${pc.cyan("$ npx x402-proxy https://twitter.surf.cascade.fyi/users/cascade_fyi")}`);
 	prompts.outro(pc.green("Setup complete!"));
 }
 const setupCommand = buildCommand({

package/dist/setup-CJgw4opQ.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { n as setupCommand, t as runSetup } from "./setup-BjyoqzT3.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.5",
+  "version": "0.9.0",
   "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,7 +71,13 @@ 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 my-service https://mcp.example.com/sse
+```
+
+Or drop into your client config manually:
 
 ```json
 {

package/dist/setup-CJwYRd78.js

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