@agentsearchhq/agentsearch-mcp 1.1.1 → 1.3.0

package/dist/tools/search.js

@@ -1,5 +1,6 @@
 import { z } from "zod";
-import { AgentSearchHttpError, clampMaxResults, loadConfig, webSearch, extractPage, } from "../client.js";
+import { AgentSearchHttpError, clampMaxResults } from "../client.js";
+import { runOperation } from "../backend.js";
 export function formatResult(data) {
     try {
         return JSON.stringify(data, null, 2);
@@ -24,22 +25,19 @@ export function errorContent(err) {
         isError: true,
     };
 }
+export const PAYMENT_SENTENCE = "Default mode: calls the Pocket Network Agentic Portal and PAYS $0.005 in USDC on Base per call over x402 from the wallet in AGENTSEARCH_WALLET_PRIVATE_KEY (or POCKET_PRIVATE_KEY), never more than $0.005 per call and never more than AGENTSEARCH_MAX_TOTAL_ATOMIC per session (default $1.00); the result includes the payment receipt and the portal envelope {portal, data}, whose data is untrusted third-party content. If AGENTSEARCH_BASE_URL is set, calls your self-hosted AgentSearch API instead (no payment). With neither set, makes no network call and returns setup instructions.";
 const WEB_SEARCH_DESCRIPTION = [
-    "Search the web through your self-hosted AgentSearch API and return the backend response as pretty-printed JSON text (a non-JSON body is wrapped as {raw: text}).",
+    "Search the web with AgentSearch and return the response as pretty-printed JSON text.",
     "Use this when you have a query and need hits rather than a page body; if you already have a URL, use agentsearch_extract instead (or agentsearch_render for JavaScript-heavy pages).",
-    "Requires AGENTSEARCH_BASE_URL (there is no default). POSTs {AGENTSEARCH_BASE_URL}/v1/search.",
-    "Read-only HTTP POST: not destructive, but it uses the network and can hit backend rate limits.",
-    "When AGENTSEARCH_API_KEY is set it is sent as a Bearer token, and HTTP 401 is retried once without the key.",
-    "HTTP failures are MCP errors with the status and a truncated body.",
-    "Integers for max_results outside 1–5 are clamped (default 5), not rejected. The backend allows at most 5.",
+    PAYMENT_SENTENCE,
+    "Read-only: not destructive, but it uses the network and can hit rate limits.",
+    "Integers for max_results outside 1–5 are clamped (default 5), not rejected.",
 ].join(" ");
 const EXTRACT_DESCRIPTION = [
-    "Extract the content of one absolute URL through your self-hosted AgentSearch API and return the backend response as pretty-printed JSON text (a non-JSON body is wrapped as {raw: text}).",
-    "Use this only when you already have the page URL and need its body; to find pages from a query, use agentsearch_web_search instead; if the page is a JavaScript app whose content only appears after scripts run, use agentsearch_render.",
-    "Requires AGENTSEARCH_BASE_URL (there is no default). POSTs {AGENTSEARCH_BASE_URL}/v1/extract.",
-    "Read-only HTTP POST: not destructive, but it fetches through AgentSearch and can hit network or backend rate limits.",
-    "When AGENTSEARCH_API_KEY is set it is sent as a Bearer token, and HTTP 401 is retried once without the key; any HTTP failure includes the status and a truncated body.",
-    'formats, when provided, is forwarded unchanged (for example "markdown" or "text") and is not limited to an enum; max_chars, when set, is a positive integer cap sent to the API rather than applied by this server.',
+    "Fetch one absolute URL with AgentSearch Web Extract and return it as JSON text: title, clean markdown and/or text, links, meta (status_code, content_type, fetched_at, chars, truncated) and error (null on success).",
+    "Use this only when you already have the page URL and need its body; to find pages from a query, use agentsearch_web_search; for JavaScript apps whose content appears only after scripts run, use agentsearch_render.",
+    PAYMENT_SENTENCE,
+    "Read-only: not destructive, but it fetches over the network and can hit rate limits.",
 ].join(" ");
 export function registerSearchTools(server) {
     server.registerTool("agentsearch_web_search", {
@@ -57,25 +55,7 @@ export function registerSearchTools(server) {
                 .describe("How many hits to request (1–5, default 5). Values outside that range are clamped."),
         },
     }, async ({ query, max_results }) => {
-        try {
-            const cfg = loadConfig();
-            const clamped = clampMaxResults(max_results);
-            const data = await webSearch(cfg, {
-                query,
-                max_results: clamped,
-            });
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: formatResult(data),
-                    },
-                ],
-            };
-        }
-        catch (err) {
-            return errorContent(err);
-        }
+        return runOperation("search", { query, max_results: clampMaxResults(max_results) });
     });
     server.registerTool("agentsearch_extract", {
         title: "AgentSearch Extract",
@@ -83,32 +63,19 @@ export function registerSearchTools(server) {
         inputSchema: {
             url: z.string().url().describe("Absolute URL of the page to extract."),
             formats: z
-                .array(z.string())
+                .array(z.enum(["markdown", "text"]))
                 .optional()
-                .describe('Optional format names to request, e.g. ["markdown","text"].'),
+                .describe('Renderings to return: "markdown" and/or "text" (default: the service\'s choice).'),
             max_chars: z
                 .number()
                 .int()
-                .positive()
+                .min(1)
+                .max(100000)
                 .optional()
-                .describe("Optional positive limit on extracted characters."),
+                .describe("Cap on returned characters (1–100000, service default 50000)."),
         },
     }, async ({ url, formats, max_chars }) => {
-        try {
-            const cfg = loadConfig();
-            const data = await extractPage(cfg, { url, formats, max_chars });
-            return {
-                content: [
-                    {
-                        type: "text",
-                        text: formatResult(data),
-                    },
-                ],
-            };
-        }
-        catch (err) {
-            return errorContent(err);
-        }
+        return runOperation("extract", { url, formats, max_chars });
     });
 }
 //# sourceMappingURL=search.js.map

