Skip to content
AgentSearch

Native x402 on Base · also on Pocket Network

Web search API for AI agents

AgentSearch Web Search gives agents, LLM search tools and RAG search pipelines live web results as structured JSON: up to 5 ranked results per call with title, URL, snippet, score, domain and date. Call it over HTTP on the direct x402 API ($0.005 per call; also on the Pocket Agentic Portal) or as an MCP web search tool.

Free: up to 25 searches/day per IP$0.005 per call (direct x402)USDC on Base via x402No account, no API keyagentsearch-web-search-v1

Try it free: no key, no wallet

Free tier: up to 25 searches/day per IP, no key needed (shared daily capacity; paid calls have no cap). It runs through the free AgentSearch relay, with up to 5 results per search, and needs no account or wallet either. Extract and Render have a small free trial, then cost $0.002 and $0.005 per call on the direct x402 API.

Free search over HTTP (works as-is)

curl -s https://relay.agentsearchhq.com/v1/search \
  -H 'content-type: application/json' \
  -d '{"query":"Pocket Network","max_results":5}'

Response shape (illustrative values)

{
  "query": "Pocket Network",
  "result_count": 5,
  "retrieved_at": "…",
  "results": [
    {
      "title": "…",
      "url": "https://…",
      "content": "…",
      "score": 0.9,
      "published_date": null,
      "domain": "…"
    }
  ]
}

Free search in Claude Desktop or Cursor

{
  "mcpServers": {
    "agentsearch": {
      "command": "npx",
      "args": ["-y", "@agentsearchhq/agentsearch-mcp"]
    }
  }
}

Free search in VS Code (.vscode/mcp.json)

{
  "servers": {
    "agentsearch": {
      "type": "stdio",
      "command": "npx",
      "args": ["-y", "@agentsearchhq/agentsearch-mcp"]
    }
  }
}

Paste the config, restart your client, and the agentsearch_web_search tool works with no env block. The free limit resets daily. When it is used up, the relay answers HTTP 429 and the MCP tool explains how to switch to paid. For search with no daily cap, set AGENTSEARCH_WALLET_PRIVATE_KEY to a new wallet holding a little USDC on Base: each call is then $0.005 via x402, paid to AgentSearch (set AGENTSEARCH_MODE=paid). Claude Desktop config: claude_desktop_config.json. Cursor: .cursor/mcp.json. More clients: homepage quickstart.

Use it as a web search MCP server

The recommended MCP server is npx -y @agentsearchhq/agentsearch-mcp (npm). Its agentsearch_web_search tool is free out of the box (up to 25 searches per day per IP), and with a wallet key and AGENTSEARCH_MODE=paid it pays $0.005 per call in USDC on Base (direct x402) for search with no daily cap, plus Extract and Render. It works in Claude Desktop, Cursor, VS Code, Windsurf and any stdio MCP host. Also on Pocket Network: Pocket's Agentic Portal MCP, npx -y @pocket-network/agentic-portal-mcp, with call_service on agentsearch-web-search-v1. Step by step: MCP web search guide for AI agents.

What it does

Structured results, not SERP HTML

A JSON-first alternative to a scraped SERP API: each result carries title, URL, content snippet, relevance score, domain and published date, ready for tool-use and citations.

Built for agent tool calls

One POST /v1/search with a query and optional max_results (1–5). Errors come back as a JSON error object with a retryable flag.

Pay per call, no signup

$0.003 per call in USDC on Base over native x402 at api.agentsearchhq.com (also on Pocket Network at $0.005). No account, plan or API key, so an agent with a wallet can start immediately.

When to use it vs. the other two

AgentSearch has three services. Pick by what your agent has in hand and where the content lives.

This page

Web Search

You have a question, not a URL. Get up to 5 ranked results with title, URL, snippet, score, domain and date.

Read a static page

Web Extract

You have a URL and the content is in the HTML the server sends: docs, blogs, news, most marketing pages. Fast and cheap.

Web Extract API →
Read a JavaScript page

Web Render

The content only appears after JavaScript runs: SPAs, dashboards, client-rendered lists. Headless Chromium renders it first.

Web Render API →

Paid request and response (direct x402, $0.005 per call)

Request (direct x402 API)

curl -X POST https://api.agentsearchhq.com/x402/v1/search \
  -H 'content-type: application/json' \
  -d '{"query":"Pocket Network","max_results":1}'
