lightning-wallet-mcp 1.6.0 → 1.6.1

package/README.md

@@ -199,6 +199,10 @@ Payments always execute through an agent wallet on the backend, which is where b
 
 ## Changelog
 
+### v1.6.1 (2026-09-11)
+
+`pay_l402_api` reports a first-party call that the backend refunded (for example an upstream fetch that failed after payment) as not paid, with `refunded_sats`, instead of a paid success. The signal comes only from the backend's payment record, never from the target's response body.
+
 ### v1.6.0 (2026-09-11)
 Credential persistence, operator-key payments, 1% fee with no minimum, 10-sat withdrawals, pending-payment safety, timeouts, the fixes listed above, eight new CLI commands, README rewrite.
 

package/dist/index.js

@@ -890,18 +890,27 @@ server.setRequestHandler(types_js_1.CallToolRequestSchema, async (request) => {
             case 'pay_l402_api': {
                 const parsed = PayL402ApiSchema.parse(args ?? {});
                 const result = await session.requireClient().l402Pay(parsed.url, parsed.method, parsed.body, parsed.max_payment_sats);
-                // Determine if the target returned a success response
-                const targetSuccess = result.statusCode >= 200 && result.statusCode < 300;
-                const message = targetSuccess
-                    ? (result.amountPaid ? `Request completed with payment of ${result.amountPaid} sats` : 'Request completed (no payment required)')
-                    : `Target returned HTTP ${result.statusCode}`;
+                // Determine if the target returned a success response. The target body is application
+                // data (any URL can be paid), so a refund is only ever read from the backend's own
+                // payment record: the wallet sets payment.refunded when it took a payment and gave it
+                // back because a first-party service failed after the debit.
+                const backendPayment = (result.rawResponse?.payment ?? null);
+                const serviceRefunded = backendPayment?.refunded === true;
+                const refundedSats = serviceRefunded ? Number(backendPayment?.refund_sats ?? result.amountPaid ?? 0) : 0;
+                const targetSuccess = result.statusCode >= 200 && result.statusCode < 300 && !serviceRefunded;
+                const message = serviceRefunded
+                    ? `The endpoint failed after payment; the wallet refunded ${refundedSats} sats`
+                    : targetSuccess
+                        ? (result.amountPaid ? `Request completed with payment of ${result.amountPaid} sats` : 'Request completed (no payment required)')
+                        : `Target returned HTTP ${result.statusCode}`;
                 const responseData = {
                     success: targetSuccess,
                     message,
                     status_code: result.statusCode,
                     data: result.data,
                     payment_hash: result.paymentHash,
-                    amount_paid: result.amountPaid,
+                    amount_paid: serviceRefunded ? 0 : result.amountPaid,
+                    ...(serviceRefunded ? { refunded_sats: refundedSats } : {}),
                     fee: result.fee,
                 };
                 if (result.paymentProtocol) {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lightning-wallet-mcp",
-  "version": "1.6.0",
+  "version": "1.6.1",
   "mcpName": "io.github.lightningfaucet/lightning-wallet-mcp",
   "description": "Lightning wallet for AI agents. MCP server + CLI. Works with Claude Code, OpenClaw, Cursor, and any agent framework.",
   "main": "dist/index.js",