@agentwonderland/mcp 0.1.27 → 0.1.29

package/dist/core/config.d.ts

@@ -1,6 +1,6 @@
 export interface WalletEntry {
     id: string;
-    keyType: "evm" | "ows";
+    keyType: "evm" | "solana" | "ows";
     key?: string;
     owsWalletId?: string;
     chains: string[];

package/dist/core/payments.js

@@ -368,7 +368,19 @@ export async function getWalletAddress(method) {
         }
     }
     if (chain === "solana") {
-        return null;
+        // Raw Solana ed25519 key path (plaintext fallback when OWS is unavailable)
+        if (!wallet.key)
+            return null;
+        try {
+            const { Keypair } = await import("@solana/web3.js");
+            const hex = wallet.key.startsWith("0x") ? wallet.key.slice(2) : wallet.key;
+            const bytes = Uint8Array.from(Buffer.from(hex, "hex"));
+            const kp = bytes.length === 32 ? Keypair.fromSeed(bytes) : Keypair.fromSecretKey(bytes);
+            return kp.publicKey.toBase58();
+        }
+        catch {
+            return null;
+        }
     }
     // Raw EVM key path
     if (!wallet.key)

package/dist/index.js

@@ -24,40 +24,42 @@ export async function startMcpServer() {
         version: "0.2.0",
     }, {
         instructions: [
-            "Agent Wonderland — AI agent marketplace. Discover, run, and rate agents.",
+            "Agent Wonderland — on-demand AI agent marketplace with autonomous per-call payment. Discover, run, rate.",
             "",
-            "FILE HANDLING:",
-            "Pass local file paths directly as input values (e.g. image: \"/path/to/photo.jpg\").",
-            "The MCP auto-uploads to cloud storage and replaces with a URL. Never base64-encode.",
+            "PURPOSE:",
+            "You are an AI agent calling this MCP to extend your capabilities. Instead of integrating N APIs with N keys,",
+            "you pay specialist agents per call in USDC. This works headlessly in automations (n8n, cron) and interactively",
+            "(Claude Code, Desktop). Favor one-shot `solve()` for autonomous use; prefer `search_agents()` + `run_agent()`",
+            "when the caller wants to pick a specific agent.",
             "",
             "WORKFLOW:",
-            "1. search_agents() or solve() — find agents for the task",
-            "2. get_agent() — check required input fields before running",
-            "3. run_agent() or solve() with ALL required fields",
-            "3a. If the agent offers discounted credit packs, use buy_agent_credit_pack() and list_agent_credit_packs() when helpful",
-            "4. If no payment method is set up, run_agent returns a setup page to connect a credit card — present it to the user",
-            "5. Ask user to rate or tip after a successful run",
+            "1. solve(intent, input, budget) — one call: find best agent + pay + run. Use when the task is clear.",
+            "   OR: search_agents() → get_agent() to inspect schema → run_agent() with required fields.",
+            "2. If the agent returns status 'processing', poll with get_job(). Async runs resolve automatically.",
+            "3. After a successful run, rate_agent() and optionally tip_agent() if the result was useful.",
+            "4. Use list_jobs() to recover state across sessions (it checks every configured wallet).",
             "",
-            "PAYMENT:",
-            "- Crypto wallets (Tempo USDC, Base USDC, Solana USDC) are the core supported rails.",
-            "- Saved cards can also be used, but card-backed MPP depends on Stripe Shared Payment Token availability in the current environment.",
-            "- Card and crypto are SEPARATE payment methods. Card charges a credit card; crypto sends USDC on-chain.",
-            "- When a card is configured, it becomes the default payment method. Use wallet_status to confirm whether `Card MPP: ready` before relying on it.",
-            "- run_agent() and solve() auto-detect the default compatible payment method when pay_with is omitted.",
-            "- Include pay_with explicitly when you need a specific rail or want deterministic control over the payment method used.",
-            "- Use wallet_status to see the exact payment methods the user has configured before calling a paid tool.",
-            "- Payment is automatic once configured. Users are never charged for failed runs.",
-            "- Do NOT ask the user to set up payment before they try to run an agent. Let them explore freely.",
-            "- If a specific payment method fails, report the error clearly. Do NOT silently fall back to a different method.",
-            "- When payment fails, suggest alternatives using wallet_status.",
+            "PAYMENT (crypto-only right now):",
+            "- Supported rails: Tempo USDC, Base USDC, Solana USDC. Card is temporarily disabled pending Stripe SPT approval.",
+            "- Tempo and Base share one EVM wallet key. Solana uses a separate ed25519 key. One OWS wallet can manage both.",
+            "- If pay_with is omitted, the MCP auto-selects a compatible configured rail. Pass pay_with explicitly",
+            "  (tempo | base | solana | wallet-id) for deterministic behavior.",
+            "- Payment is automatic: on a 402 challenge the MCP signs on-chain, submits, then retries. Failed runs are refunded.",
+            "- If a specific rail fails, surface the real reason — do NOT silently retry with a different method.",
+            "- Headless/automation: set wallet_set_policy() to cap max_per_tx and max_per_day so a runaway loop can't drain funds.",
             "",
-            "MANAGING PAYMENT METHODS:",
-            "- To remove a card: wallet_setup({ action: \"remove-card\" })",
-            "- To remove or modify a crypto wallet: NEVER do this programmatically. Direct users to edit their config files manually (~/.agentwonderland/config.json or ~/.ows/). We do not handle private key deletion or modification to avoid any risk of key loss.",
+            "FILE HANDLING:",
+            "Pass local file paths directly as input values (e.g. image: \"/path/to/photo.jpg\"). The MCP auto-uploads to",
+            "cloud storage and replaces with a URL before sending to the agent. Never base64-encode.",
             "",
             "REQUIRED FIELDS:",
-            "Always check the agent's input schema (via get_agent) before calling run_agent.",
-            "Include ALL required fields in the first attempt to avoid validation errors.",
+            "Always inspect the agent's input schema via get_agent() before calling run_agent(). Include ALL required",
+            "fields in the first attempt — validation errors cost a round trip.",
+            "",
+            "WALLET HYGIENE:",
+            "- wallet_status shows per-chain USDC balance and the active network (mainnet vs testnet).",
+            "- To create or import a crypto wallet: wallet_setup({ action: \"create\" }) or { action: \"import\", key }.",
+            "- NEVER delete or rotate keys programmatically. Direct users to edit ~/.agentwonderland/config.json or ~/.ows/ manually.",
         ].join("\n"),
     });
     // Register tools