# → 402 Payment Required (PAYMENT-REQUIRED header, $0.003 USDC on Base).
#   An x402 client pays and retries; 200 returns the result.
# Also on Pocket Network ($0.005):
#   POST https://agent.pocket.network/v1/agentsearch-web-search-v1/v1/search

Response (trimmed)

{
  "portal": {
    "provenance": "third-party-supplier",
    "serviceId": "agentsearch-web-search-v1",
    "schemaCheck": "unchecked"
  },
  "data": {
    "query": "Pocket Network",
    "result_count": 1,
    "results": [
      {
        "title": "What is Pocket Network? | Messari by Blockworks",
        "url": "https://messari.io/project/pocket-network-2/profile",
        "content": "## About\n\nPocket Network is an open protocol …",
        "score": 0.93338853,
        "published_date": null,
        "domain": "messari.io"
      }
    ]
  }
}

Trimmed from the real captured example on the Agentic Portal service page. The portal wraps the supplier response in data; treat it as third-party content. Full schema: search OpenAPI spec.

How to connect

HTTP (recommended)

Direct x402 API (pay per call)

POST https://api.agentsearchhq.com/x402/v1/search. An unpaid request returns 402 with the terms in PAYMENT-REQUIRED; any x402 client (@x402/fetch, Python x402) pays $0.003 in USDC on Base and retries. Settled only after a successful answer. No account, no API key.

Direct x402 docs →
Also on Pocket Network

Pocket Agentic Portal

POST https://agent.pocket.network/v1/agentsearch-web-search-v1/v1/search at $0.005 per call over x402 (Base) or MPP (Tempo).

Open the portal page →
MCP (recommended)

AgentSearch MCP server

Add npx -y @agentsearchhq/agentsearch-mcp to Claude Desktop, Cursor, VS Code or Windsurf. Search is free with no config (up to 25 searches per day per IP); add AGENTSEARCH_WALLET_PRIVATE_KEY for paid search with no daily cap at $0.005 per call (also set AGENTSEARCH_MODE=paid; paid straight to AgentSearch over x402).

AgentSearch MCP on npm →
MCP (also works)

Pocket Agentic Portal MCP

npx -y @pocket-network/agentic-portal-mcp covers every Pocket service. Use describe_service and call_service on agentsearch-web-search-v1. It pays per call from a local wallet with spend limits.

Portal MCP setup →

Use cases

Research agents

Ground answers in fresh sources instead of stale training data, and cite the URLs you found.

RAG search

Find candidate documents for a question, then pull the best ones in full with Web Extract.

Coding assistants

Look up the latest library docs, changelogs and API references from Cursor or Claude Code through MCP.

FAQ

Is this a SERP API?

It does the job agents usually want from a SERP API, but it returns structured JSON results (title, URL, snippet, score, domain, date) instead of a search results page.

How many results do I get per call?

Up to 5. Set max_results from 1 to 5; values outside that range are clamped.

Is there a free tier?

Yes. Web Search has a free tier: up to 25 searches/day per IP, no key needed (shared daily capacity; paid calls have no cap). It runs through the free AgentSearch relay at https://relay.agentsearchhq.com/v1/search with no account or wallet. The AgentSearch MCP server, npx -y @agentsearchhq/agentsearch-mcp, uses it automatically when no wallet key is set. The limit resets daily; past it the relay answers HTTP 429. Extract and Render are not part of the free tier.

How much does it cost, and do I need an API key?

It costs $0.003 per call in USDC on Base over native x402 at api.agentsearchhq.com, and calls with no results are not charged. There is no account and no API key. The same service is also on Pocket Network at $0.005.

How do I use it as an MCP web search tool?

Add npx -y @agentsearchhq/agentsearch-mcp to your MCP client and restart it. The agentsearch_web_search tool works free with no config (up to 25 searches per day per IP). Set AGENTSEARCH_WALLET_PRIVATE_KEY to a new wallet with a little USDC on Base for paid search with no daily cap at $0.005 per call (also set AGENTSEARCH_MODE=paid; paid straight to AgentSearch over x402). Pocket's Agentic Portal MCP (npx -y @pocket-network/agentic-portal-mcp) also works, with call_service on agentsearch-web-search-v1.

Other AgentSearch services

Guides: How to give your AI agent web search with MCP · Search → Extract → Render: three web tools for AI agents