agent402-mcp 0.12.7 → 0.12.9

package/README.md

@@ -1,6 +1,6 @@
 # agent402-mcp
 
-MCP server for [Agent402](https://agent402.tools) - a catalog of **500+: 400+ pay-per-call web tools + 100+ curated multi-tool skill packs** for AI agents (every one tested, priced, and settled on-chain; every one earns its place), paid per call in USDC via the [x402 protocol](https://www.x402.org), or **with compute (proof-of-work)** when no wallet is configured. (The hosted API is dual-stack: it also accepts [MPP](https://agent402.tools/what-is-mpp) clients on the same 402, settling on Base/Celo or natively on Tempo; this package pays via x402.) Built by [Havok Holdings LLC](https://github.com/MikeyPetrillo/Agent402).
+MCP server for [Agent402](https://agent402.tools), the applied layer of [Agentic Finance (AIFI)](https://agent402.tools/agentic-finance) - a catalog of **500+: 400+ pay-per-call web tools + 100+ curated multi-tool skill packs** for AI agents (every one tested, priced, and settled on-chain; every one earns its place), paid per call in USDC via the [x402 protocol](https://www.x402.org), or **with compute (proof-of-work)** when no wallet is configured. (The hosted API is dual-stack: it also accepts [MPP](https://agent402.tools/what-is-mpp) clients on the same 402, settling on Base/Celo or natively on Tempo; this package pays via x402.) Built by [Havok Holdings LLC](https://github.com/MikeyPetrillo/Agent402).
 
 Your agent gets browser rendering, screenshots, PDF text extraction, URL→markdown, live web search **+ web answers with citations**, live **financial/crypto/macro data** (Yahoo stock quotes, CoinGecko, FRED, ECB FX, World Bank, yield curve), **SEC EDGAR filings** (10-K/10-Q text, XBRL, insider, 13F, IPO calendar), **deterministic stats & forecasting** (Pearson correlation, OLS, Holt-Winters), **compression** (gzip/brotli), DNS/TLS/WHOIS + email-deliverability checks, wallet-keyed shared memory, and 200+ deterministic pure-CPU utilities - plus 100+ **skill packs** like `security-audit`, `trend-analysis`, `structured-scrape`, `decode-blob`, and `forecasting-bake-off` callable as MCP prompts. Payment handled invisibly underneath the MCP calls. No signup, no API key.
 

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"],
@@ -616,8 +617,8 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
           npm: "npx -y agent402-mcp",
           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.",
+        positioning: `Deterministic tools layer beside LLM gateways: flagship search/answer first, 500+ long-tail tools via catalog.find / catalog.search / catalog.call. Agent402 is the applied layer of Agentic Finance (AIFI): agents that pay and get paid per request over x402 or MPP (Machine Payments Protocol), both on the same 402 - ${BASE}/agentic-finance, ${BASE}/glossary.`,
+        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") {
@@ -625,6 +626,7 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         service: BASE,
         connector: "stdio npm package (agent402-mcp)",
         maintainer: "Havok Holdings LLC",
+        positioning: `Agent402 is the applied layer of Agentic Finance (AIFI): software agents that pay and get paid on their own, per request, over x402 or MPP (Machine Payments Protocol) - both answered on the same 402. ${BASE}/agentic-finance, ${BASE}/glossary.`,
         startHere: {
           firstJob: "Search the web and answer questions. Call web.search or web.answer directly, or catalog.find with your task.",
           mode: HAS_WALLET ? "usdc" : "proof-of-work",
@@ -641,6 +643,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

@@ -99,7 +99,7 @@ export const FLAGSHIP_WRITERS = new Set(["memory-write"]);
 
 /** initialize.serverInfo description (MCP Implementation.description). */
 export const MCP_SERVER_DESCRIPTION =
-  "Deterministic pay-per-call tools for AI agents: live web search and cited answers, news, browser render, market data, speech-to-text, wallet-keyed memory, plus 500+ long-tail tools via catalog.find. Settle in USDC via x402 or free via proof-of-work. Maintained by Havok Holdings LLC.";
+  "Agentic Finance (AIFI) applied layer - deterministic pay-per-call tools for AI agents: live web search and cited answers, news, browser render, market data, speech-to-text, wallet-keyed memory, plus 500+ long-tail tools via catalog.find. Settle in USDC via x402 or MPP (Machine Payments Protocol) on the same 402, or free via proof-of-work. Maintained by Havok Holdings LLC.";
 
 /** initialize.serverInfo.websiteUrl */
 export const MCP_SERVER_WEBSITE = "https://agent402.tools";
@@ -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"] },
@@ -505,7 +507,7 @@ export function mcpInitializeInstructions(baseUrl) {
   const install = mcpInstallHints(baseUrl);
   const hosted = install.hostedUrl;
   return [
-    "Agent402 is a deterministic tools layer for AI agents (Havok Holdings LLC).",
+    "Agent402 is a deterministic tools layer for AI agents (Havok Holdings LLC) - the applied layer of Agentic Finance (AIFI): agents that pay and get paid per request over x402 or MPP, or free via proof-of-work.",
     "Front door: call web.search or web.answer for live web search and cited answers.",
     "Also listed: web.news, browser.render, market.quote, audio.transcribe, memory.read, memory.write.",
     "Long catalog (500+ tools): call catalog.find with your task, or catalog.search then catalog.call.",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent402-mcp",
-  "version": "0.12.7",
+  "version": "0.12.9",
   "mcpName": "io.github.MikeyPetrillo/agent402",
   "author": "Havok Holdings LLC <mike@agent402.tools> (https://agent402.tools)",
   "homepage": "https://agent402.tools",