package/dist/tools/passes.js

@@ -52,8 +52,9 @@ export function registerPassTools(server) {
                 "No payment method configured.",
                 "",
                 "Supported rails: Tempo USDC, Base USDC, Solana USDC.",
-                "Run wallet_setup({ action: \"create\" }) to create a crypto wallet,",
-                "or wallet_setup({ action: \"import\" }) with an existing key.",
+                "Run wallet_setup({ action: \"create\" }) to create a wallet (falls back to plaintext storage",
+                "if OWS is not installed — install @open-wallet-standard/core globally for encrypted keys).",
+                "Or wallet_setup({ action: \"import\", key: \"<hex>\" }) with an existing key.",
             ];
             if (isCardPaymentEnabled()) {
                 setupLines.push("", "Or wallet_setup({ action: \"add-card\" }) to connect a credit card.");

package/dist/tools/run.js

@@ -78,8 +78,9 @@ export function registerRunTools(server) {
                 "No payment method configured.",
                 "",
                 "Supported rails: Tempo USDC, Base USDC, Solana USDC.",
-                "Run wallet_setup({ action: \"create\" }) to create a crypto wallet,",
-                "or wallet_setup({ action: \"import\" }) with an existing key.",
+                "Run wallet_setup({ action: \"create\" }) to create a wallet (falls back to plaintext storage",
+                "if OWS is not installed — install @open-wallet-standard/core globally for encrypted keys).",
+                "Or wallet_setup({ action: \"import\", key: \"<hex>\" }) with an existing key.",
             ];
             if (isCardPaymentEnabled()) {
                 setupLines.push("", "Or wallet_setup({ action: \"add-card\" }) to connect a credit card.");

package/dist/tools/solve.js

@@ -127,8 +127,9 @@ export function registerSolveTools(server) {
                 "No payment method configured.",
                 "",
                 "Supported rails: Tempo USDC, Base USDC, Solana USDC.",
-                "Run wallet_setup({ action: \"create\" }) to create a crypto wallet,",
-                "or wallet_setup({ action: \"import\" }) with an existing key.",
+                "Run wallet_setup({ action: \"create\" }) to create a wallet (falls back to plaintext storage",
+                "if OWS is not installed — install @open-wallet-standard/core globally for encrypted keys).",
+                "Or wallet_setup({ action: \"import\", key: \"<hex>\" }) with an existing key.",
             ];
             if (isCardPaymentEnabled()) {
                 setupLines.push("", "Or wallet_setup({ action: \"add-card\" }) to connect a credit card.");

package/dist/tools/wallet.js

@@ -190,11 +190,55 @@ export function registerWalletTools(server) {
                 }
             }
             if (!owsReady) {
-                return text("Cannot create wallet: OWS (Open Wallet Standard) is not installed.\n" +
-                    "Install with: npm install -g @open-wallet-standard/core\n\n" +
-                    (defaultCh === "solana"
-                        ? "Solana wallets currently require OWS-managed encrypted storage."
-                        : "Alternatively, use action 'import' with an existing private key."));
+                // Fallback: generate a plaintext wallet stored in ~/.agentwonderland/config.json.
+                // Safe for prototyping; install OWS for encrypted at-rest storage.
+                const walletName = name ?? `aw-${Date.now()}`;
+                if (preferredOwsChain === "solana") {
+                    const { Keypair } = await import("@solana/web3.js");
+                    const kp = Keypair.generate();
+                    const secretHex = Buffer.from(kp.secretKey).toString("hex");
+                    addWallet({
+                        id: walletName,
+                        keyType: "solana",
+                        key: secretHex,
+                        chains: ["solana"],
+                        defaultChain: "solana",
+                        label: walletName,
+                    });
+                    const principal = await ensureConsumerPrincipal();
+                    return text([
+                        "Wallet created [plaintext — install OWS for encrypted storage]:",
+                        `  Address: ${kp.publicKey.toBase58()}`,
+                        `  Name: ${walletName}`,
+                        `  Chains: solana`,
+                        `  Consumer principal: ${principal}`,
+                        "",
+                        "Fund this address with USDC on Solana to start using agents.",
+                        "For encrypted storage, install OWS: npm install -g @open-wallet-standard/core",
+                    ].join("\n"));
+                }
+                const { generatePrivateKey, privateKeyToAccount } = await import("viem/accounts");
+                const privateKey = generatePrivateKey();
+                const account = privateKeyToAccount(privateKey);
+                addWallet({
+                    id: walletName,
+                    keyType: "evm",
+                    key: privateKey,
+                    chains: ["tempo", "base"],
+                    defaultChain: defaultCh === "solana" ? "tempo" : defaultCh,
+                    label: walletName,
+                });
+                const principal = await ensureConsumerPrincipal();
+                return text([
+                    "Wallet created [plaintext — install OWS for encrypted storage]:",
+                    `  Address: ${account.address}`,
+                    `  Name: ${walletName}`,
+                    `  Chains: tempo, base`,
+                    `  Consumer principal: ${principal}`,
+                    "",
+                    `Fund this address with USDC on Tempo or Base to start using agents.`,
+                    "For encrypted storage, install OWS: npm install -g @open-wallet-standard/core",
+                ].join("\n"));
             }
             const walletName = name ?? `aw-${Date.now()}`;
             const result = await createOwsWallet(walletName, preferredOwsChain);
@@ -244,8 +288,36 @@ export function registerWalletTools(server) {
             ].join("\n"));
         }
         if (defaultCh === "solana") {
-            return text("Solana key import currently requires OWS (Open Wallet Standard) so the ed25519 key can be stored safely.\n" +
-                "Install with: npm install -g @open-wallet-standard/core");
+            // Plaintext Solana import fallback.
+            try {
+                const { Keypair } = await import("@solana/web3.js");
+                const raw = key.startsWith("0x") ? key.slice(2) : key;
+                const bytes = Uint8Array.from(Buffer.from(raw, "hex"));
+                const kp = bytes.length === 32 ? Keypair.fromSeed(bytes) : Keypair.fromSecretKey(bytes);
+                const walletName = name ?? `imported-${Date.now()}`;
+                addWallet({
+                    id: walletName,
+                    keyType: "solana",
+                    key: raw,
+                    chains: ["solana"],
+                    defaultChain: "solana",
+                    label: walletName,
+                });
+                const principal = await ensureConsumerPrincipal();
+                return text([
+                    "Key imported [plaintext — install OWS for encrypted storage]:",
+                    `  Address: ${kp.publicKey.toBase58()}`,
+                    `  Name: ${walletName}`,
+                    `  Chains: solana`,
+                    `  Consumer principal: ${principal}`,
+                    "",
+                    "For encrypted storage, install OWS: npm install -g @open-wallet-standard/core",
+                ].join("\n"));
+            }
+            catch (err) {
+                return text(`Invalid Solana key: ${err instanceof Error ? err.message : String(err)}\n` +
+                    "Expected a 32-byte seed or 64-byte secret key, hex-encoded.");
+            }
         }
         // No OWS — store plaintext
         try {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentwonderland/mcp",
-  "version": "0.1.27",
+  "version": "0.1.29",
   "type": "module",
   "description": "MCP server for the Agent Wonderland AI agent marketplace",
   "bin": {
@@ -30,14 +30,9 @@
     "viem": "^2.47.6",
     "zod": "^3.24.0"
   },
-  "peerDependencies": {
+  "optionalDependencies": {
     "@open-wallet-standard/core": "^1.0.0"
   },
-  "peerDependenciesMeta": {
-    "@open-wallet-standard/core": {
-      "optional": true
-    }
-  },
   "devDependencies": {
     "@types/qrcode": "^1.5.6",
     "tsx": "^4.0.0",

package/src/core/config.ts

@@ -6,8 +6,8 @@ import { homedir } from "node:os";
 
 export interface WalletEntry {
   id: string;          // e.g. "evm-1"
-  keyType: "evm" | "ows"; // key format: raw EVM key or OWS-managed wallet
-  key?: string;        // private key (legacy / raw EVM only)
+  keyType: "evm" | "solana" | "ows"; // key format: raw EVM / raw Solana / OWS-managed
+  key?: string;        // private key hex (secp256k1 for evm, ed25519 for solana)
   owsWalletId?: string; // OWS wallet reference (when keyType === "ows")
   chains: string[];    // enabled chains: "tempo", "base", "solana"
   defaultChain?: string; // which chain to use by default for this wallet

package/src/core/payments.ts

@@ -417,7 +417,17 @@ export async function getWalletAddress(method?: string): Promise<string | null>
   }
 
   if (chain === "solana") {
-    return null;
+    // Raw Solana ed25519 key path (plaintext fallback when OWS is unavailable)
+    if (!wallet.key) return null;
+    try {
+      const { Keypair } = await import("@solana/web3.js");
+      const hex = wallet.key.startsWith("0x") ? wallet.key.slice(2) : wallet.key;
+      const bytes = Uint8Array.from(Buffer.from(hex, "hex"));
+      const kp = bytes.length === 32 ? Keypair.fromSeed(bytes) : Keypair.fromSecretKey(bytes);
+      return kp.publicKey.toBase58();
+    } catch {
+      return null;
+    }
   }
 
   // Raw EVM key path

package/src/index.ts

@@ -31,40 +31,42 @@ export async function startMcpServer(): Promise<void> {
     },
     {
       instructions: [
-        "Agent Wonderland — AI agent marketplace. Discover, run, and rate agents.",
+        "Agent Wonderland — on-demand AI agent marketplace with autonomous per-call payment. Discover, run, rate.",
         "",
-        "FILE HANDLING:",
-        "Pass local file paths directly as input values (e.g. image: \"/path/to/photo.jpg\").",
-        "The MCP auto-uploads to cloud storage and replaces with a URL. Never base64-encode.",
+        "PURPOSE:",
+        "You are an AI agent calling this MCP to extend your capabilities. Instead of integrating N APIs with N keys,",
+        "you pay specialist agents per call in USDC. This works headlessly in automations (n8n, cron) and interactively",
+        "(Claude Code, Desktop). Favor one-shot `solve()` for autonomous use; prefer `search_agents()` + `run_agent()`",
+        "when the caller wants to pick a specific agent.",
         "",
         "WORKFLOW:",
-        "1. search_agents() or solve() — find agents for the task",
-        "2. get_agent() — check required input fields before running",
-        "3. run_agent() or solve() with ALL required fields",
-        "3a. If the agent offers discounted credit packs, use buy_agent_credit_pack() and list_agent_credit_packs() when helpful",
-        "4. If no payment method is set up, run_agent returns a setup page to connect a credit card — present it to the user",
-        "5. Ask user to rate or tip after a successful run",
+        "1. solve(intent, input, budget) — one call: find best agent + pay + run. Use when the task is clear.",
+        "   OR: search_agents() → get_agent() to inspect schema → run_agent() with required fields.",
+        "2. If the agent returns status 'processing', poll with get_job(). Async runs resolve automatically.",
+        "3. After a successful run, rate_agent() and optionally tip_agent() if the result was useful.",
+        "4. Use list_jobs() to recover state across sessions (it checks every configured wallet).",
         "",
-        "PAYMENT:",
-        "- Crypto wallets (Tempo USDC, Base USDC, Solana USDC) are the core supported rails.",
-        "- Saved cards can also be used, but card-backed MPP depends on Stripe Shared Payment Token availability in the current environment.",
-        "- Card and crypto are SEPARATE payment methods. Card charges a credit card; crypto sends USDC on-chain.",
-        "- When a card is configured, it becomes the default payment method. Use wallet_status to confirm whether `Card MPP: ready` before relying on it.",
-        "- run_agent() and solve() auto-detect the default compatible payment method when pay_with is omitted.",
-        "- Include pay_with explicitly when you need a specific rail or want deterministic control over the payment method used.",
-        "- Use wallet_status to see the exact payment methods the user has configured before calling a paid tool.",
-        "- Payment is automatic once configured. Users are never charged for failed runs.",
-        "- Do NOT ask the user to set up payment before they try to run an agent. Let them explore freely.",
-        "- If a specific payment method fails, report the error clearly. Do NOT silently fall back to a different method.",
-        "- When payment fails, suggest alternatives using wallet_status.",
+        "PAYMENT (crypto-only right now):",
+        "- Supported rails: Tempo USDC, Base USDC, Solana USDC. Card is temporarily disabled pending Stripe SPT approval.",
+        "- Tempo and Base share one EVM wallet key. Solana uses a separate ed25519 key. One OWS wallet can manage both.",
+        "- If pay_with is omitted, the MCP auto-selects a compatible configured rail. Pass pay_with explicitly",
+        "  (tempo | base | solana | wallet-id) for deterministic behavior.",
+        "- Payment is automatic: on a 402 challenge the MCP signs on-chain, submits, then retries. Failed runs are refunded.",
+        "- If a specific rail fails, surface the real reason — do NOT silently retry with a different method.",
+        "- Headless/automation: set wallet_set_policy() to cap max_per_tx and max_per_day so a runaway loop can't drain funds.",
         "",
-        "MANAGING PAYMENT METHODS:",
-        "- To remove a card: wallet_setup({ action: \"remove-card\" })",
-        "- To remove or modify a crypto wallet: NEVER do this programmatically. Direct users to edit their config files manually (~/.agentwonderland/config.json or ~/.ows/). We do not handle private key deletion or modification to avoid any risk of key loss.",
+        "FILE HANDLING:",
+        "Pass local file paths directly as input values (e.g. image: \"/path/to/photo.jpg\"). The MCP auto-uploads to",
+        "cloud storage and replaces with a URL before sending to the agent. Never base64-encode.",
         "",
         "REQUIRED FIELDS:",
-        "Always check the agent's input schema (via get_agent) before calling run_agent.",
-        "Include ALL required fields in the first attempt to avoid validation errors.",
+        "Always inspect the agent's input schema via get_agent() before calling run_agent(). Include ALL required",
+        "fields in the first attempt — validation errors cost a round trip.",
+        "",
+        "WALLET HYGIENE:",
+        "- wallet_status shows per-chain USDC balance and the active network (mainnet vs testnet).",
+        "- To create or import a crypto wallet: wallet_setup({ action: \"create\" }) or { action: \"import\", key }.",
+        "- NEVER delete or rotate keys programmatically. Direct users to edit ~/.agentwonderland/config.json or ~/.ows/ manually.",
       ].join("\n"),
     },
   );

package/src/tools/passes.ts

@@ -84,8 +84,9 @@ export function registerPassTools(server: McpServer): void {
           "No payment method configured.",
           "",
           "Supported rails: Tempo USDC, Base USDC, Solana USDC.",
-          "Run wallet_setup({ action: \"create\" }) to create a crypto wallet,",
-          "or wallet_setup({ action: \"import\" }) with an existing key.",
+          "Run wallet_setup({ action: \"create\" }) to create a wallet (falls back to plaintext storage",
+          "if OWS is not installed — install @open-wallet-standard/core globally for encrypted keys).",
+          "Or wallet_setup({ action: \"import\", key: \"<hex>\" }) with an existing key.",
         ];
         if (isCardPaymentEnabled()) {
           setupLines.push("", "Or wallet_setup({ action: \"add-card\" }) to connect a credit card.");

package/src/tools/run.ts

@@ -119,8 +119,9 @@ export function registerRunTools(server: McpServer): void {
           "No payment method configured.",
           "",
           "Supported rails: Tempo USDC, Base USDC, Solana USDC.",
-          "Run wallet_setup({ action: \"create\" }) to create a crypto wallet,",
-          "or wallet_setup({ action: \"import\" }) with an existing key.",
+          "Run wallet_setup({ action: \"create\" }) to create a wallet (falls back to plaintext storage",
+          "if OWS is not installed — install @open-wallet-standard/core globally for encrypted keys).",
+          "Or wallet_setup({ action: \"import\", key: \"<hex>\" }) with an existing key.",
         ];
         if (isCardPaymentEnabled()) {
           setupLines.push("", "Or wallet_setup({ action: \"add-card\" }) to connect a credit card.");

package/src/tools/solve.ts

@@ -162,8 +162,9 @@ export function registerSolveTools(server: McpServer): void {
           "No payment method configured.",
           "",
           "Supported rails: Tempo USDC, Base USDC, Solana USDC.",
-          "Run wallet_setup({ action: \"create\" }) to create a crypto wallet,",
-          "or wallet_setup({ action: \"import\" }) with an existing key.",
+          "Run wallet_setup({ action: \"create\" }) to create a wallet (falls back to plaintext storage",
+          "if OWS is not installed — install @open-wallet-standard/core globally for encrypted keys).",
+          "Or wallet_setup({ action: \"import\", key: \"<hex>\" }) with an existing key.",
         ];
         if (isCardPaymentEnabled()) {
           setupLines.push("", "Or wallet_setup({ action: \"add-card\" }) to connect a credit card.");

package/src/tools/wallet.ts

@@ -245,12 +245,58 @@ export function registerWalletTools(server: McpServer): void {
         }
 
         if (!owsReady) {
+          // Fallback: generate a plaintext wallet stored in ~/.agentwonderland/config.json.
+          // Safe for prototyping; install OWS for encrypted at-rest storage.
+          const walletName = name ?? `aw-${Date.now()}`;
+          if (preferredOwsChain === "solana") {
+            const { Keypair } = await import("@solana/web3.js");
+            const kp = Keypair.generate();
+            const secretHex = Buffer.from(kp.secretKey).toString("hex");
+            addWallet({
+              id: walletName,
+              keyType: "solana",
+              key: secretHex,
+              chains: ["solana"],
+              defaultChain: "solana",
+              label: walletName,
+            });
+            const principal = await ensureConsumerPrincipal();
+            return text(
+              [
+                "Wallet created [plaintext — install OWS for encrypted storage]:",
+                `  Address: ${kp.publicKey.toBase58()}`,
+                `  Name: ${walletName}`,
+                `  Chains: solana`,
+                `  Consumer principal: ${principal}`,
+                "",
+                "Fund this address with USDC on Solana to start using agents.",
+                "For encrypted storage, install OWS: npm install -g @open-wallet-standard/core",
+              ].join("\n"),
+            );
+          }
+          const { generatePrivateKey, privateKeyToAccount } = await import("viem/accounts");
+          const privateKey = generatePrivateKey();
+          const account = privateKeyToAccount(privateKey);
+          addWallet({
+            id: walletName,
+            keyType: "evm",
+            key: privateKey,
+            chains: ["tempo", "base"],
+            defaultChain: defaultCh === "solana" ? "tempo" : defaultCh,
+            label: walletName,
+          });
+          const principal = await ensureConsumerPrincipal();
           return text(
-            "Cannot create wallet: OWS (Open Wallet Standard) is not installed.\n" +
-              "Install with: npm install -g @open-wallet-standard/core\n\n" +
-              (defaultCh === "solana"
-                ? "Solana wallets currently require OWS-managed encrypted storage."
-                : "Alternatively, use action 'import' with an existing private key."),
+            [
+              "Wallet created [plaintext — install OWS for encrypted storage]:",
+              `  Address: ${account.address}`,
+              `  Name: ${walletName}`,
+              `  Chains: tempo, base`,
+              `  Consumer principal: ${principal}`,
+              "",
+              `Fund this address with USDC on Tempo or Base to start using agents.`,
+              "For encrypted storage, install OWS: npm install -g @open-wallet-standard/core",
+            ].join("\n"),
           );
         }
 
@@ -312,10 +358,39 @@ export function registerWalletTools(server: McpServer): void {
       }
 
       if (defaultCh === "solana") {
-        return text(
-          "Solana key import currently requires OWS (Open Wallet Standard) so the ed25519 key can be stored safely.\n" +
-          "Install with: npm install -g @open-wallet-standard/core",
-        );
+        // Plaintext Solana import fallback.
+        try {
+          const { Keypair } = await import("@solana/web3.js");
+          const raw = key!.startsWith("0x") ? key!.slice(2) : key!;
+          const bytes = Uint8Array.from(Buffer.from(raw, "hex"));
+          const kp = bytes.length === 32 ? Keypair.fromSeed(bytes) : Keypair.fromSecretKey(bytes);
+          const walletName = name ?? `imported-${Date.now()}`;
+          addWallet({
+            id: walletName,
+            keyType: "solana",
+            key: raw,
+            chains: ["solana"],
+            defaultChain: "solana",
+            label: walletName,
+          });
+          const principal = await ensureConsumerPrincipal();
+          return text(
+            [
+              "Key imported [plaintext — install OWS for encrypted storage]:",
+              `  Address: ${kp.publicKey.toBase58()}`,
+              `  Name: ${walletName}`,
+              `  Chains: solana`,
+              `  Consumer principal: ${principal}`,
+              "",
+              "For encrypted storage, install OWS: npm install -g @open-wallet-standard/core",
+            ].join("\n"),
+          );
+        } catch (err) {
+          return text(
+            `Invalid Solana key: ${err instanceof Error ? err.message : String(err)}\n` +
+            "Expected a 32-byte seed or 64-byte secret key, hex-encoded.",
+          );
+        }
       }
 
       // No OWS — store plaintext