@agentsearchhq/agentsearch-mcp 1.3.3 → 1.3.4

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/.env.example CHANGED
@@ -3,7 +3,7 @@
3
3
 
4
4
  # --- Pay per call (default mode for search/extract/render) ---
5
5
  # Private key (64 hex) of a NEW wallet made only for this, holding a little USDC on Base.
6
- # Each call pays $0.005 (5000 atomic units) via the Pocket Network Agentic Portal over x402.
6
+ # Each search/extract call pays $0.005 (5000 atomic units) via the Pocket Network Agentic Portal over x402.
7
7
  # No ETH needed. The key is never logged. Alias: POCKET_PRIVATE_KEY.
8
8
  AGENTSEARCH_WALLET_PRIVATE_KEY=
9
9
  # Session spend cap in USDC atomic units (1000000 = $1.00, the default). Alias: POCKET_MAX_TOTAL_ATOMIC.
package/README.md CHANGED
@@ -2,8 +2,8 @@
2
2
 
3
3
  MCP (Model Context Protocol) server from [AgentSearch](https://agentsearchhq.com/?utm_source=github&utm_medium=readme&utm_campaign=mcp) for Cursor, Claude Desktop, and other MCP hosts over **stdio**. It has two groups of tools:
4
4
 
5
- - **Free web search with no setup:** with no configuration, `agentsearch_web_search` uses the free AgentSearch relay (`https://relay.agentsearchhq.com/v1/search`): **25 searches per day per user**, search only, no key or wallet. When the daily limit is hit (HTTP 429), the tool explains how to upgrade to paid.
6
- - **Web search, extract and render, pay per call:** `agentsearch_web_search`, `agentsearch_extract` and `agentsearch_render`. Add a wallet key and each call goes through the [Pocket Network Agentic Portal](https://agent.pocket.network) and pays **$0.005 in USDC on Base** over [x402](https://x402.org). No account, no API key, no ETH for gas. Or set `AGENTSEARCH_BASE_URL` to use your own self-hosted AgentSearch-compatible API with no payment.
5
+ - **Free web search with no setup:** with no configuration, `agentsearch_web_search` uses the free AgentSearch relay (`https://relay.agentsearchhq.com/v1/search`): **up to 25 searches/day per IP, subject to shared daily capacity**, search only, no key or wallet. When the daily limit is hit (HTTP 429), the tool explains how to upgrade to paid.
6
+ - **Web search, extract and render, pay per call:** `agentsearch_web_search`, `agentsearch_extract` and `agentsearch_render`. Add a wallet key and each call goes through the [Pocket Network Agentic Portal](https://agent.pocket.network) and pays in USDC on Base (**$0.005 per search or extract call**) over [x402](https://x402.org). No account, no API key, no ETH for gas. Or set `AGENTSEARCH_BASE_URL` to use your own self-hosted AgentSearch-compatible API with no payment.
7
7
  - **AgentSearch Review Board (works out of the box, free):** `agentsearch_review_lookup` checks which Pocket Network, x402 and remote MCP services work right now for a task before you pick one; `agentsearch_review_submit` posts a short structured review after you use one. No configuration or key needed; the board is at https://reviews.agentsearchhq.com.
8
8
 
9
9
  ```bash
@@ -14,8 +14,8 @@ npx -y @agentsearchhq/agentsearch-mcp # free search + review tools work immedi
14
14
 
15
15
  | Config | `agentsearch_web_search` | `agentsearch_extract` / `agentsearch_render` |
16
16
  |--------|--------------------------|-----------------------------------------------|
17
- | Nothing set (default) | Free relay, 25/day per user | Paid tools: return a message ($0.005 per call via the Pocket portal) with how to add a wallet; no network call |
18
- | `AGENTSEARCH_WALLET_PRIVATE_KEY` | Paid, $0.005 per call via the Pocket portal | Paid, $0.005 per call via the Pocket portal |
17
+ | Nothing set (default) | Free relay, up to 25 searches/day per IP, subject to shared daily capacity | Paid tools: return a message with how to add a wallet; no network call |
18
+ | `AGENTSEARCH_WALLET_PRIVATE_KEY` | Paid, $0.005 per call via the Pocket portal | Paid via the Pocket portal (extract $0.005 per call) |
19
19
  | `AGENTSEARCH_BASE_URL` (takes precedence) | Your self-hosted API | Your self-hosted API |
20
20
 
21
21
  To upgrade from the free relay, set `AGENTSEARCH_WALLET_PRIVATE_KEY` (a new wallet with a little USDC on Base) in this server's `env` and restart your client.
@@ -105,7 +105,7 @@ Binary: `agentsearch-mcp` → `dist/index.js`
105
105
 
106
106
  | Variable | Required | Notes |
107
107
  |----------|----------|--------|
108
- | `AGENTSEARCH_WALLET_PRIVATE_KEY` | no | Without it, search uses the free relay (25/day) and extract/render are unavailable. Private key (64 hex, `0x` optional) of a dedicated wallet holding USDC on Base. Enables paid mode. Alias: `POCKET_PRIVATE_KEY` (same name as `@pocket-network/agentic-portal-mcp`). |
108
+ | `AGENTSEARCH_WALLET_PRIVATE_KEY` | no | Without it, search uses the free relay (up to 25 searches/day per IP, subject to shared daily capacity) and extract/render are unavailable. Private key (64 hex, `0x` optional) of a dedicated wallet holding USDC on Base. Enables paid mode. Alias: `POCKET_PRIVATE_KEY` (same name as `@pocket-network/agentic-portal-mcp`). |
109
109
  | `AGENTSEARCH_MAX_TOTAL_ATOMIC` | no | Session spend cap in USDC atomic units. Default `1000000` ($1.00). Alias: `POCKET_MAX_TOTAL_ATOMIC`. |
110
110
  | `AGENTSEARCH_MAX_PER_CALL_ATOMIC` | no | Lower per-call cap; default and maximum `5000` ($0.005). Alias: `POCKET_MAX_PER_CALL_ATOMIC`. |
111
111
  | `AGENTSEARCH_BASE_URL` | no | Base URL of your self-hosted API (no trailing slash). When set, search/extract/render use it instead of the paid portal. |
package/dist/index.js CHANGED
@@ -19,7 +19,7 @@ async function main() {
19
19
  ? `base=${process.env.AGENTSEARCH_BASE_URL.trim().replace(/\/+$/, "")}`
20
20
  : mode === "pocket"
21
21
  ? "search/extract/render: pay-per-call via Pocket portal (x402, USDC on Base)"
22
- : "no wallet key or AGENTSEARCH_BASE_URL: search uses the free AgentSearch relay (25/day per user); extract/render need a wallet key";
22
+ : "no wallet key or AGENTSEARCH_BASE_URL: search uses the free AgentSearch relay (up to 25 searches/day per IP, subject to shared daily capacity); extract/render need a wallet key";
23
23
  console.error(`agentsearch-mcp listening on stdio (${base}; reviews=${loadReviewsConfig().baseUrl})`);
24
24
  }
25
25
  main().catch((err) => {
package/dist/index.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAE9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,0DAA0D;IAC1D,2CAA2C;IAC3C,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,MAAM,IAAI,GACR,IAAI,KAAK,aAAa;QACpB,CAAC,CAAC,QAAQ,OAAO,CAAC,GAAG,CAAC,oBAAqB,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;QACxE,CAAC,CAAC,IAAI,KAAK,QAAQ;YACjB,CAAC,CAAC,4EAA4E;YAC9E,CAAC,CAAC,mIAAmI,CAAC;IAC5I,OAAO,CAAC,KAAK,CACX,uCAAuC,IAAI,aAAa,iBAAiB,EAAE,CAAC,OAAO,GAAG,CACvF,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,KAAK,CAAC,oCAAoC,OAAO,EAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
1
+ {"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AACA;;;;GAIG;AAEH,OAAO,EAAE,oBAAoB,EAAE,MAAM,2CAA2C,CAAC;AACjF,OAAO,EAAE,WAAW,EAAE,MAAM,cAAc,CAAC;AAC3C,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AACxD,OAAO,EAAE,YAAY,EAAE,MAAM,aAAa,CAAC;AAE3C,KAAK,UAAU,IAAI;IACjB,MAAM,MAAM,GAAG,YAAY,EAAE,CAAC;IAE9B,MAAM,SAAS,GAAG,IAAI,oBAAoB,EAAE,CAAC;IAC7C,MAAM,MAAM,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAEhC,0DAA0D;IAC1D,2CAA2C;IAC3C,MAAM,IAAI,GAAG,WAAW,EAAE,CAAC;IAC3B,MAAM,IAAI,GACR,IAAI,KAAK,aAAa;QACpB,CAAC,CAAC,QAAQ,OAAO,CAAC,GAAG,CAAC,oBAAqB,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,EAAE;QACxE,CAAC,CAAC,IAAI,KAAK,QAAQ;YACjB,CAAC,CAAC,4EAA4E;YAC9E,CAAC,CAAC,kLAAkL,CAAC;IAC3L,OAAO,CAAC,KAAK,CACX,uCAAuC,IAAI,aAAa,iBAAiB,EAAE,CAAC,OAAO,GAAG,CACvF,CAAC;AACJ,CAAC;AAED,IAAI,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE;IACnB,MAAM,OAAO,GAAG,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IACjE,OAAO,CAAC,KAAK,CAAC,oCAAoC,OAAO,EAAE,CAAC,CAAC;IAC7D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC,CAAC"}
package/dist/relay.d.ts CHANGED
@@ -1,4 +1,4 @@
1
- /** Free AgentSearch relay: search only, 25 searches per day per user, no key or wallet needed. */
1
+ /** Free AgentSearch relay: search only, up to 25 searches/day per IP, subject to shared daily capacity, no key or wallet needed. */
2
2
  import { type SearchRequest } from "./client.js";
3
3
  export declare const FREE_RELAY_URL = "https://relay.agentsearchhq.com";
4
4
  export declare const FREE_RELAY_DAILY_LIMIT = 25;
package/dist/relay.js CHANGED
@@ -1,20 +1,20 @@
1
- /** Free AgentSearch relay: search only, 25 searches per day per user, no key or wallet needed. */
1
+ /** Free AgentSearch relay: search only, up to 25 searches/day per IP, subject to shared daily capacity, no key or wallet needed. */
2
2
  import { AgentSearchHttpError, requestTimeoutMs } from "./client.js";
3
3
  export const FREE_RELAY_URL = "https://relay.agentsearchhq.com";
4
4
  export const FREE_RELAY_DAILY_LIMIT = 25;
5
5
  const ADD_WALLET = "To add a wallet: set AGENTSEARCH_WALLET_PRIVATE_KEY (or POCKET_PRIVATE_KEY) to the 64-hex private key of a NEW wallet made only for this, in the env block of this MCP server in your client config, fund it with a little USDC on Base (for example $1; no ETH needed), and restart the client.";
6
6
  export const FREE_RELAY_LIMIT_MESSAGE = [
7
- `Free search limit reached: the free AgentSearch relay allows ${FREE_RELAY_DAILY_LIMIT} searches per day per user. It resets daily.`,
8
- "Upgrade to paid for unlimited search (plus agentsearch_extract and agentsearch_render): each call costs $0.005 in USDC on Base via the Pocket Network Agentic Portal (https://agent.pocket.network) over x402.",
7
+ `Free search limit reached: the free AgentSearch relay allows up to ${FREE_RELAY_DAILY_LIMIT} searches/day per IP, subject to shared daily capacity. It resets daily.`,
8
+ "Upgrade to paid search (plus agentsearch_extract and agentsearch_render): each search or extract call costs $0.005 in USDC on Base via the Pocket Network Agentic Portal (https://agent.pocket.network) over x402.",
9
9
  ADD_WALLET,
10
10
  "Or set AGENTSEARCH_BASE_URL to your own self-hosted AgentSearch-compatible API.",
11
11
  ].join(" ");
12
12
  export function paidOnlyMessage(tool) {
13
13
  return [
14
- `${tool} is a paid tool: $0.005 per call in USDC on Base, paid over x402 through the Pocket Network Agentic Portal (https://agent.pocket.network). No wallet is configured, so no call was made.`,
15
- `The free relay covers agentsearch_web_search only (${FREE_RELAY_DAILY_LIMIT} searches per day per user).`,
14
+ `${tool} is a paid tool${tool === "agentsearch_extract" ? ": $0.005 per call" : ""} in USDC on Base, paid over x402 through the Pocket Network Agentic Portal (https://agent.pocket.network). No wallet is configured, so no call was made.`,
15
+ `The free relay covers agentsearch_web_search only (up to ${FREE_RELAY_DAILY_LIMIT} searches/day per IP, subject to shared daily capacity).`,
16
16
  ADD_WALLET,
17
- "Spending is capped at $0.005 per call and AGENTSEARCH_MAX_TOTAL_ATOMIC per session (default $1.00). Or set AGENTSEARCH_BASE_URL to your own self-hosted AgentSearch-compatible API.",
17
+ "Spending is capped per call and AGENTSEARCH_MAX_TOTAL_ATOMIC per session (default $1.00). Or set AGENTSEARCH_BASE_URL to your own self-hosted AgentSearch-compatible API.",
18
18
  "The review tools (agentsearch_review_lookup, agentsearch_review_submit) are free and need no setup.",
19
19
  ].join(" ");
20
20
  }
package/dist/relay.js.map CHANGED
@@ -1 +1 @@
1
- {"version":3,"file":"relay.js","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"AAAA,kGAAkG;AAClG,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AAEzF,MAAM,CAAC,MAAM,cAAc,GAAG,iCAAiC,CAAC;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC,MAAM,UAAU,GACd,kSAAkS,CAAC;AAErS,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,gEAAgE,sBAAsB,8CAA8C;IACpI,gNAAgN;IAChN,UAAU;IACV,iFAAiF;CAClF,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,UAAU,eAAe,CAAC,IAAkD;IAChF,OAAO;QACL,GAAG,IAAI,0LAA0L;QACjM,sDAAsD,sBAAsB,8BAA8B;QAC1G,UAAU;QACV,qLAAqL;QACrL,qGAAqG;KACtG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,6HAA6H;AAC7H,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAkB;IAClD,MAAM,IAAI,GAA4B,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;IAC3D,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS;QAAE,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IACtE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,cAAc,YAAY,EAAE;QACrD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE;QAC3E,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAC1B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;KAChD,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC;IACtF,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,oBAAoB,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAChF,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACvB,CAAC;IACD,iCAAiC;IACjC,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAQ,IAAgC,CAAC,QAAQ,CAAC;IAChH,OAAO,IAAI,CAAC;AACd,CAAC"}
1
+ {"version":3,"file":"relay.js","sourceRoot":"","sources":["../src/relay.ts"],"names":[],"mappings":"AAAA,oIAAoI;AACpI,OAAO,EAAE,oBAAoB,EAAE,gBAAgB,EAAsB,MAAM,aAAa,CAAC;AAEzF,MAAM,CAAC,MAAM,cAAc,GAAG,iCAAiC,CAAC;AAChE,MAAM,CAAC,MAAM,sBAAsB,GAAG,EAAE,CAAC;AAEzC,MAAM,UAAU,GACd,kSAAkS,CAAC;AAErS,MAAM,CAAC,MAAM,wBAAwB,GAAG;IACtC,sEAAsE,sBAAsB,0EAA0E;IACtK,oNAAoN;IACpN,UAAU;IACV,iFAAiF;CAClF,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AAEZ,MAAM,UAAU,eAAe,CAAC,IAAkD;IAChF,OAAO;QACL,GAAG,IAAI,kBAAkB,IAAI,KAAK,qBAAqB,CAAC,CAAC,CAAC,mBAAmB,CAAC,CAAC,CAAC,EAAE,0JAA0J;QAC5O,4DAA4D,sBAAsB,0DAA0D;QAC5I,UAAU;QACV,2KAA2K;QAC3K,qGAAqG;KACtG,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;AACd,CAAC;AAED,6HAA6H;AAC7H,MAAM,CAAC,KAAK,UAAU,WAAW,CAAC,GAAkB;IAClD,MAAM,IAAI,GAA4B,EAAE,KAAK,EAAE,GAAG,CAAC,KAAK,EAAE,CAAC;IAC3D,IAAI,GAAG,CAAC,WAAW,KAAK,SAAS;QAAE,IAAI,CAAC,WAAW,GAAG,GAAG,CAAC,WAAW,CAAC;IACtE,MAAM,GAAG,GAAG,MAAM,KAAK,CAAC,GAAG,cAAc,YAAY,EAAE;QACrD,MAAM,EAAE,MAAM;QACd,OAAO,EAAE,EAAE,cAAc,EAAE,kBAAkB,EAAE,MAAM,EAAE,kBAAkB,EAAE;QAC3E,IAAI,EAAE,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC;QAC1B,MAAM,EAAE,WAAW,CAAC,OAAO,CAAC,gBAAgB,EAAE,CAAC;KAChD,CAAC,CAAC;IACH,MAAM,IAAI,GAAG,MAAM,GAAG,CAAC,IAAI,EAAE,CAAC;IAC9B,IAAI,GAAG,CAAC,MAAM,KAAK,GAAG;QAAE,MAAM,IAAI,oBAAoB,CAAC,GAAG,EAAE,wBAAwB,CAAC,CAAC;IACtF,IAAI,CAAC,GAAG,CAAC,EAAE;QAAE,MAAM,IAAI,oBAAoB,CAAC,GAAG,CAAC,MAAM,EAAE,IAAI,IAAI,GAAG,CAAC,UAAU,CAAC,CAAC;IAChF,IAAI,IAAa,CAAC;IAClB,IAAI,CAAC;QACH,IAAI,GAAG,IAAI,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IACxC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,EAAE,GAAG,EAAE,IAAI,EAAE,CAAC;IACvB,CAAC;IACD,iCAAiC;IACjC,IAAI,IAAI,IAAI,OAAO,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC;QAAE,OAAQ,IAAgC,CAAC,QAAQ,CAAC;IAChH,OAAO,IAAI,CAAC;AACd,CAAC"}
@@ -7,5 +7,5 @@ export declare function errorContent(err: unknown): {
7
7
  }[];
8
8
  isError: true;
9
9
  };
10
- export declare 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 (no config), agentsearch_web_search uses the free AgentSearch relay (https://relay.agentsearchhq.com, 25 searches per day per user, no payment), while agentsearch_extract and agentsearch_render make no network call and explain how to add a wallet.";
10
+ export declare const PAYMENT_SENTENCE = "Default mode: calls the Pocket Network Agentic Portal and PAYS in USDC on Base per call over x402 ($0.005 per search or extract call) from the wallet in AGENTSEARCH_WALLET_PRIVATE_KEY (or POCKET_PRIVATE_KEY), never more than the per-call cap 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 (no config), agentsearch_web_search uses the free AgentSearch relay (https://relay.agentsearchhq.com, up to 25 searches/day per IP, subject to shared daily capacity, no payment), while agentsearch_extract and agentsearch_render make no network call and explain how to add a wallet.";
11
11
  export declare function registerSearchTools(server: McpServer): void;
@@ -25,7 +25,7 @@ export function errorContent(err) {
25
25
  isError: true,
26
26
  };
27
27
  }
28
- 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 (no config), agentsearch_web_search uses the free AgentSearch relay (https://relay.agentsearchhq.com, 25 searches per day per user, no payment), while agentsearch_extract and agentsearch_render make no network call and explain how to add a wallet.";
28
+ export const PAYMENT_SENTENCE = "Default mode: calls the Pocket Network Agentic Portal and PAYS in USDC on Base per call over x402 ($0.005 per search or extract call) from the wallet in AGENTSEARCH_WALLET_PRIVATE_KEY (or POCKET_PRIVATE_KEY), never more than the per-call cap 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 (no config), agentsearch_web_search uses the free AgentSearch relay (https://relay.agentsearchhq.com, up to 25 searches/day per IP, subject to shared daily capacity, no payment), while agentsearch_extract and agentsearch_render make no network call and explain how to add a wallet.";
29
29
  const WEB_SEARCH_DESCRIPTION = [
30
30
  "Search the web with AgentSearch and return the response as pretty-printed JSON text.",
31
31
  "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).",
@@ -1 +1 @@
1
- {"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"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"}
1
+ {"version":3,"file":"search.js","sourceRoot":"","sources":["../../src/tools/search.ts"],"names":[],"mappings":"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"}
package/dist/version.d.ts CHANGED
@@ -1,3 +1,3 @@
1
1
  export declare const SERVER_NAME = "agentsearch-mcp";
2
2
  /** Keep in sync with package.json, manifest.json and server.json (checked by tests). */
3
- export declare const SERVER_VERSION = "1.3.3";
3
+ export declare const SERVER_VERSION = "1.3.4";
package/dist/version.js CHANGED
@@ -1,4 +1,4 @@
1
1
  export const SERVER_NAME = "agentsearch-mcp";
2
2
  /** Keep in sync with package.json, manifest.json and server.json (checked by tests). */
3
- export const SERVER_VERSION = "1.3.3";
3
+ export const SERVER_VERSION = "1.3.4";
4
4
  //# sourceMappingURL=version.js.map
package/manifest.json CHANGED
@@ -2,9 +2,9 @@
2
2
  "manifest_version": "0.3",
3
3
  "name": "agentsearch-mcp",
4
4
  "display_name": "AgentSearch (agentsearchhq.com)",
5
- "version": "1.3.3",
6
- "description": "Free web search out of the box (25/day); 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.",
7
- "long_description": "Stdio MCP server from AgentSearch. With no configuration, agentsearch_web_search uses the free AgentSearch relay (25 searches per day per user, search only); agentsearch_extract and agentsearch_render need a wallet key. 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.",
5
+ "version": "1.3.4",
6
+ "description": "Free web search out of the box (up to 25 searches/day per IP, subject to shared daily capacity); web search and page extract paid per call ($0.005 USDC on Base via x402), plus JS render, or self-hosted; plus the free AgentSearch Review Board.",
7
+ "long_description": "Stdio MCP server from AgentSearch. With no configuration, agentsearch_web_search uses the free AgentSearch relay (up to 25 searches/day per IP, subject to shared daily capacity, search only); agentsearch_extract and agentsearch_render need a wallet key. 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 for search and extract (gasless; no account or API key). The server never signs more than the per-call cap 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.",
8
8
  "author": {
9
9
  "name": "AgentSearch",
10
10
  "url": "https://github.com/agentsearchhq-coder"
@@ -60,7 +60,7 @@
60
60
  "tools": [
61
61
  {
62
62
  "name": "agentsearch_web_search",
63
- "description": "Search the web and return JSON text. Free with no config (relay, 25/day per user). 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."
63
+ "description": "Search the web and return JSON text. Free with no config (relay, up to 25 searches/day per IP, subject to shared daily capacity). 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."
64
64
  },
65
65
  {
66
66
  "name": "agentsearch_extract",
@@ -68,7 +68,7 @@
68
68
  },
69
69
  {
70
70
  "name": "agentsearch_render",
71
- "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."
71
+ "description": "Render one URL in headless Chromium and return title plus rendered markdown/text/HTML/links (optional screenshot) as JSON text. Pays 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."
72
72
  },
73
73
  {
74
74
  "name": "agentsearch_review_lookup",
@@ -83,7 +83,7 @@
83
83
  "AGENTSEARCH_WALLET_PRIVATE_KEY": {
84
84
  "type": "string",
85
85
  "title": "Wallet private key (pay per call)",
86
- "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.",
86
+ "description": "Optional. 64-hex private key of a NEW wallet holding a little USDC on Base. Enables search/extract ($0.005 per call) and render via the Pocket Network Agentic Portal (x402). Never logged.",
87
87
  "sensitive": true,
88
88
  "required": false
89
89
  },
package/package.json CHANGED
@@ -1,11 +1,11 @@
1
1
  {
2
2
  "name": "@agentsearchhq/agentsearch-mcp",
3
- "version": "1.3.3",
3
+ "version": "1.3.4",
4
4
  "mcpName": "io.github.agentsearchhq-coder/agentsearch-mcp",
5
5
  "publishConfig": {
6
6
  "access": "public"
7
7
  },
8
- "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",
8
+ "description": "MCP server: web search and page extract paid per call ($0.005 USDC on Base via x402) plus JS rendering, or self-hosted; free search up to 25/day per IP, plus the free AgentSearch Review Board",
9
9
  "type": "module",
10
10
  "main": "dist/index.js",
11
11
  "bin": {
package/server.json CHANGED
@@ -2,25 +2,25 @@
2
2
  "$schema": "https://static.modelcontextprotocol.io/schemas/2025-12-11/server.schema.json",
3
3
  "name": "io.github.agentsearchhq-coder/agentsearch-mcp",
4
4
  "title": "AgentSearch (agentsearchhq.com)",
5
- "description": "Free web search (25/day), plus paid extract/render at $0.005/call (x402) and a free Review Board.",
5
+ "description": "Free search: up to 25/day per IP, shared capacity. Paid extract $0.005/call (x402); Review Board.",
6
6
  "websiteUrl": "https://agentsearchhq.com/?utm_source=mcp-registry&utm_medium=directory&utm_campaign=listing",
7
7
  "repository": {
8
8
  "url": "https://github.com/agentsearchhq-coder/agentsearch-mcp",
9
9
  "source": "github"
10
10
  },
11
- "version": "1.3.3",
11
+ "version": "1.3.4",
12
12
  "packages": [
13
13
  {
14
14
  "registryType": "npm",
15
15
  "identifier": "@agentsearchhq/agentsearch-mcp",
16
- "version": "1.3.3",
16
+ "version": "1.3.4",
17
17
  "transport": {
18
18
  "type": "stdio"
19
19
  },
20
20
  "environmentVariables": [
21
21
  {
22
22
  "name": "AGENTSEARCH_WALLET_PRIVATE_KEY",
23
- "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",
23
+ "description": "Private key of a dedicated wallet with a little USDC on Base; pays $0.005 per search/extract call via the Pocket portal (x402). Alias: POCKET_PRIVATE_KEY",
24
24
  "isRequired": false,
25
25
  "isSecret": true,
26
26
  "format": "string"
package/smithery.yaml CHANGED
@@ -1,4 +1,4 @@
1
- # Smithery start command. Review tools work with no config. Search/extract/render pay $0.005 per call
1
+ # Smithery start command. Review tools work with no config. Search/extract pay $0.005 per call (render is paid too)
2
2
  # in USDC on Base via the Pocket Network Agentic Portal (x402) when a wallet key is set, or use your
3
3
  # self-hosted API when a base URL is set.
4
4
  startCommand:
@@ -8,7 +8,7 @@ startCommand:
8
8
  properties:
9
9
  walletPrivateKey:
10
10
  type: string
11
- 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.
11
+ description: Optional 64-hex private key of a NEW wallet holding a little USDC on Base. Pays $0.005 per search/extract call via x402. Never logged.
12
12
  maxTotalAtomic:
13
13
  type: string
14
14
  default: "1000000"