x402-proxy 0.4.2 → 0.5.0

package/CHANGELOG.md

@@ -7,6 +7,17 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ## [Unreleased]
 
+## [0.5.0] - 2026-03-16
+
+### Changed
+- MCP proxy graduated from alpha to stable - removed alpha warning and label
+- MCP proxy uses low-level `Server` class instead of `McpServer` to proxy raw JSON schemas verbatim without Zod conversion
+- MCP proxy now forwards blob resource contents (previously only text was proxied)
+- MCP content type widened to pass through all MCP content types (image, audio, resource_link) not just text
+
+### Added
+- MCP proxy forwards `notifications/tools/list_changed` and `notifications/resources/list_changed` from remote servers so local clients stay in sync with dynamic tool/resource updates
+
 ## [0.4.2] - 2026-03-16
 
 ### Fixed
@@ -105,7 +116,7 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 ### Added
 - CLI binary accessible via `npx x402-proxy`
 - `fetch` command (default) - curl-like HTTP client with automatic x402 payment
-- `mcp` command (alpha) - MCP stdio proxy with auto-payment for AI agents
+- `mcp` command - MCP stdio proxy with auto-payment for AI agents
 - `setup` command - interactive onboarding wizard with @clack/prompts
 - `status` command - config, wallet, and spend summary
 - `wallet` subcommand with `info`, `history`, `fund`, `export-key`
@@ -129,7 +140,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.4.2...HEAD
+[Unreleased]: https://github.com/cascade-protocol/x402-proxy/compare/v0.5.0...HEAD
+[0.5.0]: https://github.com/cascade-protocol/x402-proxy/compare/v0.4.2...v0.5.0
 [0.4.2]: https://github.com/cascade-protocol/x402-proxy/compare/v0.4.1...v0.4.2
 [0.4.1]: https://github.com/cascade-protocol/x402-proxy/compare/v0.4.0...v0.4.1
 [0.4.0]: https://github.com/cascade-protocol/x402-proxy/compare/v0.3.2...v0.4.0

package/dist/bin/cli.js

