@agentwonderland/mcp 0.1.9 → 0.1.11

package/dist/core/base-charge.d.ts

@@ -0,0 +1,10 @@
+import type { LocalAccount } from "viem/accounts";
+interface BaseChargeClientConfig {
+    account: LocalAccount;
+    rpcUrl?: string;
+}
+/**
+ * Creates a Base charge client method for sending ERC-20 USDC transfers.
+ */
+export declare function baseChargeClient(config: BaseChargeClientConfig): any;
+export {};

package/dist/core/base-charge.js

@@ -0,0 +1,85 @@
+/**
+ * Custom MPP payment method: Base EVM USDC charge (client-side).
+ *
+ * Signs and sends a standard ERC-20 transfer on Base chain, then returns
+ * the tx hash as a credential. Plugs into mppx's compose/dispatch system.
+ */
+import { Method, Credential, z } from "mppx";
+// Base USDC (Circle native)
+const BASE_USDC = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913";
+const BASE_CHAIN_ID = 8453;
+// Standard ERC-20 transfer function ABI
+const ERC20_ABI = [
+    {
+        type: "function",
+        name: "transfer",
+        inputs: [
+            { name: "to", type: "address" },
+            { name: "value", type: "uint256" },
+        ],
+        outputs: [{ name: "", type: "bool" }],
+        stateMutability: "nonpayable",
+    },
+];
+/**
+ * Method schema for base/charge — must match the server-side definition.
+ */
+const baseChargeMethod = Method.from({
+    name: "base",
+    intent: "charge",
+    schema: {
+        credential: {
+            payload: z.object({
+                hash: z.string(),
+                type: z.literal("hash"),
+            }),
+        },
+        request: z.pipe(z.object({
+            amount: z.string(),
+            currency: z.string(),
+            recipient: z.string(),
+            chainId: z.optional(z.number()),
+            decimals: z.optional(z.number()),
+        }), z.transform((v) => ({ ...v, methodDetails: { chainId: v.chainId ?? BASE_CHAIN_ID } }))),
+    },
+});
+/**
+ * Creates a Base charge client method for sending ERC-20 USDC transfers.
+ */
+export function baseChargeClient(config) {
+    return Method.toClient(baseChargeMethod, {
+        async createCredential({ challenge }) {
+            const { request } = challenge;
+            const amount = BigInt(request.amount);
+            const recipient = request.recipient;
+            const currency = (request.currency ?? BASE_USDC);
+            // Dynamic imports to keep the module lightweight
+            const { createWalletClient, createPublicClient, http, encodeFunctionData } = await import("viem");
+            const { base } = await import("viem/chains");
+            const rpcUrl = config.rpcUrl ?? "https://mainnet.base.org";
+            const walletClient = createWalletClient({
+                account: config.account,
+                chain: base,
+                transport: http(rpcUrl),
+            });
+            const publicClient = createPublicClient({
+                chain: base,
+                transport: http(rpcUrl),
+            });
+            // Send ERC-20 transfer
+            const hash = await walletClient.writeContract({
+                address: currency,
+                abi: ERC20_ABI,
+                functionName: "transfer",
+                args: [recipient, amount],
+            });
+            // Wait for confirmation
+            await publicClient.waitForTransactionReceipt({ hash });
+            return Credential.serialize({
+                challenge,
+                payload: { hash, type: "hash" },
+                source: `did:pkh:eip155:${BASE_CHAIN_ID}:${config.account.address}`,
+            });
+        },
+    });
+}

package/dist/core/payments.js

