@agentwonderland/mcp 0.1.37 → 0.1.39

package/src/core/solana-charge.ts

@@ -4,7 +4,7 @@
  * Sends an SPL Token transfer on Solana mainnet and returns the transaction
  * signature as the payment credential.
  */
-import { Credential, Method, z } from "mppx";
+import { Credential, Method, z } from "./mpp-client.js";
 import { Connection, Keypair, PublicKey, Transaction, sendAndConfirmTransaction } from "@solana/web3.js";
 import {
   ASSOCIATED_TOKEN_PROGRAM_ID,
@@ -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/tempo-charge.ts

@@ -4,7 +4,7 @@
  * Sends a standard ERC-20 transfer on Tempo and returns the tx hash as the
  * payment credential.
  */
-import { Method, Credential, z } from "mppx";
+import { Method, Credential, z } from "./mpp-client.js";
 import type { LocalAccount } from "viem/accounts";
 import { toAtomicAmount } from "./amount-utils.js";
 

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"),