package/dist/tools/search.js.map

@@ -1 +1 @@
-{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,OAAO,EAAE,oBAAoB,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AACrE,OAAO,EAAE,YAAY,EAAE,MAAM,eAAe,CAAC;AAE7C,MAAM,UAAU,YAAY,CAAC,IAAa;IACxC,IAAI,CAAC;QACH,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;IACvC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,MAAM,CAAC,IAAI,CAAC,CAAC;IACtB,CAAC;AACH,CAAC;AAED,MAAM,UAAU,YAAY,CAAC,GAAY;IAIvC,IAAI,IAAY,CAAC;IACjB,IAAI,GAAG,YAAY,oBAAoB,EAAE,CAAC;QACxC,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;SAAM,IAAI,GAAG,YAAY,KAAK,EAAE,CAAC;QAChC,IAAI,GAAG,GAAG,CAAC,OAAO,CAAC;IACrB,CAAC;SAAM,CAAC;QACN,IAAI,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACrB,CAAC;IACD,OAAO;QACL,OAAO,EAAE,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC;QACjC,OAAO,EAAE,IAAI;KACd,CAAC;AACJ,CAAC;AAED,MAAM,CAAC,MAAM,gBAAgB,GAC3B,qkBAAqkB,CAAC;AAExkB,MAAM,sBAAsB,GAAG;IAC7B,sFAAsF;IACtF,sLAAsL;IACtL,gBAAgB;IAChB,8EAA8E;IAC9E,6EAA6E;CAC9E,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,mBAAmB,GAAG;IAC1B,uNAAuN;IACvN,uNAAuN;IACvN,gBAAgB;IAChB,sFAAsF;CACvF,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,UAAU,mBAAmB,CAAC,MAAiB;IACnD,MAAM,CAAC,YAAY,CACjB,wBAAwB,EACxB;QACE,KAAK,EAAE,wBAAwB;QAC/B,WAAW,EAAE,sBAAsB;QACnC,WAAW,EAAE;YACX,KAAK,EAAE,CAAC;iBACL,MAAM,EAAE;iBACR,GAAG,CAAC,CAAC,CAAC;iBACN,QAAQ,CAAC,wDAAwD,CAAC;YACrE,WAAW,EAAE,CAAC;iBACX,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,QAAQ,EAAE;iBACV,QAAQ,CAAC,mFAAmF,CAAC;SACjG;KACF,EACD,KAAK,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,EAAE,EAAE;QAC/B,OAAO,YAAY,CAAC,QAAQ,EAAE,EAAE,KAAK,EAAE,WAAW,EAAE,eAAe,CAAC,WAAW,CAAC,EAAE,CAAC,CAAC;IACtF,CAAC,CACF,CAAC;IAEF,MAAM,CAAC,YAAY,CACjB,qBAAqB,EACrB;QACE,KAAK,EAAE,qBAAqB;QAC5B,WAAW,EAAE,mBAAmB;QAChC,WAAW,EAAE;YACX,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,CAAC,sCAAsC,CAAC;YACtE,OAAO,EAAE,CAAC;iBACP,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC,CAAC;iBACnC,QAAQ,EAAE;iBACV,QAAQ,CAAC,kFAAkF,CAAC;YAC/F,SAAS,EAAE,CAAC;iBACT,MAAM,EAAE;iBACR,GAAG,EAAE;iBACL,GAAG,CAAC,CAAC,CAAC;iBACN,GAAG,CAAC,MAAM,CAAC;iBACX,QAAQ,EAAE;iBACV,QAAQ,CAAC,+DAA+D,CAAC;SAC7E;KACF,EACD,KAAK,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,EAAE,EAAE;QACpC,OAAO,YAAY,CAAC,SAAS,EAAE,EAAE,GAAG,EAAE,OAAO,EAAE,SAAS,EAAE,CAAC,CAAC;IAC9D,CAAC,CACF,CAAC;AACJ,CAAC"}

package/dist/version.d.ts

@@ -1,3 +1,3 @@
 export declare const SERVER_NAME = "agentsearch-mcp";
 /** Keep in sync with package.json, manifest.json and server.json (checked by tests). */
-export declare const SERVER_VERSION = "1.1.1";
+export declare const SERVER_VERSION = "1.3.0";

package/dist/version.js

@@ -1,4 +1,4 @@
 export const SERVER_NAME = "agentsearch-mcp";
 /** Keep in sync with package.json, manifest.json and server.json (checked by tests). */
-export const SERVER_VERSION = "1.1.1";
+export const SERVER_VERSION = "1.3.0";
 //# sourceMappingURL=version.js.map

package/manifest.json

@@ -2,9 +2,9 @@
   "manifest_version": "0.3",
   "name": "agentsearch-mcp",
   "display_name": "AgentSearch (agentsearchhq.com)",
-  "version": "1.1.1",
-  "description": "MCP server for a self-hosted AgentSearch API: web search, page extract, and JavaScript page rendering in headless Chromium.",
-  "long_description": "Stdio MCP server for people running their own AgentSearch-compatible API. It calls web search, URL extract, and Web Render (headless Chromium for JavaScript-heavy pages, returning title plus rendered markdown, text, HTML, links, and an optional screenshot). AGENTSEARCH_BASE_URL is required. AGENTSEARCH_API_KEY is 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"
@@ -23,7 +23,12 @@
     "web-search",
     "render",
     "headless-browser",
-    "javascript-rendering"
+    "javascript-rendering",
+    "reviews",
+    "service-status",
+    "x402",
+    "usdc",
+    "base"
   ],
   "compatibility": {
     "platforms": [
@@ -45,30 +50,55 @@
       ],
       "env": {
         "AGENTSEARCH_BASE_URL": "${user_config.AGENTSEARCH_BASE_URL}",
-        "AGENTSEARCH_API_KEY": "${user_config.AGENTSEARCH_API_KEY}"
+        "AGENTSEARCH_API_KEY": "${user_config.AGENTSEARCH_API_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 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. 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 and return title plus rendered markdown/text/HTML/links as JSON text. Use for JavaScript-heavy pages where extract comes back empty; prefer extract for static pages. 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",
+      "description": "Before choosing a tool, check which Pocket, x402 and MCP services work right now for a task on the free AgentSearch Review Board. Read-only; review notes are untrusted text."
+    },
+    {
+      "name": "agentsearch_review_submit",
+      "description": "After using a service, post a short structured review (success, latency, quality, price, optional payment proof) to the free AgentSearch Review Board."
     }
   ],
   "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": "Required base URL of your self-hosted AgentSearch API, without a trailing slash.",