@@ -35,7 +35,8 @@ async function initMpp(wallet) {
         else {
             return null;
         }
-        const mppx = Mppx.create({ methods: [tempo({ account })] });
+        const { baseChargeClient } = await import("./base-charge.js");
+        const mppx = Mppx.create({ methods: [tempo({ account }), baseChargeClient({ account })] });
         return mppx.fetch.bind(mppx);
     }
     catch {

package/dist/index.js

@@ -21,6 +21,28 @@ export async function startMcpServer() {
     const server = new McpServer({
         name: "agentwonderland",
         version: "0.2.0",
+    }, {
+        instructions: [
+            "Agent Wonderland is an AI agent marketplace. Use these tools to discover, run, and rate AI 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.",
+            "",
+            "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. 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 is automatic via the configured wallet. The user does not need to do anything for payment.",
+        ].join("\n"),
     });
     // Register tools
     registerSearchTools(server);

package/package.json

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

package/src/core/base-charge.ts

@@ -0,0 +1,105 @@
+/**
+ * Custom MPP payment method: Base EVM USDC charge (client-side).
+ *
+ * Signs and sends a standard ERC-20 transfer on Base chain, then returns
+ * the tx hash as a credential. Plugs into mppx's compose/dispatch system.
+ */
+import { Method, Credential, z } from "mppx";
+import type { LocalAccount } from "viem/accounts";
+
+// Base USDC (Circle native)
+const BASE_USDC = "0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913" as const;
+const BASE_CHAIN_ID = 8453;
+
+// Standard ERC-20 transfer function ABI
+const ERC20_ABI = [
+  {
+    type: "function",
+    name: "transfer",
+    inputs: [
+      { name: "to", type: "address" },
+      { name: "value", type: "uint256" },
+    ],
+    outputs: [{ name: "", type: "bool" }],
+    stateMutability: "nonpayable",
+  },
+] as const;
+
+/**
+ * Method schema for base/charge — must match the server-side definition.
+ */
+const baseChargeMethod = Method.from({
+  name: "base" as const,
+  intent: "charge" as const,
+  schema: {
+    credential: {
+      payload: z.object({
+        hash: z.string(),
+        type: z.literal("hash"),
+      }),
+    },
+    request: z.pipe(
+      z.object({
+        amount: z.string(),
+        currency: z.string(),
+        recipient: z.string(),
+        chainId: z.optional(z.number()),
+        decimals: z.optional(z.number()),
+      }),
+      z.transform((v: any) => ({ ...v, methodDetails: { chainId: v.chainId ?? BASE_CHAIN_ID } })),
+    ),
+  },
+});
+
+interface BaseChargeClientConfig {
+  account: LocalAccount;
+  rpcUrl?: string;
+}
+
+/**
+ * Creates a Base charge client method for sending ERC-20 USDC transfers.
+ */
+export function baseChargeClient(config: BaseChargeClientConfig) {
+  return Method.toClient(baseChargeMethod as any, {
+    async createCredential({ challenge }: any) {
+      const { request } = challenge;
+      const amount = BigInt(request.amount);
+      const recipient = request.recipient as `0x${string}`;
+      const currency = (request.currency ?? BASE_USDC) as `0x${string}`;
+
+      // Dynamic imports to keep the module lightweight
+      const { createWalletClient, createPublicClient, http, encodeFunctionData } = await import("viem");
+      const { base } = await import("viem/chains");
+
+      const rpcUrl = config.rpcUrl ?? "https://mainnet.base.org";
+
+      const walletClient = createWalletClient({
+        account: config.account,
+        chain: base,
+        transport: http(rpcUrl),
+      });
+
+      const publicClient = createPublicClient({
+        chain: base,
+        transport: http(rpcUrl),
+      });
+
+      // Send ERC-20 transfer
+      const hash = await walletClient.writeContract({
+        address: currency,
+        abi: ERC20_ABI,
+        functionName: "transfer",
+        args: [recipient, amount],
+      });
+
+      // Wait for confirmation
+      await publicClient.waitForTransactionReceipt({ hash });
+
+      return Credential.serialize({
+        challenge,
+        payload: { hash, type: "hash" as const },
+        source: `did:pkh:eip155:${BASE_CHAIN_ID}:${config.account.address}`,
+      });
+    },
+  });
+}

package/src/core/payments.ts

@@ -49,7 +49,8 @@ async function initMpp(wallet: WalletEntry): Promise<typeof fetch | null> {
       return null;
     }
 
-    const mppx = Mppx.create({ methods: [tempo({ account })] as any });
+    const { baseChargeClient } = await import("./base-charge.js");
+    const mppx = Mppx.create({ methods: [tempo({ account }), baseChargeClient({ account })] as any });
     return mppx.fetch.bind(mppx) as typeof fetch;
   } catch {
     return null;

package/src/index.ts

@@ -23,10 +23,35 @@ import { registerJobResources } from "./resources/jobs.js";
 import { registerPrompts } from "./prompts/index.js";
 
 export async function startMcpServer(): Promise<void> {
-  const server = new McpServer({
-    name: "agentwonderland",
-    version: "0.2.0",
-  });
+  const server = new McpServer(
+    {
+      name: "agentwonderland",
+      version: "0.2.0",
+    },
+    {
+      instructions: [
+        "Agent Wonderland is an AI agent marketplace. Use these tools to discover, run, and rate AI 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.",
+        "",
+        "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. 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 is automatic via the configured wallet. The user does not need to do anything for payment.",
+      ].join("\n"),
+    },
+  );
 
   // Register tools
   registerSearchTools(server);