Home › Search & Research › AgentSearch (agentsearchhq.com)

AgentSearch (agentsearchhq.com)

Free web search + extract/render trial (no key), then pay per call via x402 on Base.

TypeScript Cloud Remote
★ 0 stars Last pushed 2026-11-21 License: MIT

Topics: Search & Data Extraction

Connect

Review any command before running it. Package names and URLs come from the server's own registry entry.

Remote (streamable-http)

https://relay.agentsearchhq.com/mcp

Claude Code:

claude mcp add --transport http agentsearch-mcp https://relay.agentsearchhq.com/mcp

Or add to your MCP client config:

{
  "mcpServers": {
    "agentsearch-mcp": {
      "url": "https://relay.agentsearchhq.com/mcp"
    }
  }
}

Package (npm 1.8.7)

npx -y @agentsearchhq/[email protected]

Or add to your MCP client config:

{
  "mcpServers": {
    "agentsearch-mcp": {
      "command": "npx",
      "args": [
        "-y",
        "@agentsearchhq/[email protected]"
      ],
      "env": {
        "AGENTSEARCH_WALLET_PRIVATE_KEY": "<YOUR_VALUE>",
        "AGENTSEARCH_API_KEY": "<YOUR_VALUE>",
        "AGENTSEARCH_REVIEW_KEY": "<YOUR_VALUE>"
      }
    }
  }
}
  • AGENTSEARCH_WALLET_PRIVATE_KEY secret — Private key of a dedicated wallet with a little USDC on Base; enables paid extract/render via x402, paid to AgentSearch's own API by default (extract $0.002, render $0.005, search_and_read $0.005). Without it, extract/render use the free trial (5/3 calls per day per IP). Search stays free unless AGENTSEARCH_MODE=paid. Alias: POCKET_PRIVATE_KEY
  • AGENTSEARCH_MODE — Search mode: free (default; free relay even with a wallet key), paid (pay per search, $0.003 direct or $0.005 via Pocket; needs a key) or auto (paid search when a key is set)
  • AGENTSEARCH_FREE_TRIAL — Set to 0 to turn off the no-wallet extract/render free trial (then no-wallet extract/render make no network call). Default on
  • AGENTSEARCH_PAYMENT_ROUTE — Paid route: direct (default since 1.6.0; AgentSearch's own x402 API on Base, search $0.003, extract $0.002, render $0.005, search_and_read $0.005) or pocket (Pocket Network Agentic Portal, $0.005 per call)
  • AGENTSEARCH_X402_DIRECT — Legacy 1.5.0 switch: 0 selects the Pocket route (same as AGENTSEARCH_PAYMENT_ROUTE=pocket). Direct is already the default since 1.6.0
  • AGENTSEARCH_MAX_TOTAL_ATOMIC — Session spend cap in USDC atomic units (default 1000000 = $1.00). Alias: POCKET_MAX_TOTAL_ATOMIC
  • AGENTSEARCH_MAX_PER_CALL_ATOMIC — Optional lower per-call cap in USDC atomic units (hard max 20000 = $0.020 on the default direct route, 5000 = $0.005 on the Pocket route)
  • AGENTSEARCH_BASE_URL — Optional self-hosted AgentSearch API base URL; when set, search/extract/render use it with no payment
  • AGENTSEARCH_API_KEY secret — Optional Bearer token for your AgentSearch API
  • AGENTSEARCH_REVIEWS_URL — Optional Review Board URL (default https://reviews.agentsearchhq.com)
  • AGENTSEARCH_REVIEW_KEY secret — Optional Review Board key for weighted reviews

This repository has 2 servers listed in the Official MCP Registry.

Other names: com.agentsearchhq/search

Related servers

Listed in punkpeye/awesome-mcp-servers (MIT)

Data from the Official MCP Registry