@agentwonderland/mcp 0.1.11 → 0.1.13

package/dist/core/file-upload.d.ts

@@ -6,4 +6,17 @@ export declare function isLocalFilePath(value: string): boolean;
  * Scan input object for local file paths, upload them to temporary storage,
  * and replace with download URLs. Non-file values are left unchanged.
  */
-export declare function uploadLocalFiles(input: Record<string, unknown>): Promise<Record<string, unknown>>;
+export interface UploadResult {
+    input: Record<string, unknown>;
+    uploads: Array<{
+        field: string;
+        originalPath: string;
+        url: string;
+    }>;
+}
+/**
+ * Scan input object for local file paths, upload them to temporary storage,
+ * and replace with download URLs. Returns the processed input and a list
+ * of uploads performed.
+ */
+export declare function uploadLocalFiles(input: Record<string, unknown>): Promise<UploadResult>;

package/dist/core/file-upload.js

@@ -78,10 +78,12 @@ async function uploadFile(filePath) {
 }
 /**
  * Scan input object for local file paths, upload them to temporary storage,
- * and replace with download URLs. Non-file values are left unchanged.
+ * and replace with download URLs. Returns the processed input and a list
+ * of uploads performed.
  */
 export async function uploadLocalFiles(input) {
     const result = { ...input };
+    const uploads = [];
     for (const [key, value] of Object.entries(result)) {
         if (typeof value !== "string")
             continue;
@@ -91,12 +93,14 @@ export async function uploadLocalFiles(input) {
         if (!existsSync(resolved))
             continue;
         try {
-            result[key] = await uploadFile(value);
+            const url = await uploadFile(value);
+            result[key] = url;
+            uploads.push({ field: key, originalPath: value, url });
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : "unknown error";
             throw new Error(`Failed to upload file "${value}" for field "${key}": ${msg}`);
         }
     }
-    return result;
+    return { input: result, uploads };
 }

package/dist/index.js

@@ -23,25 +23,28 @@ export async function startMcpServer() {
         version: "0.2.0",
     }, {
         instructions: [
-            "Agent Wonderland is an AI agent marketplace. Use these tools to discover, run, and rate AI agents.",
+            "Agent Wonderland — AI agent marketplace. Discover, run, and rate agents.",
             "",
-            "IMPORTANT — File handling:",
-            "When an agent needs a file (image, PDF, document, etc.), pass the LOCAL FILE PATH directly as the input value.",
-            "Example: run_agent({ agent_id: \"bg-remover\", input: { image: \"/Users/you/photo.jpg\", bgColor: \"transparent\", outputFormat: \"png\" } })",
-            "The MCP automatically uploads local files to temporary cloud storage and replaces them with download URLs before sending to the agent.",
-            "NEVER base64-encode files. NEVER ask the user to upload files manually. Just pass the path.",
+            "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.",
             "",
-            "IMPORTANT — Required fields:",
-            "Always call get_agent() first to check the agent's input schema before running it.",
-            "The 402 payment challenge includes the schema in the X-Agent-Input-Schema header — use it to construct correct input on the first attempt.",
+            "WORKFLOW:",
+            "1. wallet_status() — check payment is configured (Tempo USDC, Base USDC, or Card)",
+            "2. search_agents() or solve() — find agents for the task",
+            "3. get_agent() — check required input fields before running",
+            "4. run_agent() or solve() with ALL required fields",
+            "5. Ask user to rate or tip after a successful run",
             "",
-            "Workflow:",
-            "1. search_agents or solve to find agents",
-            "2. get_agent to check required input fields and pricing",
-            "3. run_agent or solve with ALL required fields filled in",
-            "4. After a successful run, ask the user if they want to rate or tip",
+            "PAYMENT:",
+            "- Automatic via configured wallet. User does nothing.",
+            "- Supports Tempo USDC, Base USDC, and Stripe Card.",
+            "- Input validation runs before payment — invalid input is never charged.",
+            "- Failed agent executions trigger automatic refunds to the consumer's wallet.",
             "",
-            "Payment is automatic via the configured wallet. The user does not need to do anything for payment.",
+            "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.",
         ].join("\n"),
     });
     // Register tools

package/dist/tools/run.js

@@ -56,8 +56,15 @@ export function registerRunTools(server) {
         }
         const method = pay_with;
         let processedInput;
