agent402-mcp 0.12.6 → 0.12.8

package/index.js

@@ -492,13 +492,14 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
       title: "List top x402 sellers",
       annotations: { title: "List top x402 sellers", ...SAFE },
       description:
-        "List the x402 sellers earning the most USDC (or serving the most calls) on Base in the last ~24h, derived from on-chain USDC transfers. Useful for agents discovering the live x402 economy: who's getting paid, which networks, and where to point demand. Free to call (no payment, no proof-of-work). Defaults: top 10, sort by USDC, exclude this service's own wallet.",
+        "List ranked sellers from the on-chain leaderboards. wire=x402 (default): x402 sellers earning the most USDC (or serving the most calls) on Base in the last ~24h, derived from on-chain USDC transfers. wire=mpp: MPP (Machine Payments Protocol) sellers ranked by inbound USDC.e transfers on Tempo to the recipient their live 402 names (window, rolling 7d/30d, distinct payers, volume; routable = the host's router will pay them). Useful for agents discovering the live x402 / MPP economy: who's getting paid, which networks, and where to point demand. Free to call (no payment, no proof-of-work). Defaults: top 10, sort by USDC, exclude this service's own wallet.",
       inputSchema: {
         type: "object",
         properties: {
           limit: { type: "number", description: "Max rows to return (default 10, max 50)" },
-          sort: { type: "string", enum: ["usd", "calls"], description: "Rank by USDC settled (default) or by call count" },
+          sort: { type: "string", enum: ["usd", "calls"], description: "Rank by USDC settled (default) or by call count (mpp: 7-day volume / 7-day transfers, default calls)" },
           include: { type: "string", enum: ["external", "all"], description: "'external' (default) hides this service's own wallet; 'all' includes it" },
+          wire: { type: "string", enum: ["x402", "mpp"], description: "Which leaderboard: x402 (default) or mpp" },
         },
       },
       outputSchema: META_OUTPUT_SCHEMAS["sellers.list"],
@@ -617,7 +618,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
           maintainer: "Havok Holdings LLC",
         },
         positioning: "Deterministic tools layer beside LLM gateways: flagship search/answer first, 500+ long-tail tools via catalog.find / catalog.search / catalog.call.",
-        ecosystem: "Call sellers.list to see which x402 sellers (any wallet, not just this host) are settling the most USDC (primarily on Base) in the last 24h - discovers the live economy beyond this catalog.",
+        ecosystem: "Call sellers.list to see which x402 sellers (any wallet, not just this host) are settling the most USDC (primarily on Base) in the last 24h, or sellers.list with wire=mpp for MPP sellers ranked by on-chain USDC.e transfers on Tempo - discovers the live economy beyond this catalog.",
       });
     }
     if (name === "server.describe") {
@@ -641,6 +642,47 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         docs: `${BASE}/llms.txt`,
       });
     }
