agent402-mcp 0.11.3 → 0.11.5

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Havok Holdings LLC
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -1,8 +1,8 @@
 # agent402-mcp
 
-MCP server for [Agent402](https://agent402.tools) — **1,407 pay-per-call web tools** and **46 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) — 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. 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.
+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 216 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.
 
 ## Quick start
 
@@ -11,7 +11,7 @@ MCP server — e.g. claude.ai → Settings → Connectors → Add custom connect
 pure-CPU tools run free there (rate-limited); for the full catalog and no rate
 limit, run this package locally with a wallet:
 
-With a funded wallet (USDC on Base, Solana, Polygon, or Arbitrum) — every tool available:
+With a funded wallet (USDC on Base, Polygon, Arbitrum, Monad, or Solana — the underlying service also accepts Stellar and Algorand, but this package currently signs only EVM and Solana payments) — every tool available:
 
 ```json
 {
@@ -25,7 +25,7 @@ With a funded wallet (USDC on Base, Solana, Polygon, or Arbitrum) — every tool
 }
 ```
 
-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):
+Without a wallet — the 216 pure-CPU tools work free via proof-of-work (the network/browser/memory tools will ask for a wallet):
 
 ```json
 {
@@ -41,8 +41,8 @@ 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 rest of the ~1,407-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.
+- The rest of the 500-endpoint catalog (400 tools + 100 skill packs) 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 the EVM chains — Base/Polygon/Arbitrum/Monad, `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. (The service also settles USDC on Stellar and Algorand, and USDG on Robinhood Chain — 8 chains total — for callers using a raw x402 client rather than this package.)
 - `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.
 

package/index.js

@@ -38,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.11.2";
+const VERSION = "0.11.5";
 
 // Spend controls — enforced BEFORE a payment is ever signed, so a confused or
 // runaway model cannot drain the wallet. Unset = unlimited (back-compat).
@@ -51,6 +51,9 @@ const DEFAULT_CURATED = [
   // the tools agents can't replicate locally: live search, browser, PDF, shared memory
   "search", "extract", "render", "screenshot", "pdf", "meta", "dns", "http-check", "tls-cert", "whois",
   "memory-write", "memory-read", "memory-remember", "memory-recall",
+  // wallet management — balance + history, first-class so directories and
+  // agents see the capability by name (they execute here when AGENT_KEY is set)
+  "wallet-balances", "wallet-balance", "wallet-transactions",
   // one cheap pure-CPU tool so wallet-less clients see the proof-of-work path work
   "hash",
 ];
@@ -335,7 +338,9 @@ let pricingInfo = null;
 
 server.setRequestHandler(ListToolsRequestSchema, async () => {
   const tools = curated.map((t) => ({
-    name: t.slug,
+    // snake_case exposed name so the whole tools/list is one convention
+    // (meta-tools are snake_case; slugs are kebab). CallTool accepts both.
+    name: t.slug.replace(/-/g, "_"),
     description: `[${t.price}/call${t.computePayable ? ", or free via proof-of-work" : ", wallet required"}] ${t.description}`,
     inputSchema: t.inputSchema,
   }));
@@ -343,7 +348,7 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
     {
       name: "search_tools",
       description:
-        `Search the full Agent402 catalog (${catalog.size} pay-per-call tools: encoding, crypto, data conversion, text, time, validation, math, unit conversions, network, browser, memory). Returns matching tools with price, payment options, and input schema — call them with call_tool. Also returns matching multi-tool workflow templates (skill packs) when the query is task-shaped; fetch the whole template via prompts/get { name: "<slug>", arguments: { … } }.`,
+        `Search the full Agent402 catalog (${catalog.size} pay-per-call tools: live market data like stock-quote at $0.003, encoding, crypto, data conversion, text, time, validation, math, unit conversions, network, browser, memory). Many pure-CPU tools are free via proof-of-work — no wallet needed. There is also an OpenAI-compatible LLM gateway at ${BASE}/v1, flat per-call (chat nano $0.003, auto $0.01, embeddings $0.002) with no API key — a funded wallet is the account; its tiers are callable here via call_tool (slugs v1-chat-nano, v1-chat-auto, v1-embeddings) when a wallet key is set. Returns matching tools with price, payment options, and input schema — call them with call_tool. Also returns matching multi-tool workflow templates (skill packs) when the query is task-shaped; fetch the whole template via prompts/get { name: "<slug>", arguments: { … } }.`,
       inputSchema: {
         type: "object",
         properties: {
@@ -356,11 +361,11 @@ server.setRequestHandler(ListToolsRequestSchema, async () => {
     {
       name: "call_tool",
       description:
-        "Call any Agent402 tool by slug (find slugs and input schemas with search_tools). Payment is handled automatically: USDC via x402 if this server has a wallet key, otherwise proof-of-work on eligible tools.",
+        "Call any Agent402 tool by slug (find slugs and input schemas with search_tools). Payment is handled automatically: USDC via x402 if this server has a wallet key, otherwise free proof-of-work on eligible pure-CPU tools (no wallet needed). Wallet-keyed highlights: live market data (stock-quote $0.003) and the /v1 LLM gateway tiers (chat nano $0.003, embeddings $0.002 — no API key).",
       inputSchema: {
         type: "object",
         properties: {
-          slug: { type: "string", description: "Tool slug from search_tools, e.g. \"convert-miles-to-kilometers\"" },
+          slug: { type: "string", description: "Tool slug from search_tools, e.g. \"unit-convert\"" },
           params: { type: "object", description: "Tool input parameters, matching the tool's inputSchema" },
         },
         required: ["slug"],
@@ -497,9 +502,14 @@ server.setRequestHandler(CallToolRequestSchema, async (req) => {
         }],
       };
     }
-    const tool = catalog.get(name === "call_tool" ? args.slug : name);
+    // Curated tools are exposed snake_case for tools/list consistency, but the
+    // real slug is kebab — accept either the exposed name or the raw slug.
+    const wanted = name === "call_tool"
+      ? String(args.slug ?? "")
+      : (catalog.has(name) ? name : name.replace(/_/g, "-"));
+    const tool = catalog.get(wanted);
     if (!tool) {
-      return { content: [{ type: "text", text: `Unknown tool slug "${name === "call_tool" ? args.slug : name}". Use search_tools to find the right slug.` }], isError: true };
+      return { content: [{ type: "text", text: `Unknown tool slug "${wanted}". Use search_tools to find the right slug.` }], isError: true };
     }
     return await callEndpoint(tool, name === "call_tool" ? (args.params ?? {}) : args);
   } catch (err) {

package/package.json

@@ -1,14 +1,14 @@
 {
   "name": "agent402-mcp",
-  "version": "0.11.3",
+  "version": "0.11.5",
   "mcpName": "io.github.MikeyPetrillo/agent402",
-  "author": "Mike Petrillo <mike@agent402.tools> (https://github.com/MikeyPetrillo)",
+  "author": "Havok Holdings LLC <mike@agent402.tools> (https://agent402.tools)",
   "homepage": "https://agent402.tools",
   "repository": {
     "type": "git",
     "url": "git+https://github.com/MikeyPetrillo/Agent402.git"
   },
-  "description": "Open-source MCP server exposing Agent402.Tools' 1,407 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, 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 on Base, Solana, Polygon, Arbitrum & Stellar — plus USDG on Robinhood Chain (6 chains total) — via the x402 protocol.",
+  "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, Stellar & Algorand — plus USDG on Robinhood Chain (8 chains total) — via the x402 protocol.",
   "type": "module",
   "bin": {
     "agent402-mcp": "index.js"
@@ -50,7 +50,9 @@
     "polygon",
     "arbitrum",
     "multi-chain",
+    "monad",
     "stellar",
+    "algorand",
     "robinhood-chain"
   ],
   "license": "MIT",