@@ -330,7 +330,7 @@ Examples:
 //#region src/commands/mcp.ts
 const mcpCommand = buildCommand({
 	docs: {
-		brief: "Start MCP stdio proxy with x402 payment (alpha)",
+		brief: "Start MCP stdio proxy with x402 payment",
 		fullDescription: `Start an MCP stdio proxy with automatic x402 payment for AI agents.
 
 Add to your MCP client config (Claude, Cursor, etc.):
@@ -376,7 +376,6 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			error("No wallet configured.\nRun:\n  $ npx x402-proxy setup\n\nOr set X402_PROXY_WALLET_MNEMONIC");
 			process.exit(1);
 		}
-		warn("Note: MCP proxy is alpha - please report issues.");
 		dim(`x402-proxy MCP proxy -> ${remoteUrl}`);
 		if (wallet.evmAddress) dim(`  EVM:    ${wallet.evmAddress}`);
 		if (wallet.solanaAddress) dim(`  Solana: ${wallet.solanaAddress}`);
@@ -399,13 +398,14 @@ Add to your MCP client config (Claude, Cursor, etc.):
 		const { Client } = await import("@modelcontextprotocol/sdk/client/index.js");
 		const { SSEClientTransport } = await import("@modelcontextprotocol/sdk/client/sse.js");
 		const { StreamableHTTPClientTransport } = await import("@modelcontextprotocol/sdk/client/streamableHttp.js");
-		const { McpServer } = await import("@modelcontextprotocol/sdk/server/mcp.js");
+		const { Server } = await import("@modelcontextprotocol/sdk/server/index.js");
 		const { StdioServerTransport } = await import("@modelcontextprotocol/sdk/server/stdio.js");
 		const { x402MCPClient } = await import("@x402/mcp");
-		const x402Mcp = new x402MCPClient(new Client({
+		const remoteClient = new Client({
 			name: "x402-proxy",
-			version: "0.4.2"
-		}), x402PaymentClient, {
+			version: "0.5.0"
+		});
+		const x402Mcp = new x402MCPClient(remoteClient, x402PaymentClient, {
 			autoPayment: true,
 			onPaymentRequested: (ctx) => {
 				const accept = ctx.paymentRequired.accepts?.[0];
@@ -447,31 +447,58 @@ Add to your MCP client config (Claude, Cursor, etc.):
 			error(`Failed to connect to ${remoteUrl}: ${err instanceof Error ? err.message : String(err)}`);
 			process.exit(1);
 		}
-		const { tools } = await x402Mcp.listTools();
+		let { tools } = await x402Mcp.listTools();
 		dim(`  ${tools.length} tools available`);
-		const localServer = new McpServer({
+		let remoteResources = [];
+		try {
+			remoteResources = (await x402Mcp.listResources()).resources;
+			if (remoteResources.length > 0) dim(`  ${remoteResources.length} resources available`);
+		} catch {
+			dim("  Resources not available from remote");
+		}
+		const localServer = new Server({
 			name: "x402-proxy",
-			version: "0.4.2"
-		});
-		for (const tool of tools) localServer.tool(tool.name, tool.description ?? "", tool.inputSchema?.properties ? Object.fromEntries(Object.entries(tool.inputSchema.properties).map(([k, v]) => [k, v])) : {}, async (args) => {
-			const result = await x402Mcp.callTool(tool.name, args);
+			version: "0.5.0"
+		}, { capabilities: {
+			tools: tools.length > 0 ? {} : void 0,
+			resources: remoteResources.length > 0 ? {} : void 0
+		} });
+		const { ListToolsRequestSchema, CallToolRequestSchema, ListResourcesRequestSchema, ReadResourceRequestSchema, ToolListChangedNotificationSchema, ResourceListChangedNotificationSchema } = await import("@modelcontextprotocol/sdk/types.js");
+		localServer.setRequestHandler(ListToolsRequestSchema, async () => ({ tools: tools.map((t) => ({
+			name: t.name,
+			description: t.description,
+			inputSchema: t.inputSchema,
+			annotations: t.annotations
+		})) }));
+		localServer.setRequestHandler(CallToolRequestSchema, async (request) => {
+			const { name, arguments: args } = request.params;
+			const result = await x402Mcp.callTool(name, args ?? {});
 			return {
 				content: result.content,
 				isError: result.isError
 			};
 		});
-		try {
-			const { resources } = await x402Mcp.listResources();
-			if (resources.length > 0) {
-				dim(`  ${resources.length} resources available`);
-				for (const resource of resources) localServer.resource(resource.name, resource.uri, resource.description ? { description: resource.description } : {}, async (uri) => {
-					return { contents: (await x402Mcp.readResource({ uri: uri.href })).contents.map((c) => ({
-						uri: c.uri,
-						text: "text" in c ? c.text : ""
-					})) };
-				});
-			}
-		} catch {}
+		if (remoteResources.length > 0) {
+			localServer.setRequestHandler(ListResourcesRequestSchema, async () => ({ resources: remoteResources.map((r) => ({
+				name: r.name,
+				uri: r.uri,
+				description: r.description,
+				mimeType: r.mimeType
+			})) }));
+			localServer.setRequestHandler(ReadResourceRequestSchema, async (request) => {
+				return { contents: (await x402Mcp.readResource({ uri: request.params.uri })).contents.map((c) => ({ ...c })) };
+			});
+		}
+		remoteClient.setNotificationHandler(ToolListChangedNotificationSchema, async () => {
+			tools = (await x402Mcp.listTools()).tools;
+			dim(`  Tools updated: ${tools.length} available`);
+			await localServer.notification({ method: "notifications/tools/list_changed" });
+		});
+		if (remoteResources.length > 0) remoteClient.setNotificationHandler(ResourceListChangedNotificationSchema, async () => {
+			remoteResources = (await x402Mcp.listResources()).resources;
+			dim(`  Resources updated: ${remoteResources.length} available`);
+			await localServer.notification({ method: "notifications/resources/list_changed" });
+		});
 		const stdioTransport = new StdioServerTransport();
 		await localServer.connect(stdioTransport);
 		dim("  MCP proxy running (stdio)");
@@ -608,7 +635,7 @@ const routes = buildRouteMap({
 });
 const app = buildApplication(routes, {
 	name: "x402-proxy",
-	versionInfo: { currentVersion: "0.4.2" },
+	versionInfo: { currentVersion: "0.5.0" },
 	scanner: { caseStyle: "allow-kebab-for-camel" }
 });
 

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "x402-proxy",
-  "version": "0.4.2",
+  "version": "0.5.0",
   "description": "curl for x402 paid APIs. Auto-pays any endpoint on Base and Solana.",
   "type": "module",
   "sideEffects": false,