@agentwonderland/mcp 0.1.45 → 0.1.47

package/dist/core/payments.js

@@ -9,7 +9,7 @@
  * Users can configure multiple wallets with different chains and select
  * which to use per-request via `--pay-with <wallet-id|chain|card>`.
  */
-import { getConfig, getWallets, getDefaultWallet, getCardConfig, resolveWalletAndChain, getApiUrl, } from "./config.js";
+import { getConfig, getWallets, getDefaultWallet, getCardConfig, getLinkConfig, resolveWalletAndChain, getApiUrl, } from "./config.js";
 // Feature flag: disable card payment for launch. Flip to true once Stripe
 // approves the live SPT issuer. Config/card state is still persisted so this
 // can be re-enabled without reconfiguring wallets.
@@ -24,12 +24,30 @@ const REGISTRY_METHOD_MAP = {
     base: "base_usdc",
     solana: "solana_usdc",
     card: "stripe_card",
+    link: "stripe_card",
+};
+const DEFAULT_LINK_APPROVAL_LIMIT_CENTS = 10_000;
+const ACCEPTED_PAYMENT_ALIASES = {
+    tempo: ["tempo_usdc", "tempo"],
+    base: ["base_usdc", "base"],
+    solana: ["solana_usdc", "solana"],
+    card: ["stripe_card", "card"],
+    link: ["stripe_card", "card", "link"],
+};
+const DISCOVERY_PAYMENT_ALIASES = {
+    tempo: ["tempo_usdc"],
+    base: ["base_usdc"],
+    solana: ["solana_usdc"],
+    card: ["stripe_card", "card"],
+    link: ["stripe_card", "card"],
 };
 const METHOD_REGISTRY_MAP = {
     tempo_usdc: "tempo",
     base_usdc: "base",
     solana_usdc: "solana",
     stripe_card: "card",
+    card: "card",
+    link: "link",
 };
 // ── Helpers ─────────────────────────────────────────────────────
 function normalizeKey(key) {
@@ -44,6 +62,12 @@ function cardCacheKey() {
         return null;
     return `card:${getApiUrl()}:${card.consumerToken}:${card.paymentMethodId ?? ""}`;
 }
+function linkCacheKey() {
+    const link = getLinkConfig();
+    if (!link)
+        return null;
+    return `link:${getApiUrl()}:${link.paymentMethodId}`;
+}
 function clearStaleCardCache(activeKey) {
     for (const key of fetchCache.keys()) {
         if (key.startsWith("card:") && key !== activeKey) {
@@ -51,6 +75,13 @@ function clearStaleCardCache(activeKey) {
         }
     }
 }
+function clearStaleLinkCache(activeKey) {
+    for (const key of fetchCache.keys()) {
+        if (key.startsWith("link:") && key !== activeKey) {
+            fetchCache.delete(key);
+        }
+    }
+}
 // ── Per-protocol initializers ───────────────────────────────────
 async function initEvmMppForChain(wallet, chain) {
     const { Mppx } = await import("./mpp-client.js");
@@ -127,6 +158,60 @@ async function initCard() {
         return null;
     }
 }
+function formatMinorCurrencyAmount(currency, amount) {
+    return `${currency.toUpperCase()} ${(Number(amount) / 100).toFixed(2)}`;
+}
+function getLinkApprovalLimitAmount(actualAmount) {
+    const actualAmountCents = Number(actualAmount);
+    const configuredLimit = Number(process.env.AGENTWONDERLAND_LINK_APPROVAL_LIMIT_CENTS);
+    const defaultLimit = Number.isFinite(configuredLimit) && configuredLimit > 0
+        ? Math.floor(configuredLimit)
+        : DEFAULT_LINK_APPROVAL_LIMIT_CENTS;
+    return String(Math.max(actualAmountCents, defaultLimit));
+}
+function buildLinkApprovalContext(params) {
+    const amountText = formatMinorCurrencyAmount(params.currency, params.amount);
+    const approvalAmountText = formatMinorCurrencyAmount(params.currency, params.approvalAmount);
+    const agent = params.metadata?.agent_id ? ` Agent ID: ${params.metadata.agent_id}.` : "";
+    const job = params.metadata?.job_id ? ` Job ID: ${params.metadata.job_id}.` : "";
+    return (`Approve up to ${approvalAmountText} for Agent Wonderland machine payments. ` +
+        `This specific user-confirmed agent run is quoted at ${amountText}; the Agent Wonderland gateway will charge the exact quote for this request, not the full approval limit unless the quote itself is that amount.${agent}${job}`);
+}
+async function initLink() {
+    const linkConfig = getLinkConfig();
+    if (!linkConfig)
+        return null;
+    try {
+        const { Mppx, stripe } = await import("./mpp-client.js");
+        const { createLinkSharedPaymentToken } = await import("./link-cli.js");
+        const mppx = Mppx.create({
+            methods: [stripe({
+                    paymentMethod: linkConfig.paymentMethodId,
+                    createToken: async (params) => {
+                        const approvalAmount = getLinkApprovalLimitAmount(params.amount);
+                        return createLinkSharedPaymentToken({
+                            amount: approvalAmount,
+                            currency: params.currency,
+                            context: buildLinkApprovalContext({
+                                amount: params.amount,
+                                approvalAmount,
+                                currency: params.currency,
+                                metadata: params.metadata,
+                            }),
+                            expiresAt: params.expiresAt,
+                            networkId: params.networkId,
+                            paymentMethodId: linkConfig.paymentMethodId,
+                        });
+                    },
+                })],
+            polyfill: false,
+        });
+        return mppx.fetch.bind(mppx);
+    }
+    catch {
+        return null;
+    }
+}
 /**
  * Initialize a payment-aware fetch for a given wallet + chain.
  */
@@ -151,6 +236,21 @@ function initFailureMessage(method, wallet, chain, err) {
  * @param method - wallet ID, chain name, or "card". Omit for auto-detection.
  */
 export async function getPaymentFetch(method) {
+    if (method === "link") {
+        const ck = linkCacheKey();
+        clearStaleLinkCache(ck ?? undefined);
+        if (!ck) {
+            throw new Error('Payment method "link" is not configured. Run wallet_setup({ action: "add-link" }) after logging into Link.');
+        }
+        if (fetchCache.has(ck))
+            return fetchCache.get(ck);
+        const pf = await initLink();
+        if (pf) {
+            fetchCache.set(ck, pf);
+            return pf;
+        }
+        throw new Error('Payment method "link" failed to initialize. Check Link CLI auth with: npx @stripe/link-cli auth status');
+    }
     // Card payment
     if (method === "card") {
         if (!ENABLE_CARD_PAYMENT) {
@@ -196,6 +296,25 @@ export async function getPaymentFetch(method) {
     const configured = getConfiguredMethods();
     const defaultMethod = getConfig().defaultPaymentMethod;
     for (const m of configured) {
+        if (m === "link") {
+            const ck = linkCacheKey();
+            clearStaleLinkCache(ck ?? undefined);
+            if (!ck)
+                continue;
+            if (fetchCache.has(ck))
+                return fetchCache.get(ck);
+            const pf = await initLink();
+            if (pf) {
+                fetchCache.set(ck, pf);
+                return pf;
+            }
+            if (m === defaultMethod) {
+                const others = configured.filter((x) => x !== m);
+                const altText = others.length > 0 ? ` Available alternatives: ${others.join(", ")}` : "";
+                throw new Error(`Link payment failed to initialize. Check Link CLI auth with wallet_status.${altText}`);
+            }
+            continue;
+        }
         if (m === "card") {
             const ck = cardCacheKey();
             clearStaleCardCache(ck ?? undefined);
@@ -285,6 +404,9 @@ export function getConfiguredMethods() {
     if (ENABLE_CARD_PAYMENT && getCardConfig()) {
         methods.push("card");
     }
+    if (getLinkConfig()) {
+        methods.push("link");
+    }
     // Respect defaultPaymentMethod — move it to front of list (ignore card when disabled)
     const defaultMethod = getConfig().defaultPaymentMethod;
     if (defaultMethod && (defaultMethod !== "card" || ENABLE_CARD_PAYMENT)) {
@@ -303,6 +425,8 @@ export function getConfiguredMethods() {
 export function normalizePaymentMethod(method) {
     if (method === "card")
         return "card";
+    if (method === "link")
+        return "link";
     const resolved = resolveWalletAndChain(method);
     return resolved?.chain ?? null;
 }
@@ -315,6 +439,7 @@ export function paymentMethodDisplayName(method) {
         case "base": return "Base USDC";
         case "solana": return "Solana USDC";
         case "card": return "Card";
+        case "link": return "Link";
         default: return method;
     }
 }
@@ -325,9 +450,8 @@ export function paymentMethodDisplayName(method) {
  */
 export function getAcceptedPaymentMethods() {
     const methods = getConfiguredMethods();
-    return methods
-        .map((m) => REGISTRY_METHOD_MAP[m])
-        .filter(Boolean);
+    return [...new Set(methods
+            .flatMap((m) => DISCOVERY_PAYMENT_ALIASES[m] ?? [REGISTRY_METHOD_MAP[m]].filter(Boolean)))];
 }
 export function toRegistryPaymentMethod(method) {
     const normalized = normalizePaymentMethod(method);
@@ -340,16 +464,17 @@ export function getCompatiblePaymentMethods(agent, configuredMethods = getConfig
     if (!Array.isArray(acceptedPayments) || acceptedPayments.length === 0) {
         return [...configuredMethods];
     }
-    const acceptedMethods = new Set(acceptedPayments
-        .map((payment) => METHOD_REGISTRY_MAP[payment])
-        .filter(Boolean));
-    return configuredMethods.filter((method) => acceptedMethods.has(method));
+    const acceptedRegistryMethods = new Set(acceptedPayments);
+    return configuredMethods.filter((method) => {
+        const aliases = ACCEPTED_PAYMENT_ALIASES[method] ?? [REGISTRY_METHOD_MAP[method]].filter(Boolean);
+        return aliases.some((alias) => acceptedRegistryMethods.has(alias));
+    });
 }
 /**
  * Check whether any payment method is configured.
  */
 export function hasWalletConfigured() {
-    return getWallets().length > 0 || getCardConfig() !== null;
+    return getWallets().length > 0 || getCardConfig() !== null || getLinkConfig() !== null;
 }
 /**
  * Get address for a specific method, or the first configured one.
@@ -357,7 +482,7 @@ export function hasWalletConfigured() {
 export async function getWalletAddress(method) {
     let chain;
     let wallet;
-    if (method && method !== "card") {
+    if (method && method !== "card" && method !== "link") {
         const resolved = resolveWalletAndChain(method);
         wallet = resolved?.wallet;
         chain = resolved?.chain;

package/dist/core/principal.js

@@ -106,7 +106,7 @@ export async function getBaseRebatePrincipal() {
     return (await principalForChain("base")) ?? principalForChain("tempo");
 }
 export async function getConsumerPrincipalForMethod(method) {
-    if (!method || method === "card") {
+    if (!method || method === "card" || method === "link") {
         return getConsumerPrincipal();
     }
     const resolved = resolveWalletAndChain(method);
@@ -129,7 +129,7 @@ export async function ensureConsumerPrincipalForMethod(method) {
     const existing = await getConsumerPrincipalForMethod(method);
     if (existing)
         return existing;
-    if (method && method !== "card") {
+    if (method && method !== "card" && method !== "link") {
         throw new Error(`Could not derive a consumer principal for payment method "${method}". ` +
             "Check wallet_status and confirm that chain is configured for the active wallet.");
     }

package/dist/core/version.d.ts

@@ -1 +1 @@
-export declare const MCP_PACKAGE_VERSION = "0.1.44";
+export declare const MCP_PACKAGE_VERSION = "0.1.47";

package/dist/core/version.js

@@ -1 +1 @@
-export const MCP_PACKAGE_VERSION = "0.1.44";
+export const MCP_PACKAGE_VERSION = "0.1.47";

package/dist/index.js

@@ -44,11 +44,12 @@ export async function startMcpServer() {
             "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-only right now):",
-            "- Supported rails: Tempo USDC, Base USDC, Solana USDC. Card is temporarily disabled pending Stripe SPT approval.",
+            "PAYMENT:",
+            "- Supported rails: Tempo USDC, Base USDC, Solana USDC, and local Link SPT via @stripe/link-cli.",
+            "- 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.",
+            "  (tempo | base | solana | link | 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.",
@@ -63,7 +64,8 @@ export async function startMcpServer() {
             "",
             "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 }.",
+            "- To set up payments: wallet_setup({ action: \"start\" }). Link card/bank is recommended for most users.",
+            "- To create or import a crypto wallet directly: 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/dist/tools/__tests__/search.test.d.ts

@@ -0,0 +1 @@
+export {};

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

@@ -0,0 +1,66 @@
+import { beforeEach, describe, expect, it, vi } from "vitest";
+const mockApiGet = vi.fn();
+const mockGetAcceptedPaymentMethods = vi.fn();
+const mockIsFavorite = vi.fn();
+vi.mock("../../core/api-client.js", () => ({
+    apiGet: mockApiGet,
+}));
+vi.mock("../../core/payments.js", () => ({
+    getAcceptedPaymentMethods: mockGetAcceptedPaymentMethods,
+}));
+vi.mock("../../core/config.js", () => ({
+    isFavorite: mockIsFavorite,
+}));
+function flattenToolText(result) {
+    const content = result?.content ?? [];
+    return content
+        .filter((item) => item?.type === "text")
+        .map((item) => item.text ?? "")
+        .join("\n\n");
+}
+function makeServerHarness() {
+    const handlers = new Map();
+    return {
+        handlers,
+        server: {
+            tool(name, _description, _schema, handler) {
+                handlers.set(name, handler);
+            },
+        },
+    };
+}
+describe("search_agents MCP tool", () => {
+    beforeEach(() => {
+        vi.resetModules();
+        vi.clearAllMocks();
+        mockGetAcceptedPaymentMethods.mockReturnValue([]);
+        mockIsFavorite.mockReturnValue(false);
+    });
+    it("sorts popularity by live completed job stats after API enrichment", async () => {
+        mockApiGet.mockResolvedValueOnce([
+            {
+                id: "agent-low",
+                name: "Low History",
+                slug: "low-history",
+                pricePerRunUsd: "0.100000",
+                stats: { completedJobs: 2, avgRating: null, ratingCount: 0 },
+            },
+            {
+                id: "agent-high",
+                name: "High History",
+                slug: "high-history",
+                pricePerRunUsd: "0.100000",
+                stats: { completedJobs: 6, avgRating: null, ratingCount: 0 },
+            },
+        ]);
+        const { registerSearchTools } = await import("../search.js");
+        const harness = makeServerHarness();
+        registerSearchTools(harness.server);
+        const search = harness.handlers.get("search_agents");
+        expect(search).toBeDefined();
+        const result = await search({ query: "stock research", limit: 2, sort: "popularity" });
+        const output = flattenToolText(result);
+        expect(output.indexOf("High History")).toBeLessThan(output.indexOf("Low History"));
+        expect(output).toContain("High History (high-history) ☆☆☆☆☆ 6 jobs");
+    });
+});

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

@@ -3,8 +3,11 @@ const state = vi.hoisted(() => ({
     wallets: [],
     addedWallets: [],
     card: null,
+    link: null,
+    pendingLinkSetup: null,
     pendingCardSetupToken: null,
     spendPolicies: {},
+    defaultPaymentMethod: undefined,
     consumerPrincipal: "did:pkh:eip155:8453:0xabc",
     owsAvailable: true,
     owsWallets: [],
@@ -30,6 +33,12 @@ const state = vi.hoisted(() => ({
     pollCardSetupCalls: [],
     pollCardSetupResult: null,
     setCardConfigCalls: [],
+    setLinkConfigCalls: [],
+    setPendingLinkSetupCalls: [],
+    linkAuthenticated: false,
+    linkPaymentMethods: [],
+    linkLoginCalls: 0,
+    linkPaymentMethodAddCalls: 0,
 }));
 vi.mock("../../core/config.js", () => ({
     addWallet: (wallet) => {
@@ -43,6 +52,8 @@ vi.mock("../../core/config.js", () => ({
         }
     },
     getCardConfig: () => state.card,
+    getLinkConfig: () => state.link,
+    getPendingLinkSetup: () => state.pendingLinkSetup,
     getPendingCardSetupToken: () => state.pendingCardSetupToken,
     getSpendPolicy: (walletId) => state.spendPolicies[walletId] ?? null,
     getWallets: () => state.wallets,
@@ -50,6 +61,17 @@ vi.mock("../../core/config.js", () => ({
         state.card = card;
         state.setCardConfigCalls.push(card);
     },
+    setDefaultPaymentMethod: (method) => {
+        state.defaultPaymentMethod = method;
+    },
+    setLinkConfig: (link) => {
+        state.link = link;
+        state.setLinkConfigCalls.push(link);
+    },
+    setPendingLinkSetup: (pending) => {
+        state.pendingLinkSetup = pending;
+        state.setPendingLinkSetupCalls.push(pending);
+    },
     setSpendPolicy: (walletId, policy) => {
         state.spendPolicies[walletId] = policy;
     },
@@ -69,6 +91,22 @@ vi.mock("../../core/card-setup.js", () => ({
         return state.pollCardSetupResult;
     },
 }));
+vi.mock("../../core/link-cli.js", () => ({
+    getLinkCliAuthStatus: async () => ({
+        authenticated: state.linkAuthenticated,
+    }),
+    listLinkPaymentMethods: async () => state.linkPaymentMethods,
+    openLinkPaymentMethodAdd: async () => {
+        state.linkPaymentMethodAddCalls++;
+    },
+    startLinkCliLogin: async () => {
+        state.linkLoginCalls++;
+        return {
+            verificationUrl: "https://app.link.com/device/setup?code=test-link-code",
+            phrase: "test-link-code",
+        };
+    },
+}));
 vi.mock("../../core/ows-adapter.js", () => ({
     createOwsWallet: async (name, chain) => {
         state.createdWalletCalls.push({ name, chain });
@@ -90,8 +128,11 @@ function resetState() {
     state.wallets = [];
     state.addedWallets = [];
     state.card = null;
+    state.link = null;
+    state.pendingLinkSetup = null;
     state.pendingCardSetupToken = null;
     state.spendPolicies = {};
+    state.defaultPaymentMethod = undefined;
     state.consumerPrincipal = "did:pkh:eip155:8453:0xabc";
     state.owsAvailable = true;
     state.owsWallets = [];
@@ -117,6 +158,12 @@ function resetState() {
     state.pollCardSetupCalls = [];
     state.pollCardSetupResult = null;
     state.setCardConfigCalls = [];
+    state.setLinkConfigCalls = [];
+    state.setPendingLinkSetupCalls = [];
+    state.linkAuthenticated = false;
+    state.linkPaymentMethods = [];
+    state.linkLoginCalls = 0;
+    state.linkPaymentMethodAddCalls = 0;
 }
 async function getWalletSetupTool() {
     const tools = new Map();
@@ -158,11 +205,40 @@ describe("wallet_setup tool", () => {
                 label: "launch-wallet",
             },
         ]);
+        expect(state.defaultPaymentMethod).toBe("base");
         expect(text).toContain("Wallet created [encrypted]:");
         expect(text).toContain("Address: 0x1111111111111111111111111111111111111111");
         expect(text).toContain("Chains: tempo, base");
         expect(text).toContain("Consumer principal: did:pkh:eip155:8453:0xabc");
     });
+    it("shows a guided payment setup menu", async () => {
+        const walletSetup = await getWalletSetupTool();
+        const result = await walletSetup({ action: "start" });
+        const text = flattenText(result);
+        expect(text).toContain("Set up a payment method:");
+        expect(text).toContain("Link card/bank (recommended)");
+        expect(text).toContain('wallet_setup({ action: "add-link" })');
+        expect(text).toContain('wallet_setup({ action: "create", chain: "tempo" })');
+        expect(text).toContain('wallet_setup({ action: "create", chain: "base" })');
+        expect(text).toContain('wallet_setup({ action: "create", chain: "solana" })');
+    });
+    it("shows the setup menu when no payment methods are configured", async () => {
+        const tools = new Map();
+        const server = {
+            tool: (name, _description, _schema, handler) => {
+                tools.set(name, handler);
+            },
+        };
+        const { registerWalletTools } = await import("../wallet.js");
+        registerWalletTools(server);
+        const walletStatus = tools.get("wallet_status");
+        if (!walletStatus)
+            throw new Error("wallet_status tool was not registered");
+        const result = await walletStatus({});
+        const text = flattenText(result);
+        expect(text).toContain("No payment methods configured.");
+        expect(text).toContain("Link card/bank (recommended)");
+    });
     it("imports a wallet into OWS encrypted storage with Base as the default chain", async () => {
         const walletSetup = await getWalletSetupTool();
         const result = await walletSetup({
@@ -185,6 +261,7 @@ describe("wallet_setup tool", () => {
                 label: "imported-wallet",
             },
         ]);
+        expect(state.defaultPaymentMethod).toBe("base");
         expect(text).toContain("Key imported to OWS [encrypted]:");
         expect(text).toContain("Address: 0x2222222222222222222222222222222222222222");
         expect(text).toContain("Consumer principal: did:pkh:eip155:8453:0xabc");
@@ -228,4 +305,80 @@ describe("wallet_setup tool", () => {
         expect(text).toContain("Removed Visa ****4242.");
         expect(text).toContain("Card disconnected from Agent Wonderland.");
     });
+    it("starts Link device auth from wallet_setup", async () => {
+        const walletSetup = await getWalletSetupTool();
+        const result = await walletSetup({ action: "add-link" });
+        const text = flattenText(result);
+        expect(state.linkLoginCalls).toBe(1);
+        expect(state.setPendingLinkSetupCalls[0]).toMatchObject({
+            verificationUrl: "https://app.link.com/device/setup?code=test-link-code",
+            phrase: "test-link-code",
+        });
+        expect(text).toContain("Approve Agent Wonderland in Link:");
+        expect(text).toContain("https://app.link.com/device/setup?code=test-link-code");
+        expect(text).toContain("Verification phrase: test-link-code");
+    });
+    it("continues a pending Link auth without starting a new login", async () => {
+        state.pendingLinkSetup = {
+            verificationUrl: "https://app.link.com/device/setup?code=existing",
+            phrase: "existing",
+            createdAt: new Date().toISOString(),
+        };
+        const walletSetup = await getWalletSetupTool();
+        const result = await walletSetup({ action: "add-link" });
+        const text = flattenText(result);
+        expect(state.linkLoginCalls).toBe(0);
+        expect(text).toContain("https://app.link.com/device/setup?code=existing");
+        expect(text).toContain("Verification phrase: existing");
+    });
+    it("connects the only Link payment method after auth", async () => {
+        state.linkAuthenticated = true;
+        state.pendingLinkSetup = {
+            verificationUrl: "https://app.link.com/device/setup?code=existing",
+            phrase: "existing",
+            createdAt: new Date().toISOString(),
+        };
+        state.linkPaymentMethods = [
+            { id: "csmrpd_123", label: "Barclays Mastercard ****3688" },
+        ];
+        const walletSetup = await getWalletSetupTool();
+        const result = await walletSetup({ action: "add-link" });
+        const text = flattenText(result);
+        expect(state.setPendingLinkSetupCalls).toEqual([null]);
+        expect(state.setLinkConfigCalls).toEqual([
+            { paymentMethodId: "csmrpd_123", label: "Barclays Mastercard ****3688" },
+        ]);
+        expect(text).toContain("Link payment method connected.");
+        expect(text).toContain("Barclays Mastercard ****3688");
+    });
+    it("shows friendly names when multiple Link payment methods exist", async () => {
+        state.linkAuthenticated = true;
+        state.linkPaymentMethods = [
+            { id: "csmrpd_1", label: "Barclays Arrival Mastercard ****3688" },
+            { id: "csmrpd_2", label: "Total Checking bank ****2889" },
+        ];
+        const walletSetup = await getWalletSetupTool();
+        const result = await walletSetup({ action: "add-link" });
+        const text = flattenText(result);
+        expect(text).toContain("Barclays Arrival Mastercard ****3688 (csmrpd_1)");
+        expect(text).toContain("Total Checking bank ****2889 (csmrpd_2)");
+        expect(text).toContain('link_payment_method: "<name or last4>"');
+    });
+    it("resolves a friendly Link payment method selector", async () => {
+        state.linkAuthenticated = true;
+        state.linkPaymentMethods = [
+            { id: "csmrpd_1", label: "Barclays Arrival Mastercard ****3688", searchText: "csmrpd_1 barclays arrival mastercard 3688" },
+            { id: "csmrpd_2", label: "Total Checking bank ****2889", searchText: "csmrpd_2 total checking bank 2889" },
+        ];
+        const walletSetup = await getWalletSetupTool();
+        const result = await walletSetup({
+            action: "add-link",
+            link_payment_method: "3688",
+        });
+        const text = flattenText(result);
+        expect(state.setLinkConfigCalls).toEqual([
+            { paymentMethodId: "csmrpd_1", label: "Barclays Arrival Mastercard ****3688" },
+        ]);
+        expect(text).toContain("Barclays Arrival Mastercard ****3688 (csmrpd_1)");
+    });
 });

package/dist/tools/passes.js

@@ -35,7 +35,7 @@ export function registerPassTools(server) {
     server.tool("buy_agent_credit_pack", "Purchase a discounted prepaid credit pack for an agent. Credit packs are agent-specific and automatically cover future runs until the included units run out.", {
         agent_id: z.string().describe("Agent ID (UUID, slug, or name)"),
         pack_id: z.string().optional().describe("Specific pack key to buy, like 'starter' or 'growth'. If omitted and only one pack exists, it is selected automatically."),
-        pay_with: z.string().optional().describe("Payment method — wallet ID, chain name, or 'card'. Auto-detected if omitted."),
+        pay_with: z.string().optional().describe("Payment method — wallet ID, chain name, 'link', or 'card'. Auto-detected if omitted."),
         confirmed: z.boolean().optional().describe("Set to true to confirm the purchase after seeing the quote."),
     }, async ({ agent_id, pack_id, pay_with, confirmed }) => {
         if (!hasWalletConfigured()) {

package/dist/tools/run.js

@@ -88,7 +88,7 @@ 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.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."),
+        pay_with: z.string().trim().min(1).optional().describe("Payment method — wallet ID, chain name (tempo, base, solana), 'link', 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 }) => {
         if (!hasWalletConfigured()) {

package/dist/tools/search.js

@@ -6,6 +6,23 @@ import { agentLine } from "../core/formatters.js";
 function text(t) {
     return { content: [{ type: "text", text: t }] };
 }
+function completedJobs(agent) {
+    const stats = agent.stats;
+    return stats?.completedJobs ?? agent.totalExecutions ?? 0;
+}
+function averageRating(agent) {
+    const stats = agent.stats;
+    return agent.avgRating ?? stats?.avgRating ?? 0;
+}
+function ratingCount(agent) {
+    const stats = agent.stats;
+    const topLevel = typeof agent.ratingCount === "number" ? agent.ratingCount : undefined;
+    return topLevel ?? stats?.ratingCount ?? 0;
+}
+function price(agent) {
+    const parsed = Number.parseFloat(agent.pricePerRunUsd ?? "0");
+    return Number.isFinite(parsed) ? parsed : 0;
+}
 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)"),
@@ -61,6 +78,22 @@ export function registerSearchTools(server) {
                 return typeof avg === "number" && avg >= min_rating;
             });
         }
+        // The API enriches list rows with live stats after registry search. Do a
+        // final local sort for stat-based MCP views so displayed jobs/ratings and
+        // result order cannot disagree while registry aggregates catch up.
+        if (sort === "popularity") {
+            agents = [...agents].sort((a, b) => completedJobs(b) - completedJobs(a) ||
+                ratingCount(b) - ratingCount(a) ||
+                averageRating(b) - averageRating(a));
+        }
+        else if (sort === "rating") {
+            agents = [...agents].sort((a, b) => averageRating(b) - averageRating(a) ||
+                ratingCount(b) - ratingCount(a) ||
+                completedJobs(b) - completedJobs(a));
+        }
+        else if (sort === "price") {
+            agents = [...agents].sort((a, b) => price(a) - price(b));
+        }
         // Trim to requested limit after filtering
         agents = agents.slice(0, requestedLimit);
         if (agents.length === 0) {