+    if (name === "sellers.list" && args.wire === "mpp") {
+      // Thin pass-through to /api/mpp-leaderboard (free, unpaywalled), same
+      // compact row shape as the hosted connector's wire=mpp branch.
+      const limit = Math.min(Math.max(parseInt(args.limit, 10) || 10, 1), 50);
+      const sort = args.sort === "usd" ? "usd" : "calls";
+      const include = args.include === "all" ? "all" : "external";
+      const res = await fetch(`${BASE}/api/mpp-leaderboard`);
+      if (!res.ok) {
+        return { content: [{ type: "text", text: `Failed to fetch the MPP leaderboard from ${BASE}: HTTP ${res.status}` }], isError: true };
+      }
+      const lb = await res.json();
+      let board = (Array.isArray(lb.rows) ? lb.rows : []).filter((r) => r.transfers > 0 || (r.d30?.transfers || 0) > 0);
+      if (include === "external") board = board.filter((r) => !r.self);
+      board = board.slice().sort((a, b) => sort === "usd"
+        ? ((b.d7?.volumeUsdc || 0) - (a.d7?.volumeUsdc || 0)) || (b.transfers - a.transfers)
+        : ((b.d7?.transfers || 0) - (a.d7?.transfers || 0)) || (b.transfers - a.transfers)).slice(0, limit);
+      const rows = board.map((r, i) => ({
+        rank: i + 1,
+        name: r.self ? "this host" : (r.sellers || []).map((s) => s.name).join(", ") || "unnamed recipient",
+        network: "eip155:4217",
+        wallet: r.recipient,
+        homepage: r.sellers?.[0]?.url || null,
+        transfersWindow: r.transfers,
+        transfers7d: r.d7?.transfers || 0,
+        transfers30d: r.d30?.transfers || 0,
+        payersWindow: r.payers,
+        volumeUsdc7d: Math.round((r.d7?.volumeUsdc || 0) * 10000) / 10000,
+        routable: !!r.routable,
+      }));
+      return mcpJsonResult({
+        wire: "mpp",
+        measure: "inbound USDC.e transfers on Tempo (chain 4217) to the recipient each seller's live MPP challenge names - a window read plus rolling 7d/30d, a proxy for settlements, not lifetime",
+        window: lb.window ? `~${lb.window.approxHours}h (${lb.window.blocks} blocks)` : null,
+        asOf: lb.generatedAt || null,
+        sort, include,
+        totalSellers: Array.isArray(lb.rows) ? lb.rows.length : 0,
+        results: rows,
+        ...(lb.stale ? { note: "Leaderboard is stale or still warming - retry in a few minutes." } : {}),
+        source: `${BASE}/api/mpp-leaderboard`,
+      });
+    }
     if (name === "sellers.list") {
       const limit = Math.min(Math.max(parseInt(args.limit, 10) || 10, 1), 50);
       const sort = args.sort === "calls" ? "calls" : "usd";

package/output-schemas.js

@@ -251,7 +251,9 @@ export const META_OUTPUT_SCHEMAS = {
   "sellers.list": {
     type: "object",
     properties: {
-      window: { type: "string" },
+      wire: { type: "string", enum: ["x402", "mpp"] },
+      measure: { type: "string" },
+      window: { type: ["string", "null"] },
       asOf: { description: "Snapshot timestamp" },
       sort: { type: "string", enum: ["usd", "calls"] },
       include: { type: "string", enum: ["external", "all"] },

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent402-mcp",
-  "version": "0.12.6",
+  "version": "0.12.8",
   "mcpName": "io.github.MikeyPetrillo/agent402",
   "author": "Havok Holdings LLC <mike@agent402.tools> (https://agent402.tools)",
   "homepage": "https://agent402.tools",
@@ -8,7 +8,7 @@
     "type": "git",
     "url": "git+https://github.com/MikeyPetrillo/Agent402.git"
   },
-  "description": "Open-source MCP server exposing Agent402.Tools' catalog - 500+ strong: 400+ self-hostable tools + 100+ multi-tool skill packs (security-audit, trend-analysis, structured-scrape, decode-blob, forecasting-bake-off) for AI agents - browser, web search & answers, PDFs, OCR, images, LLM inference, image generation, code execution, STT, embeddings, live financial/crypto/macro data, SEC EDGAR filings, deterministic stats & forecasting, compression, payments. Free via proof-of-work, or pay per call in USDC on Base, Solana, Polygon, Arbitrum, Monad, Celo, Avalanche, Sei, Optimism, Stellar & Algorand - plus USDG on Robinhood Chain (12 chains total) - via the x402 protocol. The hosted API also accepts MPP (Machine Payments Protocol) clients on the same 402: USDC on Base/Celo or PathUSD natively on Tempo.",
+  "description": "Agentic Finance (AIFI) MCP server: open-source MCP server exposing Agent402.Tools' catalog - 500+ strong: 400+ self-hostable tools + 100+ multi-tool skill packs (security-audit, trend-analysis, structured-scrape, decode-blob, forecasting-bake-off) for AI agents - browser, web search & answers, PDFs, OCR, images, LLM inference, image generation, code execution, STT, embeddings, live financial/crypto/macro data, SEC EDGAR filings, deterministic stats & forecasting, compression, payments. Free via proof-of-work, or pay per call in USDC on Base, Solana, Polygon, Arbitrum, Monad, Celo, Avalanche, Sei, Optimism, Stellar & Algorand - plus USDG on Robinhood Chain (12 chains total) - via the x402 protocol. The hosted API also accepts MPP (Machine Payments Protocol) clients on the same 402: USDC on Base/Celo or PathUSD natively on Tempo.",
   "type": "module",
   "bin": {
     "agent402-mcp": "index.js"
@@ -59,7 +59,12 @@
     "optimism",
     "stellar",
     "algorand",
-    "robinhood-chain"
+    "robinhood-chain",
+    "agentic-finance",
+    "aifi",
+    "agentic-payments",
+    "mpp",
+    "machine-payments-protocol"
   ],
   "license": "MIT",
   "dependencies": {