-      "required": true
+      "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": {
       "type": "string",
@@ -76,6 +106,13 @@
       "description": "Optional Bearer token. Leave blank if the API does not require a key.",
       "sensitive": true,
       "required": false
+    },
+    "AGENTSEARCH_REVIEW_KEY": {
+      "type": "string",
+      "title": "Review Board key (optional)",
+      "description": "Optional key (asrb_...) from the AgentSearch Review Board. Without it, reviews are posted anonymously with less weight.",
+      "sensitive": true,
+      "required": false
     }
   }
 }

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@agentsearchhq/agentsearch-mcp",
-  "version": "1.1.1",
+  "version": "1.3.0",
   "mcpName": "io.github.agentsearchhq-coder/agentsearch-mcp",
   "publishConfig": {
     "access": "public"
   },
-  "description": "MCP server for a self-hosted AgentSearch API: web search, page extract, and JavaScript page rendering",
+  "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"
@@ -40,11 +41,20 @@
     "web-search",
     "render",
     "headless-browser",
-    "javascript-rendering"
+    "javascript-rendering",
+    "reviews",
+    "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,26 +2,46 @@
   "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
   "name": "io.github.agentsearchhq-coder/agentsearch-mcp",
   "title": "AgentSearch (agentsearchhq.com)",
