Pricing · $0.005 per call
AgentSearch Web Search, Web Extract and Web Render each cost $0.005 per call, paid in USDC on Base via x402, with no account, plan or API key. Search also has a free tier: up to 25 searches/day per IP, no key needed (shared daily capacity; paid calls have no cap).
Every service is priced per call. There is no subscription, minimum or monthly plan.
| Service | Price | Free tier | What it does |
|---|---|---|---|
Web Search agentsearch-web-search-v1 | $0.005 per call | Up to 25 searches/day per IP, no key | Up to 5 live results per call (title, URL, snippet, score, domain, date) |
Web Extract agentsearch-web-extract-v1 | $0.005 per call | None | A URL to clean markdown or text, with title, links and metadata |
Web Render agentsearch-web-render-v1 | $0.005 per call | None | Runs a JavaScript page in headless Chromium and returns markdown, text, HTML, links and an optional screenshot |
You pay only for answers that were delivered.
A delivered call is charged, including HTTP 200 answers whose body carries an error object because the target website failed: for example TARGET_HTTP_ERROR, TARGET_TIMEOUT, UNSUPPORTED_CONTENT, TARGET_BOT_WALL or a partial-content TARGET_DEADLINE. Search upstream errors that return 200 with empty results are charged too.
Non-2xx answers are not settled: 402 (unpaid request), 400 INVALID_REQUEST, SSRF_BLOCKED or URL_NOT_ALLOWED, 413 REQUEST_TOO_LARGE, 422 ROBOTS_DISALLOWED (Render refuses before fetching; through the portal it shows as 400 UPSTREAM_REJECTED), 422 TARGET_DEADLINE with nothing rendered, 429 rate limits and 5xx errors.
One search: $0.005. A page Extract can read: $0.005. Extract, then a Render fallback on the same URL: $0.01. A research task capped at 12 calls: at most $0.06. $1 of USDC covers 200 calls.
Full error table with the charged/not-charged column: llms-full.txt and agents.md.
Free tier: up to 25 searches/day per IP, no key needed (shared daily capacity; paid calls have no cap). The free tier covers Web Search only, with up to 5 results per search. It needs no account, API key or wallet. The limit resets daily, and past it the relay answers HTTP 429. Extract and Render have no free tier.
curl -s https://relay.agentsearchhq.com/v1/search \
-H 'content-type: application/json' \
-d '{"query":"Pocket Network","max_results":5}'{
"mcpServers": {
"agentsearch": {
"command": "npx",
"args": ["-y", "@agentsearchhq/agentsearch-mcp"]
}
}
}Payment is per request, in USDC on Base via x402, through the Pocket Network Agentic Portal. The agent pays from its own wallet instead of sending an API key.
Add npx -y @agentsearchhq/agentsearch-mcp to your MCP client and set AGENTSEARCH_WALLET_PRIVATE_KEY to a new wallet holding a little USDC on Base. It pays $0.005 per call automatically and never signs more than $0.005 per call or more than the session cap ($1.00 by default). No ETH is needed for gas.
1. POST unpaid to the portal endpoint and get HTTP 402 with x402 v2 terms in the PAYMENT-REQUIRED header. 2. Sign an EIP-3009 TransferWithAuthorization for 5000 USDC atomic units ($0.005) on Base with an x402 client such as @x402/core + @x402/evm. 3. Repeat the same request once with PAYMENT-SIGNATURE. 4. HTTP 200 returns {"portal": …, "data": …}, with the receipt in PAYMENT-RESPONSE.
The framework packages search free by default. For the Python packages, install the [paid] extra (for example pip install "langchain-agentsearch[paid]") and set AGENTSEARCH_WALLET_PRIVATE_KEY to enable paid search, Extract and Render. MPP on Tempo is also accepted by the portal.
curl -i https://agent.pocket.network/v1/agentsearch-web-search-v1/v1/search \
-H 'content-type: application/json' \
-d '{"query":"Pocket Network","max_results":5}'
# HTTP 402 + PAYMENT-REQUIRED header (base64 JSON x402 v2 terms):
# scheme exact, network eip155:8453 (Base), asset USDC, amount 5000 (= $0.005)import base64, json, requests
url = "https://agent.pocket.network/v1/agentsearch-web-search-v1/v1/search"
r = requests.post(url, json={"query": "Pocket Network", "max_results": 5}, timeout=30)
print(r.status_code) # 402: payment required, nothing charged
terms = json.loads(base64.b64decode(r.headers["PAYMENT-REQUIRED"]))
for option in terms["accepts"]:
print(option["scheme"], option["network"], option["amount"], option["asset"])
# exact eip155:8453 5000 0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913Web Search, Web Extract and Web Render each cost $0.005 per call in USDC on Base via x402. There is no account, subscription, minimum or API key.
Yes, for Web Search only. Free tier: up to 25 searches/day per IP, no key needed (shared daily capacity; paid calls have no cap). Use POST https://relay.agentsearchhq.com/v1/search or the MCP server npx -y @agentsearchhq/agentsearch-mcp with no wallet key.
Only HTTP 2xx answers are charged. Non-2xx answers such as 402, 400, 413, 422 robots.txt refusals, 429 and 5xx are not settled. A 200 answer whose body reports a target-site error, such as a 404 from the website, was delivered and is charged.
Your agent pays each request from a wallet. An unpaid request returns HTTP 402 with the price; an x402 client signs a USDC payment on Base and retries with the PAYMENT-SIGNATURE header. The AgentSearch MCP server and the framework packages can do this for you when you set AGENTSEARCH_WALLET_PRIVATE_KEY.
No. You need a little USDC on Base in a wallet made for this. The x402 facilitator pays the gas.
Yes. The AgentSearch MCP server never signs more than $0.005 per call and stops at a session cap, $1.00 by default, set with AGENTSEARCH_MAX_TOTAL_ATOMIC. In your own code, count delivered calls and stop at a hard budget.
Web Search API · Web Extract API · Web Render API · Pricing · MCP server · Blog