After the free trial · native x402 on Base

Set up a wallet for AgentSearch in about 2 minutes

Search is free (up to 25 searches/day per IP) and Extract and Render have a small free trial (5 and 3 calls/day per IP). To keep going, your agent pays AgentSearch directly in USDC on Base over x402: search $0.008, extract $0.007, render $0.010 per call, with no account, plan or API key, and failed calls are never charged. $1 covers about 140 extracts. (Prefer Pocket Network? It's still there at $0.005 per call: see the note below.)

Four steps

Step 1

Create a new wallet used only for this

Make a fresh EVM wallet in any wallet app that supports Base. Do not reuse a wallet that holds other funds: the key goes into your agent's config, so keep only what you are willing to spend in it.

Step 2

Fund it with $1 of USDC on Base

Send about $1 of USDC on the Base network to the new address. No ETH is needed for gas; the x402 facilitator pays it. $1 covers about 140 extracts at $0.007 or 100 renders at $0.010.

Step 3

Set `AGENTSEARCH_WALLET_PRIVATE_KEY`

Export the new wallet's private key and put it in the MCP server env (below) or in your framework package's environment. For paid search too, also set AGENTSEARCH_MODE=paid; without it search stays on the free relay.

Step 4

Restart your client

Restart Claude Desktop, Cursor, VS Code or your agent. agentsearch_extract and agentsearch_render now pay automatically.

MCP config (Claude Desktop, Cursor, VS Code, Windsurf)

mcpServers entry

{
  "mcpServers": {
    "agentsearch": {
      "command": "npx",
      "args": ["-y", "@agentsearchhq/agentsearch-mcp"],
      "env": {
        "AGENTSEARCH_WALLET_PRIVATE_KEY": "0xYOUR_NEW_WALLET_KEY",
        "AGENTSEARCH_MODE": "paid"
      }
    }
  }
}

Spending limits built in

The server (agentsearch-mcp 1.6.0+) pays https://api.agentsearchhq.com, never signs more than $0.010 per call, and stops at a session cap of $1.00 by default, set with AGENTSEARCH_MAX_TOTAL_ATOMIC (USDC atomic units: 1000000 = $1.00). It signs only USDC on Base to AgentSearch's pinned payee. The API settles only after a successful, non-empty answer; 4xx, 429, 5xx and empty answers are not charged.

Python: pip install "langchain-agentsearch[paid]" (0.5.0+ pays the direct x402 API) and set the same env var; n8n: n8n-nodes-agentsearch 0.5.0+ with the AgentSearch Wallet API credential. crewai-agentsearch, llama-index-tools-agentsearch and openai-agents-agentsearch 0.3.0+ (same [paid] extra and env var) and LangChain.js @agentsearchhq/langchain 0.3.0+ pay the direct x402 API too. Any language or any x402 client: see the direct x402 docs (curl, @x402/fetch, Python).

Also on Pocket Network: to pay $0.005 per call through the Pocket Network Agentic Portal instead, add "AGENTSEARCH_PAYMENT_ROUTE": "pocket" to the MCP env (LangChain, LangChain.js, CrewAI, LlamaIndex, OpenAI Agents SDK: same env var; n8n: Payment Route = Pocket Portal).

Still trying it out?

No wallet needed for the free paths: search with POST https://relay.agentsearchhq.com/v1/search (25/day per IP), and try Extract (5/day) and Render (3/day) on the same relay. When a free limit is reached, the relay answers HTTP 429 and links back here. Limits reset at 00:00 UTC.