agent402-mcp 0.10.1 → 0.11.1

package/README.md

@@ -1,6 +1,6 @@
 # agent402-mcp
 
-MCP server for [Agent402](https://agent402.tools) — **1,338 pay-per-call web tools** and **42 curated multi-tool skill packs** for AI agents, paid per call in USDC via the [x402 protocol](https://www.x402.org), or **with compute (proof-of-work)** when no wallet is configured. Built by [Mike Petrillo](https://github.com/MikeyPetrillo).
+MCP server for [Agent402](https://agent402.tools) — **1,346 pay-per-call web tools** and **42 curated multi-tool skill packs** for AI agents, paid per call in USDC via the [x402 protocol](https://www.x402.org), or **with compute (proof-of-work)** when no wallet is configured. Built by [Mike Petrillo](https://github.com/MikeyPetrillo).
 
 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 ~1,000 utility/conversion tools — plus 42 **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.
 
@@ -25,7 +25,7 @@ With a funded wallet (USDC on Base, Solana, Polygon, or Arbitrum) — every tool
 }
 ```
 
-Without a wallet — the ~1,100 pure-CPU tools work free via proof-of-work (the network/browser/memory tools will ask for a wallet):
+Without a wallet — the ~1,156 pure-CPU tools work free via proof-of-work (the network/browser/memory tools will ask for a wallet):
 
 ```json
 {
@@ -41,7 +41,7 @@ Claude Code: `claude mcp add agent402 -- npx -y agent402-mcp`
 
 - On startup the server reads the live catalog from `https://agent402.tools/api/pricing` + `/openapi.json`.
 - The high-value tools (`extract`, `render`, `screenshot`, `pdf`, `meta`, `dns`, `http-check`, `tls-cert`, `whois`, the `memory-*` coordination tools, `hash`) are exposed as first-class MCP tools.
-- The other ~1,325 tools are reachable via `search_tools` (find by description) + `call_tool` (call by slug) — keeping your context window small.
+- The rest of the ~1,346-tool catalog is reachable via `search_tools` (find by description) + `call_tool` (call by slug) — keeping your context window small.
 - When a call hits HTTP 402: with a wallet key set (`AGENT_KEY` for Base/Polygon/Arbitrum, `SOLANA_AGENT_KEY` for Solana), the server signs an x402 USDC payment on a chain the seller accepts and retries; without a key it solves the tool's proof-of-work challenge (~0.2 s of CPU) on the eligible tools.
 - `payment_info` tells the model which mode it's in and what a wallet would unlock.
 - `top_x402_sellers` returns the live x402 leaderboard — which sellers are settling the most USDC (primarily on Base) in the last ~24h, derived from on-chain transfers. Free to call (no payment, no proof-of-work). Useful for agents discovering the wider x402 economy beyond this single service's catalog.
@@ -70,6 +70,7 @@ automatically:
 | `AGENT402_TOOLS` | curated set | Comma-separated slugs to expose as first-class tools. |
 | `AGENT402_MAX_PER_CALL` | unlimited | Refuse any single call priced above this many USD (e.g. `0.01`). |
 | `AGENT402_BUDGET` | unlimited | Hard cap on total USDC spent per session (e.g. `1.00`). |
+| `AGENT402_NETWORKS` | _(unset)_ | Restrict + order the chains to pay on — e.g. `robinhood` (USDG on Robinhood Chain), `base,solana`, or a raw CAIP-2 like `eip155:4663`. Unset = the client picks (effectively Base on multi-chain sellers). |
 
 Spend controls are enforced **before a payment is signed** — a runaway model is
 refused, not billed. `payment_info` reports the caps, what's been spent, and

package/index.js

@@ -18,7 +18,10 @@
 //   AGENT402_TOOLS        comma-separated slugs to expose first-class (overrides default)
 //   AGENT402_MAX_PER_CALL refuse any single call priced above this many USD (e.g. 0.01)
 //   AGENT402_BUDGET       hard cap on total USDC spent this session (e.g. 1.00)
+//   AGENT402_NETWORKS     restrict + order the chains to pay on (e.g. "robinhood" for USDG on
+//                         Robinhood Chain, "base,solana", or a raw CAIP-2 like eip155:4663) — optional
 import { createHash } from "node:crypto";
+import { parseNetworkPrefs, withNetworkPreference } from "./networks.js";
 import { Server } from "@modelcontextprotocol/sdk/server/index.js";
 import { StdioServerTransport } from "@modelcontextprotocol/sdk/server/stdio.js";
 import {
@@ -35,7 +38,7 @@ const AGENT_KEY = process.env.AGENT_KEY || "";
 // settle on whichever chain the seller offers (EVM accepts are tried first).
 const SOLANA_AGENT_KEY = process.env.SOLANA_AGENT_KEY || "";
 const HAS_WALLET = Boolean(AGENT_KEY || SOLANA_AGENT_KEY);
-const VERSION = "0.10.0";
+const VERSION = "0.11.1";
 
 // Spend controls — enforced BEFORE a payment is ever signed, so a confused or
 // runaway model cannot drain the wallet. Unset = unlimited (back-compat).
@@ -123,6 +126,12 @@ function getPayFetch() {
       const { registerExactSvmScheme } = await import("@x402/svm/exact/client");
       registerExactSvmScheme(client, { signer: await solanaSigner() });
     }
+    // AGENT402_NETWORKS restricts + orders which chains this buyer will pay
+    // on (e.g. "robinhood" settles USDG on chain 4663; the accept carries the
+    // asset + EIP-712 domain, so the EVM signer needs no special handling).
+    // Without it the client effectively always picks Base on multi-chain
+    // sellers, leaving non-default rails unreachable.
+    withNetworkPreference(client, parseNetworkPrefs(process.env.AGENT402_NETWORKS));
     return wrapFetchWithPayment(fetch, client);
   })();
   return payFetchPromise;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "agent402-mcp",
-  "version": "0.10.1",
+  "version": "0.11.1",
   "mcpName": "io.github.MikeyPetrillo/agent402",
   "author": "Mike Petrillo <mike@agent402.tools> (https://github.com/MikeyPetrillo)",
   "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' 1,338 self-hostable tools + 42 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, TTS, 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 via the x402 protocol.",
+  "description": "Open-source MCP server exposing Agent402.Tools' 1,346 self-hostable tools + 42 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, TTS, 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 via the x402 protocol.",
   "type": "module",
   "bin": {
     "agent402-mcp": "index.js"