@agentwonderland/mcp 0.1.41 → 0.1.42

package/dist/core/__tests__/api-client.test.js

@@ -46,7 +46,7 @@ describe("api-client headers", () => {
                 "X-AW-Consumer-Principal": "did:pkh:solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp:42W2HfLfveSm1T5et9WTLp2CZ2QXdF2EYCUvyJ2gPpxF",
                 "X-AW-Rebate-Principal": "did:pkh:eip155:8453:0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
                 "X-AW-Surface": "mcp",
-                "X-AW-MCP-Version": "0.1.41",
+                "X-AW-MCP-Version": "0.1.42",
                 "X-AW-MCP-Tool": "run_agent",
                 "X-AW-MCP-Action": "execute",
             }),

package/dist/core/api-client.js

@@ -12,7 +12,7 @@ export class ApiError extends Error {
         this.name = "ApiError";
     }
 }
-const MCP_VERSION = "0.1.41";
+const MCP_VERSION = "0.1.42";
 function inferToolHeaders(path, method) {
     if (path === "/solve") {
         return { "X-AW-MCP-Tool": "solve", "X-AW-MCP-Action": method === "POST" ? "execute" : "view" };

package/dist/core/ows-adapter.js

@@ -7,6 +7,9 @@
  * The OWS SDK (`@open-wallet-standard/core`) is a NAPI native module.
  * ALL imports are dynamic so the MCP server works without OWS installed.
  */
+import { createHmac } from "node:crypto";
+import { mnemonicToSeedSync, validateMnemonic } from "@scure/bip39";
+import { wordlist } from "@scure/bip39/wordlists/english";
 // ── Helpers ──────────────────────────────────────────────────────
 const OWS_INSTALL_HINT = "OWS is not installed. Install with: npm install -g @open-wallet-standard/core";
 async function loadOws() {
@@ -58,6 +61,51 @@ function keypairFromEd25519Hex(privateKeyHex, KeypairCtor) {
     }
     throw new Error(`Unsupported ed25519 key length: ${bytes.length} bytes.`);
 }
+function parseExportedSecret(exported) {
+    const secret = exported.trim();
+    try {
+        const parsed = JSON.parse(secret);
+        if (parsed.secp256k1 || parsed.ed25519 || parsed.mnemonic)
+            return parsed;
+    }
+    catch {
+        // OWS-created wallets export a BIP-39 mnemonic, not a JSON key object.
+    }
+    const hex = secret.startsWith("0x") ? secret.slice(2) : secret;
+    if (/^[0-9a-fA-F]+$/.test(hex)) {
+        if (hex.length === 64)
+            return { secp256k1: hex, ed25519: hex };
+        if (hex.length === 128)
+            return { ed25519: hex };
+    }
+    if (validateMnemonic(secret, wordlist)) {
+        return { mnemonic: secret };
+    }
+    return {};
+}
+function deriveSolanaSeedFromMnemonic(mnemonic, path = "m/44'/501'/0'/0'") {
+    const seed = mnemonicToSeedSync(mnemonic);
+    let digest = createHmac("sha512", "ed25519 seed").update(seed).digest();
+    let key = digest.subarray(0, 32);
+    let chainCode = digest.subarray(32);
+    for (const part of path.split("/").slice(1)) {
+        if (!part.endsWith("'")) {
+            throw new Error(`Unsupported non-hardened ed25519 path segment: ${part}`);
+        }
+        const index = Number(part.slice(0, -1));
+        if (!Number.isInteger(index) || index < 0) {
+            throw new Error(`Unsupported ed25519 path segment: ${part}`);
+        }
+        const data = Buffer.alloc(37);
+        data[0] = 0;
+        Buffer.from(key).copy(data, 1);
+        data.writeUInt32BE(index + 0x80000000, 33);
+        digest = createHmac("sha512", chainCode).update(data).digest();
+        key = digest.subarray(0, 32);
+        chainCode = digest.subarray(32);
+    }
+    return Uint8Array.from(key);
+}
 // ── Public API ───────────────────────────────────────────────────
 /**
  * Check whether the OWS native module can be loaded.
@@ -160,7 +208,11 @@ export async function owsAccountFromWalletId(walletId, _chain) {
     // (EIP-5806 delegate calls) which OWS's native signing can't serialize.
     // OWS provides encrypted storage at rest; viem handles signing in memory.
     const exported = ows.exportWallet(walletId);
-    const keys = JSON.parse(exported);
+    const keys = parseExportedSecret(exported);
+    if (keys.mnemonic) {
+        const { mnemonicToAccount } = await import("viem/accounts");
+        return mnemonicToAccount(keys.mnemonic);
+    }
     if (!keys.secp256k1) {
         throw new Error(`Wallet "${wallet.name}" has no secp256k1 key for EVM signing.`);
     }
@@ -172,11 +224,14 @@ export async function owsSolanaKeypairFromWalletId(walletId) {
     const wallet = ows.getWallet(walletId);
     findSolanaAccount(wallet);
     const exported = ows.exportWallet(walletId);
-    const keys = JSON.parse(exported);
+    const keys = parseExportedSecret(exported);
+    const { Keypair } = await import("@solana/web3.js");
+    if (keys.mnemonic) {
+        return Keypair.fromSeed(deriveSolanaSeedFromMnemonic(keys.mnemonic));
+    }
     if (!keys.ed25519) {
         throw new Error(`Wallet "${wallet.name}" has no ed25519 key for Solana signing.`);
     }
-    const { Keypair } = await import("@solana/web3.js");
     return keypairFromEd25519Hex(keys.ed25519, Keypair);
 }
 export async function getOwsWalletAddress(walletId, chain = "evm") {

package/dist/core/payments.js

@@ -53,52 +53,42 @@ function clearStaleCardCache(activeKey) {
 }
 // ── Per-protocol initializers ───────────────────────────────────
 async function initEvmMppForChain(wallet, chain) {
-    try {
-        const { Mppx } = await import("./mpp-client.js");
-        let account;
-        if (wallet.keyType === "ows" && wallet.owsWalletId) {
-            const { owsAccountFromWalletId } = await import("./ows-adapter.js");
-            account = await owsAccountFromWalletId(wallet.owsWalletId);
-        }
-        else if (wallet.key) {
-            const { privateKeyToAccount } = await import("viem/accounts");
-            account = privateKeyToAccount(normalizeKey(wallet.key));
-        }
-        else {
-            return null;
-        }
-        const methods = [];
-        if (chain === "tempo") {
-            const { tempoChargeClient } = await import("./tempo-charge.js");
-            methods.push(tempoChargeClient({ account }));
-        }
-        else {
-            const { baseChargeClient } = await import("./base-charge.js");
-            methods.push(baseChargeClient({ account }));
-        }
-        const mppx = Mppx.create({ methods: methods, polyfill: false });
-        return mppx.fetch.bind(mppx);
+    const { Mppx } = await import("./mpp-client.js");
+    let account;
+    if (wallet.keyType === "ows" && wallet.owsWalletId) {
+        const { owsAccountFromWalletId } = await import("./ows-adapter.js");
+        account = await owsAccountFromWalletId(wallet.owsWalletId);
     }
-    catch {
+    else if (wallet.key) {
+        const { privateKeyToAccount } = await import("viem/accounts");
+        account = privateKeyToAccount(normalizeKey(wallet.key));
+    }
+    else {
         return null;
     }
+    const methods = [];
+    if (chain === "tempo") {
+        const { tempoChargeClient } = await import("./tempo-charge.js");
+        methods.push(tempoChargeClient({ account }));
+    }
+    else {
+        const { baseChargeClient } = await import("./base-charge.js");
+        methods.push(baseChargeClient({ account }));
+    }
+    const mppx = Mppx.create({ methods: methods, polyfill: false });
+    return mppx.fetch.bind(mppx);
 }
 async function initSolanaMpp(wallet) {
-    try {
-        if (wallet.keyType !== "ows" && !wallet.key) {
-            return null;
-        }
-        const { Mppx } = await import("./mpp-client.js");
-        const { solanaChargeClient } = await import("./solana-charge.js");
-        const mppx = Mppx.create({
-            methods: [solanaChargeClient({ wallet })],
-            polyfill: false,
-        });
-        return mppx.fetch.bind(mppx);
-    }
-    catch {
+    if (wallet.keyType !== "ows" && !wallet.key) {
         return null;
     }
+    const { Mppx } = await import("./mpp-client.js");
+    const { solanaChargeClient } = await import("./solana-charge.js");
+    const mppx = Mppx.create({
+        methods: [solanaChargeClient({ wallet })],
+        polyfill: false,
+    });
+    return mppx.fetch.bind(mppx);
 }
 async function initCard() {
     const cardConfig = getCardConfig();
@@ -149,6 +139,10 @@ async function initForChain(wallet, chain) {
     }
     return null;
 }
+function initFailureMessage(method, wallet, chain, err) {
+    const reason = err instanceof Error ? err.message : String(err);
+    return `Payment method "${method}" is configured as ${chain} on wallet "${wallet.id}", but the signer could not initialize: ${reason}`;
+}
 // ── Public API ──────────────────────────────────────────────────
 /**
  * Returns a payment-aware fetch for a specific method, or the best
@@ -185,7 +179,13 @@ export async function getPaymentFetch(method) {
         const ck = cacheKey(resolved.wallet.id, resolved.chain);
         if (fetchCache.has(ck))
             return fetchCache.get(ck);
-        const pf = await initForChain(resolved.wallet, resolved.chain);
+        let pf;
+        try {
+            pf = await initForChain(resolved.wallet, resolved.chain);
+        }
+        catch (err) {
+            throw new Error(initFailureMessage(method, resolved.wallet, resolved.chain, err));
+        }
         if (pf) {
             fetchCache.set(ck, pf);
             return pf;
@@ -234,7 +234,18 @@ export async function getPaymentFetch(method) {
         const ck = cacheKey(resolved.wallet.id, resolved.chain);
         if (fetchCache.has(ck))
             return fetchCache.get(ck);
-        const pf = await initForChain(resolved.wallet, resolved.chain);
+        let pf;
+        try {
+            pf = await initForChain(resolved.wallet, resolved.chain);
+        }
+        catch (err) {
+            if (m === defaultMethod) {
+                const others = configured.filter((x) => x !== m);
+                const altText = others.length > 0 ? ` Alternatives: ${others.join(", ")}` : "";
+                throw new Error(`${initFailureMessage(m, resolved.wallet, resolved.chain, err)}.${altText}`);
+            }
+            continue;
+        }
         if (pf) {
             fetchCache.set(ck, pf);
             return pf;

package/dist/index.js

@@ -22,7 +22,7 @@ import { registerJobResources } from "./resources/jobs.js";
 // ── Prompts ──────────────────────────────────────────────────────
 import { registerPrompts } from "./prompts/index.js";
 import { runSetupCli } from "./setup.js";
-const PACKAGE_VERSION = "0.1.41";
+const PACKAGE_VERSION = "0.1.42";
 export async function startMcpServer() {
     const server = new McpServer({
         name: "agentwonderland",

package/dist/tools/wallet.js

@@ -213,6 +213,8 @@ export function registerWalletTools(server) {
                         "",
                         chainStatus,
                         "",
+                        "No MCP restart is required for wallet changes.",
+                        "",
                         `Fund this address with USDC on ${defaultCh === "solana" ? "Solana" : "Tempo"} to start using agents.`,
                     ].join("\n"));
                 }
@@ -244,6 +246,8 @@ export function registerWalletTools(server) {
                         `  Chains: solana`,
                         `  Consumer principal: ${principal}`,
                         "",
+                        "No MCP restart is required for wallet changes.",
+                        "",
                         "Fund this address with USDC on Solana to start using agents.",
                     ].join("\n") + owsNudge);
                 }
@@ -269,6 +273,8 @@ export function registerWalletTools(server) {
                     `  Chains: tempo, base`,
                     `  Consumer principal: ${principal}`,
                     "",
+                    "No MCP restart is required for wallet changes.",
+                    "",
                     `Fund this address with USDC on Tempo or Base to start using agents.`,
                 ].join("\n") + owsNudge);
             }
@@ -293,6 +299,8 @@ export function registerWalletTools(server) {
                 `  Storage: ~/.ows/ (AES-256-GCM encrypted)`,
                 `  Consumer principal: ${principal}`,
                 "",
+                "No MCP restart is required for wallet changes.",
+                "",
                 `Fund this address with USDC on ${defaultCh === "solana" ? "Solana" : "Tempo"} to start using agents.`,
                 "For testnet: npx mppx account fund",
             ].join("\n"));
@@ -317,6 +325,8 @@ export function registerWalletTools(server) {
                 `  Name: ${walletName}`,
                 `  Chains: ${selectedChains.join(", ")}`,
                 `  Consumer principal: ${principal}`,
+                "",
+                "No MCP restart is required for wallet changes.",
             ].join("\n"));
         }
         if (defaultCh === "solana") {
@@ -345,6 +355,8 @@ export function registerWalletTools(server) {
                     `  Name: ${walletName}`,
                     `  Chains: solana`,
                     `  Consumer principal: ${principal}`,
+                    "",
+                    "No MCP restart is required for wallet changes.",
                 ].join("\n") + owsNudge);
             }
             catch (err) {
@@ -376,6 +388,8 @@ export function registerWalletTools(server) {
                 `  Name: ${walletName}`,
                 `  Chains: ${selectedChains.join(", ")}`,
                 `  Consumer principal: ${principal}`,
+                "",
+                "No MCP restart is required for wallet changes.",
             ].join("\n") + owsNudge);
         }
         catch {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentwonderland/mcp",
-  "version": "0.1.41",
+  "version": "0.1.42",
   "type": "module",
   "description": "MCP server for the Agent Wonderland AI agent marketplace",
   "bin": {
@@ -23,6 +23,7 @@
   },
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.12.1",
+    "@scure/bip39": "^1.6.0",
     "@solana/spl-token": "^0.4.14",
     "@solana/web3.js": "1.95.8",
     "qrcode": "^1.5.4",

package/src/core/__tests__/api-client.test.ts

@@ -72,7 +72,7 @@ describe("api-client headers", () => {
           "X-AW-Rebate-Principal":
             "did:pkh:eip155:8453:0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
           "X-AW-Surface": "mcp",
-          "X-AW-MCP-Version": "0.1.41",
+          "X-AW-MCP-Version": "0.1.42",
           "X-AW-MCP-Tool": "run_agent",
           "X-AW-MCP-Action": "execute",
         }),

package/src/core/api-client.ts

@@ -29,7 +29,7 @@ interface RequestOptions {
   extraHeaders?: Record<string, string>;
 }
 
-const MCP_VERSION = "0.1.41";
+const MCP_VERSION = "0.1.42";
 
 function inferToolHeaders(path: string, method: string): Record<string, string> {
   if (path === "/solve") {

package/src/core/ows-adapter.ts

@@ -11,6 +11,9 @@
 import type { LocalAccount } from "viem/accounts";
 import type { Hex } from "viem";
 import type { Keypair } from "@solana/web3.js";
+import { createHmac } from "node:crypto";
+import { mnemonicToSeedSync, validateMnemonic } from "@scure/bip39";
+import { wordlist } from "@scure/bip39/wordlists/english";
 
 // Note: OWS provides encrypted key storage at rest (~/.ows/, AES-256-GCM).
 // For EVM signing, we export the secp256k1 key and use viem's native
@@ -155,6 +158,56 @@ function keypairFromEd25519Hex(privateKeyHex: string, KeypairCtor: typeof import
   throw new Error(`Unsupported ed25519 key length: ${bytes.length} bytes.`);
 }
 
+function parseExportedSecret(exported: string): { secp256k1?: string; ed25519?: string; mnemonic?: string } {
+  const secret = exported.trim();
+  try {
+    const parsed = JSON.parse(secret) as { secp256k1?: string; ed25519?: string; mnemonic?: string };
+    if (parsed.secp256k1 || parsed.ed25519 || parsed.mnemonic) return parsed;
+  } catch {
+    // OWS-created wallets export a BIP-39 mnemonic, not a JSON key object.
+  }
+
+  const hex = secret.startsWith("0x") ? secret.slice(2) : secret;
+  if (/^[0-9a-fA-F]+$/.test(hex)) {
+    if (hex.length === 64) return { secp256k1: hex, ed25519: hex };
+    if (hex.length === 128) return { ed25519: hex };
+  }
+
+  if (validateMnemonic(secret, wordlist)) {
+    return { mnemonic: secret };
+  }
+
+  return {};
+}
+
+function deriveSolanaSeedFromMnemonic(mnemonic: string, path = "m/44'/501'/0'/0'"): Uint8Array {
+  const seed = mnemonicToSeedSync(mnemonic);
+  let digest = createHmac("sha512", "ed25519 seed").update(seed).digest();
+  let key = digest.subarray(0, 32);
+  let chainCode = digest.subarray(32);
+
+  for (const part of path.split("/").slice(1)) {
+    if (!part.endsWith("'")) {
+      throw new Error(`Unsupported non-hardened ed25519 path segment: ${part}`);
+    }
+    const index = Number(part.slice(0, -1));
+    if (!Number.isInteger(index) || index < 0) {
+      throw new Error(`Unsupported ed25519 path segment: ${part}`);
+    }
+
+    const data = Buffer.alloc(37);
+    data[0] = 0;
+    Buffer.from(key).copy(data, 1);
+    data.writeUInt32BE(index + 0x80000000, 33);
+
+    digest = createHmac("sha512", chainCode).update(data).digest();
+    key = digest.subarray(0, 32);
+    chainCode = digest.subarray(32);
+  }
+
+  return Uint8Array.from(key);
+}
+
 // ── Public API ───────────────────────────────────────────────────
 
 /**
@@ -278,7 +331,13 @@ export async function owsAccountFromWalletId(
   // (EIP-5806 delegate calls) which OWS's native signing can't serialize.
   // OWS provides encrypted storage at rest; viem handles signing in memory.
   const exported = ows.exportWallet(walletId);
-  const keys = JSON.parse(exported) as { secp256k1?: string; ed25519?: string };
+  const keys = parseExportedSecret(exported);
+
+  if (keys.mnemonic) {
+    const { mnemonicToAccount } = await import("viem/accounts");
+    return mnemonicToAccount(keys.mnemonic);
+  }
+
   if (!keys.secp256k1) {
     throw new Error(`Wallet "${wallet.name}" has no secp256k1 key for EVM signing.`);
   }
@@ -295,12 +354,17 @@ export async function owsSolanaKeypairFromWalletId(
   findSolanaAccount(wallet);
 
   const exported = ows.exportWallet(walletId);
-  const keys = JSON.parse(exported) as { secp256k1?: string; ed25519?: string };
+  const keys = parseExportedSecret(exported);
+  const { Keypair } = await import("@solana/web3.js");
+
+  if (keys.mnemonic) {
+    return Keypair.fromSeed(deriveSolanaSeedFromMnemonic(keys.mnemonic));
+  }
+
   if (!keys.ed25519) {
     throw new Error(`Wallet "${wallet.name}" has no ed25519 key for Solana signing.`);
   }
 
-  const { Keypair } = await import("@solana/web3.js");
   return keypairFromEd25519Hex(keys.ed25519, Keypair);
 }
 

package/src/core/payments.ts

@@ -76,52 +76,44 @@ async function initEvmMppForChain(
   wallet: WalletEntry,
   chain: "tempo" | "base",
 ): Promise<typeof fetch | null> {
-  try {
-    const { Mppx } = await import("./mpp-client.js");
-    let account;
-
-    if (wallet.keyType === "ows" && wallet.owsWalletId) {
-      const { owsAccountFromWalletId } = await import("./ows-adapter.js");
-      account = await owsAccountFromWalletId(wallet.owsWalletId);
-    } else if (wallet.key) {
-      const { privateKeyToAccount } = await import("viem/accounts");
-      account = privateKeyToAccount(normalizeKey(wallet.key));
-    } else {
-      return null;
-    }
-
-    const methods = [];
-    if (chain === "tempo") {
-      const { tempoChargeClient } = await import("./tempo-charge.js");
-      methods.push(tempoChargeClient({ account }));
-    } else {
-      const { baseChargeClient } = await import("./base-charge.js");
-      methods.push(baseChargeClient({ account }));
-    }
+  const { Mppx } = await import("./mpp-client.js");
+  let account;
 
-    const mppx = Mppx.create({ methods: methods as any, polyfill: false });
-    return mppx.fetch.bind(mppx) as typeof fetch;
-  } catch {
+  if (wallet.keyType === "ows" && wallet.owsWalletId) {
+    const { owsAccountFromWalletId } = await import("./ows-adapter.js");
+    account = await owsAccountFromWalletId(wallet.owsWalletId);
+  } else if (wallet.key) {
+    const { privateKeyToAccount } = await import("viem/accounts");
+    account = privateKeyToAccount(normalizeKey(wallet.key));
+  } else {
     return null;
   }
+
+  const methods = [];
+  if (chain === "tempo") {
+    const { tempoChargeClient } = await import("./tempo-charge.js");
+    methods.push(tempoChargeClient({ account }));
+  } else {
+    const { baseChargeClient } = await import("./base-charge.js");
+    methods.push(baseChargeClient({ account }));
+  }
+
+  const mppx = Mppx.create({ methods: methods as any, polyfill: false });
+  return mppx.fetch.bind(mppx) as typeof fetch;
 }
 
 async function initSolanaMpp(wallet: WalletEntry): Promise<typeof fetch | null> {
-  try {
-    if (wallet.keyType !== "ows" && !wallet.key) {
-      return null;
-    }
-
-    const { Mppx } = await import("./mpp-client.js");
-    const { solanaChargeClient } = await import("./solana-charge.js");
-    const mppx = Mppx.create({
-      methods: [solanaChargeClient({ wallet })] as any,
-      polyfill: false,
-    });
-    return mppx.fetch.bind(mppx) as typeof fetch;
-  } catch {
+  if (wallet.keyType !== "ows" && !wallet.key) {
     return null;
   }
+
+  const { Mppx } = await import("./mpp-client.js");
+  const { solanaChargeClient } = await import("./solana-charge.js");
+  const mppx = Mppx.create({
+    methods: [solanaChargeClient({ wallet })] as any,
+    polyfill: false,
+  });
+  return mppx.fetch.bind(mppx) as typeof fetch;
 }
 
 async function initCard(): Promise<typeof fetch | null> {
@@ -178,6 +170,11 @@ async function initForChain(wallet: WalletEntry, chain: string): Promise<typeof
   return null;
 }
 
+function initFailureMessage(method: string, wallet: WalletEntry, chain: string, err: unknown): string {
+  const reason = err instanceof Error ? err.message : String(err);
+  return `Payment method "${method}" is configured as ${chain} on wallet "${wallet.id}", but the signer could not initialize: ${reason}`;
+}
+
 // ── Public API ──────────────────────────────────────────────────
 
 /**
@@ -214,7 +211,12 @@ export async function getPaymentFetch(method?: string): Promise<typeof fetch> {
     }
     const ck = cacheKey(resolved.wallet.id, resolved.chain);
     if (fetchCache.has(ck)) return fetchCache.get(ck)!;
-    const pf = await initForChain(resolved.wallet, resolved.chain);
+    let pf: typeof fetch | null;
+    try {
+      pf = await initForChain(resolved.wallet, resolved.chain);
+    } catch (err) {
+      throw new Error(initFailureMessage(method, resolved.wallet, resolved.chain, err));
+    }
     if (pf) {
       fetchCache.set(ck, pf);
       return pf;
@@ -264,7 +266,17 @@ export async function getPaymentFetch(method?: string): Promise<typeof fetch> {
     }
     const ck = cacheKey(resolved.wallet.id, resolved.chain);
     if (fetchCache.has(ck)) return fetchCache.get(ck)!;
-    const pf = await initForChain(resolved.wallet, resolved.chain);
+    let pf: typeof fetch | null;
+    try {
+      pf = await initForChain(resolved.wallet, resolved.chain);
+    } catch (err) {
+      if (m === defaultMethod) {
+        const others = configured.filter((x) => x !== m);
+        const altText = others.length > 0 ? ` Alternatives: ${others.join(", ")}` : "";
+        throw new Error(`${initFailureMessage(m, resolved.wallet, resolved.chain, err)}.${altText}`);
+      }
+      continue;
+    }
     if (pf) {
       fetchCache.set(ck, pf);
       return pf;

package/src/index.ts

@@ -27,7 +27,7 @@ import { registerJobResources } from "./resources/jobs.js";
 import { registerPrompts } from "./prompts/index.js";
 import { runSetupCli } from "./setup.js";
 
-const PACKAGE_VERSION = "0.1.41";
+const PACKAGE_VERSION = "0.1.42";
 
 export async function startMcpServer(): Promise<void> {
   const server = new McpServer(

package/src/tools/wallet.ts

@@ -280,6 +280,8 @@ export function registerWalletTools(server: McpServer): void {
               "",
               chainStatus,
               "",
+              "No MCP restart is required for wallet changes.",
+              "",
               `Fund this address with USDC on ${defaultCh === "solana" ? "Solana" : "Tempo"} to start using agents.`,
             ].join("\n"));
           }
@@ -313,6 +315,8 @@ export function registerWalletTools(server: McpServer): void {
                 `  Chains: solana`,
                 `  Consumer principal: ${principal}`,
                 "",
+                "No MCP restart is required for wallet changes.",
+                "",
                 "Fund this address with USDC on Solana to start using agents.",
               ].join("\n") + owsNudge,
             );
@@ -340,6 +344,8 @@ export function registerWalletTools(server: McpServer): void {
               `  Chains: tempo, base`,
               `  Consumer principal: ${principal}`,
               "",
+              "No MCP restart is required for wallet changes.",
+              "",
               `Fund this address with USDC on Tempo or Base to start using agents.`,
             ].join("\n") + owsNudge,
           );
@@ -369,6 +375,8 @@ export function registerWalletTools(server: McpServer): void {
             `  Storage: ~/.ows/ (AES-256-GCM encrypted)`,
             `  Consumer principal: ${principal}`,
             "",
+            "No MCP restart is required for wallet changes.",
+            "",
             `Fund this address with USDC on ${defaultCh === "solana" ? "Solana" : "Tempo"} to start using agents.`,
             "For testnet: npx mppx account fund",
           ].join("\n"),
@@ -395,11 +403,13 @@ export function registerWalletTools(server: McpServer): void {
             `Key imported to OWS [encrypted]:`,
             `  ID: ${result.walletId}`,
             `  Address: ${result.address}`,
-            `  Name: ${walletName}`,
-            `  Chains: ${selectedChains.join(", ")}`,
-            `  Consumer principal: ${principal}`,
-          ].join("\n"),
-        );
+          `  Name: ${walletName}`,
+          `  Chains: ${selectedChains.join(", ")}`,
+          `  Consumer principal: ${principal}`,
+          "",
+          "No MCP restart is required for wallet changes.",
+        ].join("\n"),
+      );
       }
 
       if (defaultCh === "solana") {
@@ -429,6 +439,8 @@ export function registerWalletTools(server: McpServer): void {
               `  Name: ${walletName}`,
               `  Chains: solana`,
               `  Consumer principal: ${principal}`,
+              "",
+              "No MCP restart is required for wallet changes.",
             ].join("\n") + owsNudge,
           );
         } catch (err) {
@@ -468,6 +480,8 @@ export function registerWalletTools(server: McpServer): void {
             `  Name: ${walletName}`,
             `  Chains: ${selectedChains.join(", ")}`,
             `  Consumer principal: ${principal}`,
+            "",
+            "No MCP restart is required for wallet changes.",
           ].join("\n") + owsNudge,
         );
       } catch {