@agentwonderland/mcp 0.1.36 → 0.1.38

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

@@ -45,6 +45,10 @@ describe("api-client headers", () => {
                 Accept: "application/json",
                 "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.37",
+                "X-AW-MCP-Tool": "run_agent",
+                "X-AW-MCP-Action": "execute",
             }),
         }));
     });

package/dist/core/__tests__/payments.test.js

@@ -53,20 +53,11 @@ describe("payment method initialization", () => {
             .mockReturnValueOnce({ fetch: createdFetches[2] })
             .mockReturnValueOnce({ fetch: createdFetches[3] });
     });
-    it("rebuilds the cached card fetch when the card config changes", async () => {
+    it("rejects explicit card payment while card payments are launch-gated", async () => {
         const { getPaymentFetch } = await import("../payments.js");
-        const firstFetch = await getPaymentFetch("card");
-        currentCard = {
-            consumerToken: "consumer_two",
-            paymentMethodId: "pm_two",
-            last4: "2222",
-            brand: "mastercard",
-        };
-        const secondFetch = await getPaymentFetch("card");
-        expect(firstFetch).not.toBe(secondFetch);
-        expect(mockMppxCreate).toHaveBeenCalledTimes(2);
-        expect(mockMppxCreate).toHaveBeenNthCalledWith(1, expect.objectContaining({ polyfill: false }));
-        expect(mockMppxCreate).toHaveBeenNthCalledWith(2, expect.objectContaining({ polyfill: false }));
+        await expect(getPaymentFetch("card")).rejects.toThrow("Card payments are temporarily unavailable");
+        expect(mockMppxCreate).not.toHaveBeenCalled();
+        expect(mockStripe).not.toHaveBeenCalled();
     });
     it("initializes only the Base method when base is requested", async () => {
         const wallet = {

package/dist/core/api-client.js

@@ -12,10 +12,32 @@ export class ApiError extends Error {
         this.name = "ApiError";
     }
 }
-async function buildHeaders(options) {
+const MCP_VERSION = "0.1.37";
+function inferToolHeaders(path, method) {
+    if (path === "/solve") {
+        return { "X-AW-MCP-Tool": "solve", "X-AW-MCP-Action": method === "POST" ? "execute" : "view" };
+    }
+    if (/^\/agents\/[^/]+\/run$/.test(path)) {
+        return { "X-AW-MCP-Tool": "run_agent", "X-AW-MCP-Action": method === "POST" ? "execute" : "view" };
+    }
+    if (path.startsWith("/agents?") || path === "/agents" || path === "/agents/search") {
+        return { "X-AW-MCP-Tool": "search_agents", "X-AW-MCP-Action": "search" };
+    }
+    if (/^\/agents\/[^/]+$/.test(path)) {
+        return { "X-AW-MCP-Tool": "get_agent", "X-AW-MCP-Action": "view" };
+    }
+    if (path.startsWith("/jobs")) {
+        return { "X-AW-MCP-Tool": "get_job", "X-AW-MCP-Action": "poll" };
+    }
+    return {};
+}
+async function buildHeaders(path, method, options) {
     const headers = {
         "Content-Type": "application/json",
         Accept: "application/json",
+        "X-AW-Surface": "mcp",
+        "X-AW-MCP-Version": MCP_VERSION,
+        ...inferToolHeaders(path, method),
     };
     const apiKey = getApiKey();
     if (apiKey) {
@@ -86,7 +108,7 @@ export async function apiGet(path, options) {
     const url = `${getApiUrl()}${path}`;
     const response = await fetch(url, {
         method: "GET",
-        headers: await buildHeaders(options),
+        headers: await buildHeaders(path, "GET", options),
     });
     const result = await handleResponse(response);
     return attachResponseMetadata(result, response);
@@ -95,7 +117,7 @@ export async function apiPost(path, body, options) {
     const url = `${getApiUrl()}${path}`;
     const response = await fetch(url, {
         method: "POST",
-        headers: await buildHeaders(options),
+        headers: await buildHeaders(path, "POST", options),
         body: JSON.stringify(body),
     });
     const result = await handleResponse(response);
@@ -111,7 +133,7 @@ export async function apiPostWithPayment(path, body, payWith, options) {
     const paymentFetch = await getPaymentFetch(payWith);
     const response = await paymentFetch(url, {
         method: "POST",
-        headers: await buildHeaders({
+        headers: await buildHeaders(path, "POST", {
             ensureConsumerPrincipal: true,
             principalMethod: payWith,
             ...options,
@@ -125,7 +147,7 @@ export async function apiPut(path, body, options) {
     const url = `${getApiUrl()}${path}`;
     const response = await fetch(url, {
         method: "PUT",
-        headers: await buildHeaders(options),
+        headers: await buildHeaders(path, "PUT", options),
         body: JSON.stringify(body),
     });
     const result = await handleResponse(response);

package/dist/core/formatters.d.ts

@@ -24,6 +24,10 @@ interface AgentLike {
         completedJobs?: number;
         avgRating?: number | null;
     };
+    provider?: {
+        name?: string;
+        slug?: string;
+    } | null;
     [key: string]: unknown;
 }
 export declare function agentLine(agent: AgentLike): string;

package/dist/core/formatters.js

@@ -44,10 +44,11 @@ export function agentLine(agent) {
     const rating = agent.avgRating ?? agent.stats?.avgRating ?? null;
     const jobs = agent.stats?.completedJobs ?? agent.totalExecutions ?? 0;
     const price = formatPrice(agent.pricePerRunUsd);
+    const provider = agent.provider?.name ? ` by ${agent.provider.name}` : "";
     const reliability = agent.successRate != null && Number(agent.successRate) < 1
         ? ` • ${(Number(agent.successRate) * 100).toFixed(0)}% reliable`
         : "";
-    return `${name}${slug} ${stars(rating)} ${compactNumber(jobs)} jobs • ${price}${reliability}`;
+    return `${name}${slug}${provider} ${stars(rating)} ${compactNumber(jobs)} jobs • ${price}${reliability}`;
 }
 export function formatLastActive(lastActiveAt) {
     if (!lastActiveAt)

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

@@ -2,6 +2,7 @@ import { Connection, PublicKey } from "@solana/web3.js";
 import type { WalletEntry } from "./config.js";
 export declare const SOLANA_USDC_MINT: "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
 export declare const SOLANA_CHAIN_ID: "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+export declare const SOLANA_CHAIN_ID_DEVNET: "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1wcaWoxPkrZBG";
 interface SolanaChargeClientConfig {
     wallet: WalletEntry;
     rpcUrl?: string;

package/dist/core/solana-charge.js

@@ -10,7 +10,9 @@ import { ASSOCIATED_TOKEN_PROGRAM_ID, TOKEN_PROGRAM_ID, createAssociatedTokenAcc
 import { toAtomicAmount } from "./amount-utils.js";
 export const SOLANA_USDC_MINT = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v";
 export const SOLANA_CHAIN_ID = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp";
+export const SOLANA_CHAIN_ID_DEVNET = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1wcaWoxPkrZBG";
 const SOLANA_RPC = "https://api.mainnet-beta.solana.com";
+const SOLANA_RPC_DEVNET = "https://api.devnet.solana.com";
 const solanaChargeMethod = Method.from({
     name: "solana",
     intent: "charge",
@@ -83,13 +85,15 @@ export function solanaChargeClient(config) {
     return Method.toClient(solanaChargeMethod, {
         async createCredential({ challenge }) {
             const { request } = challenge;
+            const chainId = request.chainId ?? request.methodDetails?.chainId ?? SOLANA_CHAIN_ID;
+            const rpcUrl = config.rpcUrl ?? (chainId === SOLANA_CHAIN_ID_DEVNET ? SOLANA_RPC_DEVNET : SOLANA_RPC);
             const amount = toAtomicAmount(request.amount, request.decimals ?? 6);
             const decimals = request.decimals ?? 6;
             const mint = new PublicKey(request.currency ?? SOLANA_USDC_MINT);
             const recipient = new PublicKey(request.recipient);
             const keypair = await getKeypair(config.wallet);
             const owner = keypair.publicKey;
-            const connection = new Connection(config.rpcUrl ?? SOLANA_RPC, "confirmed");
+            const connection = new Connection(rpcUrl, "confirmed");
             const sourceTokenAccount = getAssociatedTokenAddressSync(mint, owner, false, TOKEN_PROGRAM_ID, ASSOCIATED_TOKEN_PROGRAM_ID);
             const destination = await resolveRecipientTokenAccount(connection, mint, recipient);
             const instructions = [];
@@ -111,7 +115,7 @@ export function solanaChargeClient(config) {
             return Credential.serialize({
                 challenge,
                 payload: { signature, type: "signature" },
-                source: `did:pkh:${SOLANA_CHAIN_ID}:${owner.toBase58()}`,
+                source: `did:pkh:${chainId}:${owner.toBase58()}`,
             });
         },
     });

package/dist/core/types.d.ts

@@ -18,6 +18,19 @@ export interface AgentRecord {
         ratingCount?: number;
         [key: string]: unknown;
     };
+    provider?: {
+        id?: string;
+        name?: string;
+        slug?: string;
+        website_url?: string | null;
+    } | null;
+    urls?: {
+        public_url?: string;
+        normalized_x402_url?: string;
+        mirrored_x402_url?: string | null;
+        agent_card_url?: string;
+        provider_url?: string | null;
+    };
     payment?: {
         pricing?: Record<string, unknown>;
         accepted_payments?: string[];

package/dist/index.js

@@ -14,6 +14,7 @@ import { registerTipTools } from "./tools/tip.js";
 import { registerPassTools } from "./tools/passes.js";
 import { registerUploadTools } from "./tools/upload.js";
 import { registerProbeTools } from "./tools/probe.js";
+import { registerProviderTools } from "./tools/providers.js";
 // ── Resources ────────────────────────────────────────────────────
 import { registerAgentResources } from "./resources/agents.js";
 import { registerWalletResources } from "./resources/wallet.js";
@@ -77,6 +78,7 @@ export async function startMcpServer() {
     registerPassTools(server);
     registerUploadTools(server);
     registerProbeTools(server);
+    registerProviderTools(server);
     // Register resources
     registerAgentResources(server);
     registerWalletResources(server);

package/dist/tools/__tests__/wallet.test.js

@@ -56,6 +56,7 @@ vi.mock("../../core/config.js", () => ({
 }));
 vi.mock("../../core/payments.js", () => ({
     getWalletAddress: async () => null,
+    isCardPaymentEnabled: () => true,
 }));
 vi.mock("../../core/card-setup.js", () => ({
     formatCardSetupBlocks: () => state.cardSetupBlocks,

package/dist/tools/agent-info.js

@@ -15,6 +15,8 @@ export function registerAgentInfoTools(server) {
         const _pricing = (payment.pricing ?? {});
         const creditPacks = payment.credit_packs;
         const totalJobs = (s.completedJobs ?? a.totalExecutions ?? 0);
+        const provider = a.provider ?? null;
+        const urls = a.urls ?? {};
         const acceptedPayments = payment.accepted_payments ?? [];
         const paymentLabelMap = {
             tempo_usdc: "tempo",
@@ -29,6 +31,7 @@ export function registerAgentInfoTools(server) {
             "",
             a.description ?? "",
             "",
+            ...(provider?.name ? [`Provider: ${provider.name}${provider.slug ? ` (${provider.slug})` : ""}`] : []),
             `Pricing: ${formatPrice(a.pricePerRunUsd)}`,
             ...(paymentLabels.length > 0 ? [`Accepted payments: ${paymentLabels.join(", ")}`] : []),
             ...(totalJobs > 0 && a.successRate != null
@@ -91,7 +94,7 @@ export function registerAgentInfoTools(server) {
                 lines.push(`  ${name}: ${def.type ?? "string"}${req}${desc}`);
             }
         }
-        lines.push("", `ID: ${a.id}`, `View: ${agentWebUrl(a.id)}`);
+        lines.push("", `ID: ${a.id}`, `View: ${urls.public_url ?? agentWebUrl(a.id)}`, ...(urls.mirrored_x402_url ? [`Mirrored x402: ${urls.mirrored_x402_url}`] : []), ...(urls.normalized_x402_url ? [`Agent x402: ${urls.normalized_x402_url}`] : []), ...(urls.agent_card_url ? [`AgentCard: ${urls.agent_card_url}`] : []));
         return text(lines.join("\n"));
     });
 }

package/dist/tools/index.d.ts

@@ -10,3 +10,4 @@ export { registerTipTools } from "./tip.js";
 export { registerPassTools } from "./passes.js";
 export { registerUploadTools } from "./upload.js";
 export { registerProbeTools } from "./probe.js";
+export { registerProviderTools } from "./providers.js";

package/dist/tools/index.js

@@ -10,3 +10,4 @@ export { registerTipTools } from "./tip.js";
 export { registerPassTools } from "./passes.js";
 export { registerUploadTools } from "./upload.js";
 export { registerProbeTools } from "./probe.js";
+export { registerProviderTools } from "./providers.js";

package/dist/tools/providers.d.ts

@@ -0,0 +1,2 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+export declare function registerProviderTools(server: McpServer): void;

package/dist/tools/providers.js

@@ -0,0 +1,40 @@
+import { z } from "zod";
+import { apiGet } from "../core/api-client.js";
+import { agentLine } from "../core/formatters.js";
+function text(t) {
+    return { content: [{ type: "text", text: t }] };
+}
+export function registerProviderTools(server) {
+    server.tool("search_providers", "Search API providers listed on Agent Wonderland.", {
+        query: z.string().optional().describe("Provider name or keyword"),
+        limit: z.number().int().min(1).max(25).default(10),
+    }, async ({ query, limit }) => {
+        const params = new URLSearchParams();
+        if (query)
+            params.set("q", query);
+        params.set("limit", String(limit));
+        const providers = await apiGet(`/providers?${params}`);
+        if (providers.length === 0)
+            return text(query ? `No providers found matching "${query}".` : "No providers found.");
+        return text([
+            `Found ${providers.length} provider${providers.length === 1 ? "" : "s"}:`,
+            "",
+            ...providers.map((provider) => `  ${provider.name} (${provider.slug}) • ${provider.stats?.live_endpoints ?? 0} endpoints`),
+        ].join("\n"));
+    });
+    server.tool("get_provider", "Get an API provider profile and its live payable endpoints.", {
+        provider: z.string().describe("Provider slug"),
+        limit: z.number().int().min(1).max(100).default(50),
+    }, async ({ provider, limit }) => {
+        const profile = await apiGet(`/providers/${provider}`);
+        const agents = await apiGet(`/providers/${provider}/agents?limit=${limit}`);
+        return text([
+            `${profile.name} (${profile.slug})`,
+            profile.description ?? "",
+            ...(profile.website_url ? [`Website: ${profile.website_url}`] : []),
+            `Live endpoints: ${profile.stats?.live_endpoints ?? agents.length}`,
+            "",
+            ...agents.map((agent) => `  ${agentLine(agent)}`),
+        ].filter(Boolean).join("\n"));
+    });
+}

package/dist/tools/run.js

@@ -87,7 +87,7 @@ function buildCreditPackOfferLines(agent) {
 export function registerRunTools(server) {
     server.tool("run_agent", "Run an AI agent from the marketplace. Pays automatically via configured wallet. Returns the agent's output, cost, and job ID for tracking. If spending confirmation is enabled, first call returns a price quote — call again with confirmed: true to execute. Local file paths in the input (e.g. /Users/.../photo.jpg) are automatically uploaded to temporary storage and replaced with download URLs before execution. If a file you need isn't on this MCP server's filesystem (e.g. a sandboxed /mnt/... attachment), call upload_file first to get a presigned upload URL, PUT the bytes to it, then pass the returned GET URL as input instead — that keeps the bytes out of the conversation context.", {
         agent_id: z.string().describe("Agent ID (UUID, slug, or name)"),
-        input: z.record(z.unknown()).describe("Input payload for the agent"),
+        input: z.record(z.string(), z.unknown()).describe("Input payload for the agent"),
         pay_with: z.string().trim().min(1).optional().describe("Payment method — wallet ID, chain name (tempo, base, etc.), or 'card'. Auto-detected if omitted."),
         confirmed: z.boolean().optional().describe("Set to true to confirm spending after seeing the price quote."),
     }, async ({ agent_id, input, pay_with, confirmed }) => {

package/dist/tools/search.js

@@ -9,17 +9,23 @@ function text(t) {
 export function registerSearchTools(server) {
     server.tool("search_agents", "Search the Agent Wonderland marketplace for AI agents. Returns a ranked list of matching agents with ratings, pricing, and job counts.", {
         query: z.string().optional().describe("Search query (natural language or keywords)"),
+        provider: z.string().optional().describe("Filter by API provider name or slug"),
+        provider_slug: z.string().optional().describe("Filter by exact API provider slug"),
         tag: z.string().optional().describe("Filter by tag (e.g. 'code', 'image', 'data')"),
         limit: z.number().optional().default(10).describe("Max results (1-50)"),
         max_price: z.number().optional().describe("Maximum price per request in USD"),
         min_rating: z.number().min(1).max(5).optional().describe("Minimum star rating (1-5)"),
         sort: z.enum(["relevance", "price", "rating", "popularity", "newest"]).optional()
             .describe("Sort results by: relevance (default), price, rating, popularity, or newest"),
-    }, async ({ query, tag, limit, max_price, min_rating, sort }) => {
+    }, async ({ query, provider, provider_slug, tag, limit, max_price, min_rating, sort }) => {
         const requestedLimit = Math.max(1, Math.min(50, limit ?? 10));
         const params = new URLSearchParams();
         if (query)
             params.set("q", query);
+        if (provider_slug)
+            params.set("provider_slug", provider_slug);
+        else if (provider)
+            params.set("provider", provider);
         if (tag)
             params.set("tag", tag);
         // min_rating is filtered client-side on avgRating. Request extra candidates

package/dist/tools/solve.js

@@ -110,7 +110,7 @@ export function registerSolveTools(server) {
             .string()
             .describe("What you want to accomplish (natural language)"),
         input: z
-            .record(z.unknown())
+            .record(z.string(), z.unknown())
             .optional()
             .default({})
             .describe("Input payload for the agent"),

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@agentwonderland/mcp",
-  "version": "0.1.36",
+  "version": "0.1.38",
   "type": "module",
   "description": "MCP server for the Agent Wonderland AI agent marketplace",
   "bin": {
@@ -28,7 +28,7 @@
     "mppx": "^0.5.10",
     "qrcode": "^1.5.4",
     "viem": "^2.47.6",
-    "zod": "^3.24.0"
+    "zod": "^4.3.6"
   },
   "optionalDependencies": {
     "@open-wallet-standard/core": "^1.0.0"

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

@@ -71,6 +71,10 @@ describe("api-client headers", () => {
             "did:pkh:solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp:42W2HfLfveSm1T5et9WTLp2CZ2QXdF2EYCUvyJ2gPpxF",
           "X-AW-Rebate-Principal":
             "did:pkh:eip155:8453:0xbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbbb",
+          "X-AW-Surface": "mcp",
+          "X-AW-MCP-Version": "0.1.37",
+          "X-AW-MCP-Tool": "run_agent",
+          "X-AW-MCP-Action": "execute",
         }),
       }),
     );

package/src/core/__tests__/payments.test.ts

@@ -63,28 +63,14 @@ describe("payment method initialization", () => {
       .mockReturnValueOnce({ fetch: createdFetches[3] });
   });
 
-  it("rebuilds the cached card fetch when the card config changes", async () => {
+  it("rejects explicit card payment while card payments are launch-gated", async () => {
     const { getPaymentFetch } = await import("../payments.js");
 
-    const firstFetch = await getPaymentFetch("card");
-    currentCard = {
-      consumerToken: "consumer_two",
-      paymentMethodId: "pm_two",
-      last4: "2222",
-      brand: "mastercard",
-    };
-    const secondFetch = await getPaymentFetch("card");
-
-    expect(firstFetch).not.toBe(secondFetch);
-    expect(mockMppxCreate).toHaveBeenCalledTimes(2);
-    expect(mockMppxCreate).toHaveBeenNthCalledWith(
-      1,
-      expect.objectContaining({ polyfill: false }),
-    );
-    expect(mockMppxCreate).toHaveBeenNthCalledWith(
-      2,
-      expect.objectContaining({ polyfill: false }),
+    await expect(getPaymentFetch("card")).rejects.toThrow(
+      "Card payments are temporarily unavailable",
     );
+    expect(mockMppxCreate).not.toHaveBeenCalled();
+    expect(mockStripe).not.toHaveBeenCalled();
   });
 
   it("initializes only the Base method when base is requested", async () => {

package/src/core/api-client.ts

@@ -29,10 +29,34 @@ interface RequestOptions {
   extraHeaders?: Record<string, string>;
 }
 
-async function buildHeaders(options?: RequestOptions): Promise<Record<string, string>> {
+const MCP_VERSION = "0.1.37";
+
+function inferToolHeaders(path: string, method: string): Record<string, string> {
+  if (path === "/solve") {
+    return { "X-AW-MCP-Tool": "solve", "X-AW-MCP-Action": method === "POST" ? "execute" : "view" };
+  }
+  if (/^\/agents\/[^/]+\/run$/.test(path)) {
+    return { "X-AW-MCP-Tool": "run_agent", "X-AW-MCP-Action": method === "POST" ? "execute" : "view" };
+  }
+  if (path.startsWith("/agents?") || path === "/agents" || path === "/agents/search") {
+    return { "X-AW-MCP-Tool": "search_agents", "X-AW-MCP-Action": "search" };
+  }
+  if (/^\/agents\/[^/]+$/.test(path)) {
+    return { "X-AW-MCP-Tool": "get_agent", "X-AW-MCP-Action": "view" };
+  }
+  if (path.startsWith("/jobs")) {
+    return { "X-AW-MCP-Tool": "get_job", "X-AW-MCP-Action": "poll" };
+  }
+  return {};
+}
+
+async function buildHeaders(path: string, method: string, options?: RequestOptions): Promise<Record<string, string>> {
   const headers: Record<string, string> = {
     "Content-Type": "application/json",
     Accept: "application/json",
+    "X-AW-Surface": "mcp",
+    "X-AW-MCP-Version": MCP_VERSION,
+    ...inferToolHeaders(path, method),
   };
 
   const apiKey = getApiKey();
@@ -119,7 +143,7 @@ export async function apiGet<T>(path: string, options?: RequestOptions): Promise
   const url = `${getApiUrl()}${path}`;
   const response = await fetch(url, {
     method: "GET",
-    headers: await buildHeaders(options),
+    headers: await buildHeaders(path, "GET", options),
   });
   const result = await handleResponse<T>(response);
   return attachResponseMetadata(result, response);
@@ -129,7 +153,7 @@ export async function apiPost<T>(path: string, body: unknown, options?: RequestO
   const url = `${getApiUrl()}${path}`;
   const response = await fetch(url, {
     method: "POST",
-    headers: await buildHeaders(options),
+    headers: await buildHeaders(path, "POST", options),
     body: JSON.stringify(body),
   });
   const result = await handleResponse<T>(response);
@@ -151,7 +175,7 @@ export async function apiPostWithPayment<T>(
   const paymentFetch = await getPaymentFetch(payWith);
   const response = await paymentFetch(url, {
     method: "POST",
-    headers: await buildHeaders({
+    headers: await buildHeaders(path, "POST", {
       ensureConsumerPrincipal: true,
       principalMethod: payWith,
       ...options,
@@ -166,7 +190,7 @@ export async function apiPut<T>(path: string, body: unknown, options?: RequestOp
   const url = `${getApiUrl()}${path}`;
   const response = await fetch(url, {
     method: "PUT",
-    headers: await buildHeaders(options),
+    headers: await buildHeaders(path, "PUT", options),
     body: JSON.stringify(body),
   });
   const result = await handleResponse<T>(response);

package/src/core/formatters.ts

@@ -53,6 +53,7 @@ interface AgentLike {
   totalExecutions?: number;
   pricePerRunUsd?: string;
   stats?: { completedJobs?: number; avgRating?: number | null };
+  provider?: { name?: string; slug?: string } | null;
   [key: string]: unknown;
 }
 
@@ -62,10 +63,11 @@ export function agentLine(agent: AgentLike): string {
   const rating = agent.avgRating ?? agent.stats?.avgRating ?? null;
   const jobs = agent.stats?.completedJobs ?? agent.totalExecutions ?? 0;
   const price = formatPrice(agent.pricePerRunUsd);
+  const provider = agent.provider?.name ? ` by ${agent.provider.name}` : "";
   const reliability = agent.successRate != null && Number(agent.successRate) < 1
     ? ` • ${(Number(agent.successRate) * 100).toFixed(0)}% reliable`
     : "";
-  return `${name}${slug} ${stars(rating)} ${compactNumber(jobs)} jobs • ${price}${reliability}`;
+  return `${name}${slug}${provider} ${stars(rating)} ${compactNumber(jobs)} jobs • ${price}${reliability}`;
 }
 
 export function formatLastActive(lastActiveAt: string | null | undefined): string | null {

package/src/core/solana-charge.ts

@@ -18,7 +18,9 @@ import { toAtomicAmount } from "./amount-utils.js";
 
 export const SOLANA_USDC_MINT = "EPjFWdd5AufqSSqeM2qN1xzybapC8G4wEGGkZwyTDt1v" as const;
 export const SOLANA_CHAIN_ID = "solana:5eykt4UsFv8P8NJdTREpY1vzqKqZKvdp" as const;
+export const SOLANA_CHAIN_ID_DEVNET = "solana:EtWTRABZaYq6iMfeYKouRu166VU2xqa1wcaWoxPkrZBG" as const;
 const SOLANA_RPC = "https://api.mainnet-beta.solana.com";
+const SOLANA_RPC_DEVNET = "https://api.devnet.solana.com";
 
 const solanaChargeMethod = Method.from({
   name: "solana" as const,
@@ -116,13 +118,15 @@ export function solanaChargeClient(config: SolanaChargeClientConfig) {
   return Method.toClient(solanaChargeMethod as any, {
     async createCredential({ challenge }: any) {
       const { request } = challenge;
+      const chainId = request.chainId ?? request.methodDetails?.chainId ?? SOLANA_CHAIN_ID;
+      const rpcUrl = config.rpcUrl ?? (chainId === SOLANA_CHAIN_ID_DEVNET ? SOLANA_RPC_DEVNET : SOLANA_RPC);
       const amount = toAtomicAmount(request.amount, request.decimals ?? 6);
       const decimals = request.decimals ?? 6;
       const mint = new PublicKey(request.currency ?? SOLANA_USDC_MINT);
       const recipient = new PublicKey(request.recipient);
       const keypair = await getKeypair(config.wallet);
       const owner = keypair.publicKey;
-      const connection = new Connection(config.rpcUrl ?? SOLANA_RPC, "confirmed");
+      const connection = new Connection(rpcUrl, "confirmed");
 
       const sourceTokenAccount = getAssociatedTokenAddressSync(
         mint,
@@ -177,7 +181,7 @@ export function solanaChargeClient(config: SolanaChargeClientConfig) {
       return Credential.serialize({
         challenge,
         payload: { signature, type: "signature" as const },
-        source: `did:pkh:${SOLANA_CHAIN_ID}:${owner.toBase58()}`,
+        source: `did:pkh:${chainId}:${owner.toBase58()}`,
       });
     },
   });

package/src/core/types.ts

@@ -19,6 +19,19 @@ export interface AgentRecord {
     ratingCount?: number;
     [key: string]: unknown;
   };
+  provider?: {
+    id?: string;
+    name?: string;
+    slug?: string;
+    website_url?: string | null;
+  } | null;
+  urls?: {
+    public_url?: string;
+    normalized_x402_url?: string;
+    mirrored_x402_url?: string | null;
+    agent_card_url?: string;
+    provider_url?: string | null;
+  };
   payment?: {
     pricing?: Record<string, unknown>;
     accepted_payments?: string[];

package/src/index.ts

@@ -16,6 +16,7 @@ import { registerTipTools } from "./tools/tip.js";
 import { registerPassTools } from "./tools/passes.js";
 import { registerUploadTools } from "./tools/upload.js";
 import { registerProbeTools } from "./tools/probe.js";
+import { registerProviderTools } from "./tools/providers.js";
 
 // ── Resources ────────────────────────────────────────────────────
 import { registerAgentResources } from "./resources/agents.js";
@@ -86,6 +87,7 @@ export async function startMcpServer(): Promise<void> {
   registerPassTools(server);
   registerUploadTools(server);
   registerProbeTools(server);
+  registerProviderTools(server);
 
   // Register resources
   registerAgentResources(server);

package/src/tools/__tests__/wallet.test.ts

@@ -86,6 +86,7 @@ vi.mock("../../core/config.js", () => ({
 
 vi.mock("../../core/payments.js", () => ({
   getWalletAddress: async () => null,
+  isCardPaymentEnabled: () => true,
 }));
 
 vi.mock("../../core/card-setup.js", () => ({

package/src/tools/agent-info.ts

@@ -32,6 +32,8 @@ export function registerAgentInfoTools(server: McpServer): void {
       } | null | undefined;
 
       const totalJobs = (s.completedJobs ?? a.totalExecutions ?? 0) as number;
+      const provider = a.provider ?? null;
+      const urls = a.urls ?? {};
       const acceptedPayments = (payment.accepted_payments as string[] | undefined) ?? [];
       const paymentLabelMap: Record<string, string> = {
         tempo_usdc: "tempo",
@@ -47,6 +49,7 @@ export function registerAgentInfoTools(server: McpServer): void {
         "",
         (a.description as string) ?? "",
         "",
+        ...(provider?.name ? [`Provider: ${provider.name}${provider.slug ? ` (${provider.slug})` : ""}`] : []),
         `Pricing: ${formatPrice(a.pricePerRunUsd)}`,
         ...(paymentLabels.length > 0 ? [`Accepted payments: ${paymentLabels.join(", ")}`] : []),
         ...(totalJobs > 0 && a.successRate != null
@@ -113,7 +116,14 @@ export function registerAgentInfoTools(server: McpServer): void {
         }
       }
 
-      lines.push("", `ID: ${a.id}`, `View: ${agentWebUrl(a.id)}`);
+      lines.push(
+        "",
+        `ID: ${a.id}`,
+        `View: ${urls.public_url ?? agentWebUrl(a.id)}`,
+        ...(urls.mirrored_x402_url ? [`Mirrored x402: ${urls.mirrored_x402_url}`] : []),
+        ...(urls.normalized_x402_url ? [`Agent x402: ${urls.normalized_x402_url}`] : []),
+        ...(urls.agent_card_url ? [`AgentCard: ${urls.agent_card_url}`] : []),
+      );
       return text(lines.join("\n"));
     },
   );

package/src/tools/index.ts

@@ -10,3 +10,4 @@ export { registerTipTools } from "./tip.js";
 export { registerPassTools } from "./passes.js";
 export { registerUploadTools } from "./upload.js";
 export { registerProbeTools } from "./probe.js";
+export { registerProviderTools } from "./providers.js";

package/src/tools/providers.ts

@@ -0,0 +1,64 @@
+import type { McpServer } from "@modelcontextprotocol/sdk/server/mcp.js";
+import { z } from "zod";
+import { apiGet } from "../core/api-client.js";
+import { agentLine } from "../core/formatters.js";
+import type { AgentRecord } from "../core/types.js";
+
+function text(t: string) {
+  return { content: [{ type: "text" as const, text: t }] };
+}
+
+interface ProviderRecord {
+  id: string;
+  name: string;
+  slug: string;
+  description?: string | null;
+  website_url?: string | null;
+  logo_url?: string | null;
+  support_email?: string | null;
+  stats?: { live_endpoints?: number; total_executions?: number };
+}
+
+export function registerProviderTools(server: McpServer): void {
+  server.tool(
+    "search_providers",
+    "Search API providers listed on Agent Wonderland.",
+    {
+      query: z.string().optional().describe("Provider name or keyword"),
+      limit: z.number().int().min(1).max(25).default(10),
+    },
+    async ({ query, limit }) => {
+      const params = new URLSearchParams();
+      if (query) params.set("q", query);
+      params.set("limit", String(limit));
+      const providers = await apiGet<ProviderRecord[]>(`/providers?${params}`);
+      if (providers.length === 0) return text(query ? `No providers found matching "${query}".` : "No providers found.");
+      return text([
+        `Found ${providers.length} provider${providers.length === 1 ? "" : "s"}:`,
+        "",
+        ...providers.map((provider) => `  ${provider.name} (${provider.slug}) • ${provider.stats?.live_endpoints ?? 0} endpoints`),
+      ].join("\n"));
+    },
+  );
+
+  server.tool(
+    "get_provider",
+    "Get an API provider profile and its live payable endpoints.",
+    {
+      provider: z.string().describe("Provider slug"),
+      limit: z.number().int().min(1).max(100).default(50),
+    },
+    async ({ provider, limit }) => {
+      const profile = await apiGet<ProviderRecord>(`/providers/${provider}`);
+      const agents = await apiGet<AgentRecord[]>(`/providers/${provider}/agents?limit=${limit}`);
+      return text([
+        `${profile.name} (${profile.slug})`,
+        profile.description ?? "",
+        ...(profile.website_url ? [`Website: ${profile.website_url}`] : []),
+        `Live endpoints: ${profile.stats?.live_endpoints ?? agents.length}`,
+        "",
+        ...agents.map((agent) => `  ${agentLine(agent)}`),
+      ].filter(Boolean).join("\n"));
+    },
+  );
+}

package/src/tools/run.ts

@@ -126,7 +126,7 @@ export function registerRunTools(server: McpServer): void {
     "Run an AI agent from the marketplace. Pays automatically via configured wallet. Returns the agent's output, cost, and job ID for tracking. If spending confirmation is enabled, first call returns a price quote — call again with confirmed: true to execute. Local file paths in the input (e.g. /Users/.../photo.jpg) are automatically uploaded to temporary storage and replaced with download URLs before execution. If a file you need isn't on this MCP server's filesystem (e.g. a sandboxed /mnt/... attachment), call upload_file first to get a presigned upload URL, PUT the bytes to it, then pass the returned GET URL as input instead — that keeps the bytes out of the conversation context.",
     {
       agent_id: z.string().describe("Agent ID (UUID, slug, or name)"),
-      input: z.record(z.unknown()).describe("Input payload for the agent"),
+      input: z.record(z.string(), z.unknown()).describe("Input payload for the agent"),
       pay_with: z.string().trim().min(1).optional().describe("Payment method — wallet ID, chain name (tempo, base, etc.), or 'card'. Auto-detected if omitted."),
       confirmed: z.boolean().optional().describe("Set to true to confirm spending after seeing the price quote."),
     },

package/src/tools/search.ts

@@ -16,6 +16,8 @@ export function registerSearchTools(server: McpServer): void {
     "Search the Agent Wonderland marketplace for AI agents. Returns a ranked list of matching agents with ratings, pricing, and job counts.",
     {
       query: z.string().optional().describe("Search query (natural language or keywords)"),
+      provider: z.string().optional().describe("Filter by API provider name or slug"),
+      provider_slug: z.string().optional().describe("Filter by exact API provider slug"),
       tag: z.string().optional().describe("Filter by tag (e.g. 'code', 'image', 'data')"),
       limit: z.number().optional().default(10).describe("Max results (1-50)"),
       max_price: z.number().optional().describe("Maximum price per request in USD"),
@@ -23,10 +25,12 @@ export function registerSearchTools(server: McpServer): void {
       sort: z.enum(["relevance", "price", "rating", "popularity", "newest"]).optional()
         .describe("Sort results by: relevance (default), price, rating, popularity, or newest"),
     },
-    async ({ query, tag, limit, max_price, min_rating, sort }) => {
+    async ({ query, provider, provider_slug, tag, limit, max_price, min_rating, sort }) => {
       const requestedLimit = Math.max(1, Math.min(50, limit ?? 10));
       const params = new URLSearchParams();
       if (query) params.set("q", query);
+      if (provider_slug) params.set("provider_slug", provider_slug);
+      else if (provider) params.set("provider", provider);
       if (tag) params.set("tag", tag);
 
       // min_rating is filtered client-side on avgRating. Request extra candidates

package/src/tools/solve.ts

@@ -143,7 +143,7 @@ export function registerSolveTools(server: McpServer): void {
         .string()
         .describe("What you want to accomplish (natural language)"),
       input: z
-        .record(z.unknown())
+        .record(z.string(), z.unknown())
         .optional()
         .default({})
         .describe("Input payload for the agent"),