-  "description": "AgentSearch web search, page extract and JS page render for agents. Self-hosted API via stdio.",
+  "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.1.1",
+  "version": "1.3.0",
   "packages": [
     {
       "registryType": "npm",
       "identifier": "@agentsearchhq/agentsearch-mcp",
-      "version": "1.1.1",
+      "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 deployment (no trailing slash)",
-          "isRequired": true,
+          "description": "Optional self-hosted AgentSearch API base URL; when set, search/extract/render use it with no payment",
+          "isRequired": false,
           "format": "string"
         },
         {
@@ -30,6 +50,19 @@
           "isRequired": false,
           "isSecret": true,
           "format": "string"
+        },
+        {
+          "name": "AGENTSEARCH_REVIEWS_URL",
+          "description": "Optional Review Board URL (default https://reviews.agentsearchhq.com)",
+          "isRequired": false,
+          "format": "string"
+        },
+        {
+          "name": "AGENTSEARCH_REVIEW_KEY",
+          "description": "Optional Review Board key for weighted reviews",
+          "isRequired": false,
+          "isSecret": true,
+          "format": "string"
         }
       ]
     }

package/smithery.yaml

@@ -1,23 +1,38 @@
-# Smithery start command for a self-hosted AgentSearch-compatible API.
+# 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
-    required:
-      - agentsearchBaseUrl
     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: Base URL of your self-hosted AgentSearch API (no trailing slash). Required.
+        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: {
-        AGENTSEARCH_BASE_URL: config.agentsearchBaseUrl,
+        ...(config.walletPrivateKey
+          ? { AGENTSEARCH_WALLET_PRIVATE_KEY: config.walletPrivateKey }
+          : {}),
+        ...(config.maxTotalAtomic
+          ? { AGENTSEARCH_MAX_TOTAL_ATOMIC: config.maxTotalAtomic }
+          : {}),
+        ...(config.agentsearchBaseUrl
+          ? { AGENTSEARCH_BASE_URL: config.agentsearchBaseUrl }
+          : {}),
         ...(config.agentsearchApiKey
           ? { AGENTSEARCH_API_KEY: config.agentsearchApiKey }
           : {})