@agentsearchhq/agentsearch-mcp 1.2.0 → 1.3.0

package/manifest.json

@@ -2,9 +2,9 @@
   "manifest_version": "0.3",
   "name": "agentsearch-mcp",
   "display_name": "AgentSearch (agentsearchhq.com)",
-  "version": "1.2.0",
-  "description": "Check which agent services work right now (free AgentSearch Review Board) and post reviews; plus web search, extract and JS render via your self-hosted AgentSearch API.",
-  "long_description": "Stdio MCP server from AgentSearch. The review tools work with no configuration: agentsearch_review_lookup asks the free AgentSearch Review Board which Pocket Network, x402 and remote MCP services work right now for a task (status from free probes, uptime, latency, price, reviews), and agentsearch_review_submit posts a short structured review after using one. Set AGENTSEARCH_BASE_URL to also enable web search, URL extract and Web Render (headless Chromium for JavaScript-heavy pages) against your own AgentSearch-compatible API; without it those three tools return a setup error. AGENTSEARCH_API_KEY and AGENTSEARCH_REVIEW_KEY are optional.",
+  "version": "1.3.0",
+  "description": "Web search, page extract and JS render, paid per call ($0.005 USDC on Base via x402) or self-hosted; plus the free AgentSearch Review Board.",
+  "long_description": "Stdio MCP server from AgentSearch. agentsearch_web_search, agentsearch_extract and agentsearch_render work out of the box with a wallet key: each call goes through the Pocket Network Agentic Portal and pays $0.005 in USDC on Base over x402 (gasless; no account or API key). The server never signs more than $0.005 per call or more than the session cap (default $1.00), signs only USDC on Base for the portal's payee and the three AgentSearch services, never logs the key, and returns the payment receipt with each result. Use a new wallet holding only a little USDC. Set AGENTSEARCH_BASE_URL instead to use your own self-hosted AgentSearch-compatible API with no payment. The review tools (agentsearch_review_lookup, agentsearch_review_submit) work with no configuration.",
   "author": {
     "name": "AgentSearch",
     "url": "https://github.com/agentsearchhq-coder"
@@ -25,7 +25,10 @@
     "headless-browser",
     "javascript-rendering",
     "reviews",
-    "service-status"
+    "service-status",
+    "x402",
+    "usdc",
+    "base"
   ],
   "compatibility": {
     "platforms": [
@@ -48,22 +51,24 @@
       "env": {
         "AGENTSEARCH_BASE_URL": "${user_config.AGENTSEARCH_BASE_URL}",
         "AGENTSEARCH_API_KEY": "${user_config.AGENTSEARCH_API_KEY}",
-        "AGENTSEARCH_REVIEW_KEY": "${user_config.AGENTSEARCH_REVIEW_KEY}"
+        "AGENTSEARCH_REVIEW_KEY": "${user_config.AGENTSEARCH_REVIEW_KEY}",
+        "AGENTSEARCH_WALLET_PRIVATE_KEY": "${user_config.AGENTSEARCH_WALLET_PRIVATE_KEY}",
+        "AGENTSEARCH_MAX_TOTAL_ATOMIC": "${user_config.AGENTSEARCH_MAX_TOTAL_ATOMIC}"
       }
     }
   },
   "tools": [
     {
       "name": "agentsearch_web_search",
-      "description": "Search the web via your self-hosted AgentSearch API (needs AGENTSEARCH_BASE_URL) and return JSON text. Use extract when you already have a URL. Read-only."
+      "description": "Search the web and return JSON text. Pays $0.005 in USDC on Base per call via the Pocket portal (x402) when a wallet key is set; uses your self-hosted API if AGENTSEARCH_BASE_URL is set. Use extract when you already have a URL. Read-only."
     },
     {
       "name": "agentsearch_extract",
-      "description": "Extract one page from a URL via your self-hosted AgentSearch API (needs AGENTSEARCH_BASE_URL). Use web search to find URLs. Read-only; returns JSON text."
+      "description": "Extract one page (markdown/text, title, links) from a URL. Pays $0.005 in USDC on Base per call via the Pocket portal (x402) when a wallet key is set; uses your self-hosted API if AGENTSEARCH_BASE_URL is set. Read-only; returns JSON text."
     },
     {
       "name": "agentsearch_render",
-      "description": "Render one URL in headless Chromium via your self-hosted AgentSearch API (needs AGENTSEARCH_BASE_URL) and return title plus rendered markdown/text/HTML/links as JSON text. Use for JavaScript-heavy pages where extract comes back empty. Read-only."
+      "description": "Render one URL in headless Chromium and return title plus rendered markdown/text/HTML/links (optional screenshot) as JSON text. Pays $0.005 in USDC on Base per call via the Pocket portal (x402) when a wallet key is set; uses your self-hosted API if AGENTSEARCH_BASE_URL is set. Use for JavaScript-heavy pages. Read-only."
     },
     {
       "name": "agentsearch_review_lookup",
@@ -75,10 +80,24 @@
     }
   ],
   "user_config": {
+    "AGENTSEARCH_WALLET_PRIVATE_KEY": {
+      "type": "string",
+      "title": "Wallet private key (pay per call)",
+      "description": "Optional. 64-hex private key of a NEW wallet holding a little USDC on Base. Enables search/extract/render at $0.005 per call via the Pocket Network Agentic Portal (x402). Never logged.",
+      "sensitive": true,
+      "required": false
+    },
+    "AGENTSEARCH_MAX_TOTAL_ATOMIC": {
+      "type": "string",
+      "title": "Session spend cap (USDC atomic units)",
+      "description": "Most this server will sign for per session; 1000000 = $1.00 (the default). Per-call payments are always capped at 5000 = $0.005.",
+      "required": false,
+      "default": "1000000"
+    },
     "AGENTSEARCH_BASE_URL": {
       "type": "string",
       "title": "AgentSearch base URL",
-      "description": "Optional base URL of your self-hosted AgentSearch API, without a trailing slash. Needed only for web search, extract and render; the review tools work without it.",
+      "description": "Optional base URL of your self-hosted AgentSearch API, without a trailing slash. When set, search/extract/render use it instead of the paid portal.",
       "required": false
     },
     "AGENTSEARCH_API_KEY": {

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@agentsearchhq/agentsearch-mcp",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "mcpName": "io.github.agentsearchhq-coder/agentsearch-mcp",
   "publishConfig": {
     "access": "public"
   },
-  "description": "MCP server: check which agent services work right now on the free AgentSearch Review Board, plus web search, page extract and JS rendering via a self-hosted AgentSearch API",
+  "description": "MCP server: web search, page extract and JS rendering, paid per call ($0.005 USDC on Base via x402) or self-hosted, plus the free AgentSearch Review Board",
   "type": "module",
   "main": "dist/index.js",
   "bin": {
@@ -28,7 +28,8 @@
     "mcpb:validate": "mcpb validate manifest.json",
     "mcpb:pack": "npm run build && node scripts/pack-mcpb.mjs",
     "smithery:publish": "node scripts/publish-smithery.mjs",
-    "test": "npm run build && node --test \"test/*.mjs\""
+    "test": "npm run build && node --test test/*.mjs",
+    "smoke:live": "npm run build && node --test test/live/live-402.smoke.mjs"
   },
   "engines": {
     "node": ">=20"
@@ -42,11 +43,18 @@
     "headless-browser",
     "javascript-rendering",
     "reviews",
-    "service-status"
+    "service-status",
+    "x402",
+    "usdc",
+    "base",
+    "pay-per-call"
   ],
   "license": "MIT",
   "dependencies": {
     "@modelcontextprotocol/sdk": "^1.18.0",
+    "@x402/core": "^2.26.0",
+    "@x402/evm": "^2.26.0",
+    "viem": "^2.57.4",
     "zod": "^3.24.0"
   },
   "devDependencies": {

package/server.json

@@ -2,25 +2,45 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.agentsearchhq-coder/agentsearch-mcp",
   "title": "AgentSearch (agentsearchhq.com)",
-  "description": "Check which agent services work now (free Review Board), plus self-hosted search/extract/render.",
+  "description": "Web search, extract and JS render at $0.005/call (x402, USDC on Base), plus a free Review Board.",
   "websiteUrl": "https://agentsearchhq.com/?utm_source=mcp-registry&utm_medium=directory&utm_campaign=listing",
   "repository": {
     "url": "https://github.com/agentsearchhq-coder/agentsearch-mcp",
     "source": "github"
   },
-  "version": "1.2.0",
+  "version": "1.3.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@agentsearchhq/agentsearch-mcp",
-      "version": "1.2.0",
+      "version": "1.3.0",
       "transport": {
         "type": "stdio"
       },
       "environmentVariables": [
+        {
+          "name": "AGENTSEARCH_WALLET_PRIVATE_KEY",
+          "description": "Private key of a dedicated wallet with a little USDC on Base; pays $0.005/call via the Pocket portal (x402). Alias: POCKET_PRIVATE_KEY",
+          "isRequired": false,
+          "isSecret": true,
+          "format": "string"
+        },
+        {
+          "name": "AGENTSEARCH_MAX_TOTAL_ATOMIC",
+          "description": "Session spend cap in USDC atomic units (default 1000000 = $1.00). Alias: POCKET_MAX_TOTAL_ATOMIC",
+          "isRequired": false,
+          "format": "string",
+          "default": "1000000"
+        },
+        {
+          "name": "AGENTSEARCH_MAX_PER_CALL_ATOMIC",
+          "description": "Optional lower per-call cap (max and default 5000 = $0.005)",
+          "isRequired": false,
+          "format": "string"
+        },
         {
           "name": "AGENTSEARCH_BASE_URL",
-          "description": "Base URL of your AgentSearch API (no trailing slash); only for search/extract/render",
+          "description": "Optional self-hosted AgentSearch API base URL; when set, search/extract/render use it with no payment",
           "isRequired": false,
           "format": "string"
         },

package/smithery.yaml

@@ -1,20 +1,35 @@
-# Smithery start command. Review tools work with no config; set the base URL to enable search/extract/render.
+# Smithery start command. Review tools work with no config. Search/extract/render pay $0.005 per call
+# in USDC on Base via the Pocket Network Agentic Portal (x402) when a wallet key is set, or use your
+# self-hosted API when a base URL is set.
 startCommand:
   type: stdio
   configSchema:
     type: object
     properties:
+      walletPrivateKey:
+        type: string
+        description: Optional 64-hex private key of a NEW wallet holding a little USDC on Base. Pays $0.005 per search/extract/render call via x402. Never logged.
+      maxTotalAtomic:
+        type: string
+        default: "1000000"
+        description: Session spend cap in USDC atomic units (1000000 = $1.00). Per-call payments are always capped at 5000 ($0.005).
       agentsearchBaseUrl:
         type: string
-        description: Optional base URL of your self-hosted AgentSearch API (no trailing slash). Needed only for search/extract/render; the review tools work without it.
+        description: Optional base URL of your self-hosted AgentSearch API (no trailing slash). When set, it is used instead of the paid portal.
       agentsearchApiKey:
         type: string
-        description: Optional Bearer token for your AgentSearch API
+        description: Optional Bearer token for your self-hosted AgentSearch API
   commandFunction: |-
     (config) => ({
       command: 'node',
       args: ['dist/index.js'],
       env: {
+        ...(config.walletPrivateKey
+          ? { AGENTSEARCH_WALLET_PRIVATE_KEY: config.walletPrivateKey }
+          : {}),
+        ...(config.maxTotalAtomic
+          ? { AGENTSEARCH_MAX_TOTAL_ATOMIC: config.maxTotalAtomic }
+          : {}),
         ...(config.agentsearchBaseUrl
           ? { AGENTSEARCH_BASE_URL: config.agentsearchBaseUrl }
           : {}),