+        let uploadSummary = "";
         try {
-            processedInput = await uploadLocalFiles(input);
+            const uploadResult = await uploadLocalFiles(input);
+            processedInput = uploadResult.input;
+            if (uploadResult.uploads.length > 0) {
+                uploadSummary = uploadResult.uploads
+                    .map((u) => `Uploaded ${u.field}: ${u.originalPath} → ${u.url.slice(0, 80)}...`)
+                    .join("\n");
+            }
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : "File upload failed";
@@ -110,7 +117,7 @@ export function registerRunTools(server) {
             }
         }
         if (status !== "success") {
-            return multiText(formatted, "The agent execution failed. A refund has been initiated automatically.");
+            return multiText(uploadSummary ? `${uploadSummary}\n\n${formatted}` : formatted, "The agent execution failed. A refund has been initiated automatically.");
         }
         const costLine = actualCost != null ? `Paid $${actualCost.toFixed(actualCost < 0.01 ? 4 : 2)}.` : "";
         // Separate the feedback ask into its own content block so the LLM
@@ -127,6 +134,6 @@ export function registerRunTools(server) {
             ] : []),
             `To save for later: favorite_agent({ agent_id: "${resultAgentId}" })`,
         ].join("\n");
-        return multiText(formatted, feedbackAsk);
+        return multiText(uploadSummary ? `${uploadSummary}\n\n${formatted}` : formatted, feedbackAsk);
     });
 }

package/dist/tools/solve.js

@@ -78,7 +78,8 @@ export function registerSolveTools(server) {
         // Path 1: If authenticated, use the platform /solve route
         let processedInput;
         try {
-            processedInput = await uploadLocalFiles(input);
+            const uploadResult = await uploadLocalFiles(input);
+            processedInput = uploadResult.input;
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : "File upload failed";
@@ -149,7 +150,8 @@ export function registerSolveTools(server) {
         let result;
         let processedInput2;
         try {
-            processedInput2 = await uploadLocalFiles(input);
+            const uploadResult2 = await uploadLocalFiles(input);
+            processedInput2 = uploadResult2.input;
         }
         catch (err) {
             const msg = err instanceof Error ? err.message : "File upload failed";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentwonderland/mcp",
-  "version": "0.1.11",
+  "version": "0.1.13",
   "type": "module",
   "description": "MCP server for the Agent Wonderland AI agent marketplace",
   "bin": {

package/src/core/file-upload.ts

@@ -91,10 +91,21 @@ async function uploadFile(filePath: string): Promise<string> {
  * Scan input object for local file paths, upload them to temporary storage,
  * and replace with download URLs. Non-file values are left unchanged.
  */
+export interface UploadResult {
+  input: Record<string, unknown>;
+  uploads: Array<{ field: string; originalPath: string; url: string }>;
+}
+
+/**
+ * Scan input object for local file paths, upload them to temporary storage,
+ * and replace with download URLs. Returns the processed input and a list
+ * of uploads performed.
+ */
 export async function uploadLocalFiles(
   input: Record<string, unknown>,
-): Promise<Record<string, unknown>> {
+): Promise<UploadResult> {
   const result = { ...input };
+  const uploads: UploadResult["uploads"] = [];
 
   for (const [key, value] of Object.entries(result)) {
     if (typeof value !== "string") continue;
@@ -104,12 +115,14 @@ export async function uploadLocalFiles(
     if (!existsSync(resolved)) continue;
 
     try {
-      result[key] = await uploadFile(value);
+      const url = await uploadFile(value);
+      result[key] = url;
+      uploads.push({ field: key, originalPath: value, url });
     } catch (err) {
       const msg = err instanceof Error ? err.message : "unknown error";
       throw new Error(`Failed to upload file "${value}" for field "${key}": ${msg}`);
     }
   }
 
-  return result;
+  return { input: result, uploads };
 }

package/src/index.ts

@@ -30,25 +30,28 @@ export async function startMcpServer(): Promise<void> {
     },
     {
       instructions: [
-        "Agent Wonderland is an AI agent marketplace. Use these tools to discover, run, and rate AI agents.",
+        "Agent Wonderland — AI agent marketplace. Discover, run, and rate agents.",
         "",
-        "IMPORTANT — File handling:",
-        "When an agent needs a file (image, PDF, document, etc.), pass the LOCAL FILE PATH directly as the input value.",
-        "Example: run_agent({ agent_id: \"bg-remover\", input: { image: \"/Users/you/photo.jpg\", bgColor: \"transparent\", outputFormat: \"png\" } })",
-        "The MCP automatically uploads local files to temporary cloud storage and replaces them with download URLs before sending to the agent.",
-        "NEVER base64-encode files. NEVER ask the user to upload files manually. Just pass the path.",
+        "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.",
         "",
-        "IMPORTANT — Required fields:",
-        "Always call get_agent() first to check the agent's input schema before running it.",
-        "The 402 payment challenge includes the schema in the X-Agent-Input-Schema header — use it to construct correct input on the first attempt.",
+        "WORKFLOW:",
+        "1. wallet_status() — check payment is configured (Tempo USDC, Base USDC, or Card)",
+        "2. search_agents() or solve() — find agents for the task",
+        "3. get_agent() — check required input fields before running",
+        "4. run_agent() or solve() with ALL required fields",
+        "5. Ask user to rate or tip after a successful run",
         "",
-        "Workflow:",
-        "1. search_agents or solve to find agents",
-        "2. get_agent to check required input fields and pricing",
-        "3. run_agent or solve with ALL required fields filled in",
-        "4. After a successful run, ask the user if they want to rate or tip",
+        "PAYMENT:",
+        "- Automatic via configured wallet. User does nothing.",
+        "- Supports Tempo USDC, Base USDC, and Stripe Card.",
+        "- Input validation runs before payment — invalid input is never charged.",
+        "- Failed agent executions trigger automatic refunds to the consumer's wallet.",
         "",
-        "Payment is automatic via the configured wallet. The user does not need to do anything for payment.",
+        "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.",
       ].join("\n"),
     },
   );

package/src/tools/run.ts

@@ -75,8 +75,15 @@ export function registerRunTools(server: McpServer): void {
 
       const method = pay_with;
       let processedInput: Record<string, unknown>;
+      let uploadSummary = "";
       try {
-        processedInput = await uploadLocalFiles(input);
+        const uploadResult = await uploadLocalFiles(input);
+        processedInput = uploadResult.input;
+        if (uploadResult.uploads.length > 0) {
+          uploadSummary = uploadResult.uploads
+            .map((u) => `Uploaded ${u.field}: ${u.originalPath} → ${u.url.slice(0, 80)}...`)
+            .join("\n");
+        }
       } catch (err) {
         const msg = err instanceof Error ? err.message : "File upload failed";
         return text(`Error: ${msg}`);
@@ -139,7 +146,7 @@ export function registerRunTools(server: McpServer): void {
 
       if (status !== "success") {
         return multiText(
-          formatted,
+          uploadSummary ? `${uploadSummary}\n\n${formatted}` : formatted,
           "The agent execution failed. A refund has been initiated automatically.",
         );
       }
@@ -161,7 +168,7 @@ export function registerRunTools(server: McpServer): void {
         `To save for later: favorite_agent({ agent_id: "${resultAgentId}" })`,
       ].join("\n");
 
-      return multiText(formatted, feedbackAsk);
+      return multiText(uploadSummary ? `${uploadSummary}\n\n${formatted}` : formatted, feedbackAsk);
     },
   );
 }

package/src/tools/solve.ts

@@ -97,7 +97,8 @@ export function registerSolveTools(server: McpServer): void {
       // Path 1: If authenticated, use the platform /solve route
       let processedInput: Record<string, unknown>;
       try {
-        processedInput = await uploadLocalFiles(input);
+        const uploadResult = await uploadLocalFiles(input);
+        processedInput = uploadResult.input;
       } catch (err) {
         const msg = err instanceof Error ? err.message : "File upload failed";
         return text(`Error: ${msg}`);
@@ -177,7 +178,8 @@ export function registerSolveTools(server: McpServer): void {
       let result: Record<string, unknown>;
       let processedInput2: Record<string, unknown>;
       try {
-        processedInput2 = await uploadLocalFiles(input);
+        const uploadResult2 = await uploadLocalFiles(input);
+        processedInput2 = uploadResult2.input;
       } catch (err) {
         const msg = err instanceof Error ? err.message : "File upload failed";
         return text(`Error: ${msg}`);