Skip to content
AgentSearch

AI agent web search, extract & render · Native x402 on Base

AgentSearch: web search, URL extract, JS rendering and search + read built for agents

AgentSearch gives AI agents live web search, URL-to-markdown extract, headless browser render and search + read paid per call in USDC on Base over native x402 (search $0.008, extract $0.007, render $0.010, search + read $0.015), with no account or API key, and search is free for up to 25 searches a day per IP, with no key, through the free relay or the MCP server: npx -y @agentsearchhq/agentsearch-mcp.

Pay AgentSearch directly at https://api.agentsearchhq.com from any x402 client; failed calls are never charged. Listed in the Coinbase x402 Bazaar. Also available on Pocket Network.

MCP (recommended): npx -y @agentsearchhq/agentsearch-mcp Direct x402: POST https://api.agentsearchhq.com/x402/v1/{search,extract,render,search_and_read}

Also on Pocket Network: agentsearch-web-search-v1 agentsearch-web-extract-v1 agentsearch-web-render-v1

For AI agents: agents.md llms.txt llms-full.txt Free search: curl -s https://relay.agentsearchhq.com/v1/search -H 'content-type: application/json' -d '{"query":"x402 protocol"}'

Free web search for your agent, no setup

Paste one block into your MCP client and restart it. Free search works with no env, no key and no wallet. Free tier: up to 25 searches/day per IP, no key needed (shared daily capacity; paid calls have no cap). For extract and render, add the optional AGENTSEARCH_WALLET_PRIVATE_KEY: extract $0.007, render $0.010 per call, paid in USDC on Base straight to AgentSearch over x402.

Claude Desktop claude_desktop_config.json
{
  "mcpServers": {
    "agentsearch": {
      "command": "npx",
      "args": [
        "-y",
        "@agentsearchhq/agentsearch-mcp"
      ]
    }
  }
}
Cursor .cursor/mcp.json
{
  "mcpServers": {
    "agentsearch": {
      "command": "npx",
      "args": [
        "-y",
        "@agentsearchhq/agentsearch-mcp"
      ]
    }
  }
}
VS Code .vscode/mcp.json
{
  "servers": {
    "agentsearch": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "@agentsearchhq/agentsearch-mcp"
      ]
    }
  }
}
Windsurf ~/.codeium/windsurf/mcp_config.json
{
  "mcpServers": {
    "agentsearch": {
      "command": "npx",
      "args": [
        "-y",
        "@agentsearchhq/agentsearch-mcp"
      ]
    }
  }
}
Optional: enable paid extract ($0.007) and render ($0.010)

Use a new wallet holding a little USDC on Base (no ETH needed). Since agentsearch-mcp 1.6.0 payments go straight to AgentSearch's x402 API; add "AGENTSEARCH_PAYMENT_ROUTE": "pocket" to pay $0.005 through Pocket instead. Same env key works in every client (VS Code: inside the server entry under servers).

Paid mode any client
{
  "mcpServers": {
    "agentsearch": {
      "command": "npx",
      "args": [
        "-y",
        "@agentsearchhq/agentsearch-mcp"
      ],
      "env": {
        "AGENTSEARCH_WALLET_PRIVATE_KEY": "0xYOUR_NEW_WALLET_KEY"
      }
    }
  }
}

Web tools for agents, one stack

Search the web, extract a URL, render a JavaScript page, or search and read the top pages in one call. Each one is a pay-per-call x402 endpoint on Base you can call from agents, MCP hosts, and RAG pipelines (Search, Extract and Render are also on Pocket Network).

New · Search + Read$0.015 · MainNet

Search and read in one paid call

Search the live web and get the top pages as markdown in a single x402 payment. $0.015 versus $0.029 a la carte (one search plus three extracts), and one payment instead of four. Charged only when at least one page has text.

POST /x402/v1/search_and_read
  • x402POST api.agentsearchhq.com/x402/v1/search_and_read
  • Price$0.015 / call · USDC on Base · no API key
  • Body{"query", "num_results"?}

Integrations

Drop AgentSearch into your agent framework. Search is free by default: up to 25 searches/day per IP, no key needed (shared daily capacity; paid calls have no cap). Add a wallet for paid search ($0.008), extract ($0.007), render ($0.010) and search + read ($0.015) per call on the direct x402 API. Search stays free by default.

FrameworkPackageInstall
LangChain (Python)langchain-agentsearchpip install langchain-agentsearch
LangChain.js@agentsearchhq/langchainnpm install @agentsearchhq/langchain @langchain/core
n8nn8n-nodes-agentsearchSettings → Community Nodes → n8n-nodes-agentsearch
CrewAIcrewai-agentsearchpip install crewai-agentsearch
LlamaIndexllama-index-tools-agentsearchpip install llama-index-tools-agentsearch
OpenAI Agents SDKopenai-agents-agentsearchpip install openai-agents-agentsearch

Which service should my agent call?

Use Search + Read when you want hits and their text in one payment. Or start with search, pull pages with extract, and switch to render when content only appears after JavaScript runs.

Search + Read: hits and text

One $0.015 call returns live results with each page as markdown. Cheaper and simpler than a search plus three extracts ($0.029, four payments).

Learn more →

Search: fresh sources

An AI agent search API for live web results. Ideal for LLM tool-use, autonomous research, and agent runtimes that need fresh sources—not stale training data.

Learn more →

Extract: clean context for RAG

A RAG URL extraction service: give it a URL, get clean text/markdown, title, links, and metadata ready for embeddings, citations, and long-context prompts.

Learn more →

Render: JavaScript-heavy pages

Headless Chromium runs the page's JavaScript, then returns the title, rendered text/markdown, and HTML (plus links and an optional screenshot). Built for dynamic page scraping, SPAs, and pages plain extract cannot see. $0.010 per call on the direct x402 API; also on Pocket Network.

Learn more →

Built so agents can find and call us

MCP for Claude, Cursor and agent hosts

Recommended: npx -y @agentsearchhq/agentsearch-mcp (npm). It adds agentsearch_web_search, agentsearch_extract and agentsearch_render. Search works free with no key or wallet (up to 25 searches per day per IP). Set AGENTSEARCH_WALLET_PRIVATE_KEY to a new wallet with a little USDC on Base to unlock extract ($0.007) and render ($0.010) per call, paid straight to AgentSearch over x402. The server never signs more than $0.010 per call or $1.00 per session by default.

Any x402 client can also call https://api.agentsearchhq.com directly (docs). Also on Pocket Network: Pocket's Agentic Portal MCP (npx -y @pocket-network/agentic-portal-mcp).

Native x402 payments

Every paid call settles in USDC on Base through the Coinbase CDP facilitator, straight to AgentSearch. Discovery: /.well-known/x402, /openapi.json, and the Coinbase x402 Bazaar. Also available on Pocket Network (MainNet).

What agents use AgentSearch for

Research agents use the web search API to find fresh sources and cite them. RAG pipelines use the URL to markdown API to turn pages into clean, chunkable context. When a site is a single-page app or a dashboard, the headless browser rendering API runs its JavaScript first. Guides and pricing comparisons are on the blog.

FAQ

What is AgentSearch?

AgentSearch gives AI agents live web search, URL-to-markdown extract and headless browser render, paid per call in USDC on Base over native x402 at api.agentsearchhq.com (search $0.008, extract $0.007, render $0.010), with no account or API key. It is also available on Pocket Network and works over HTTP, as an MCP server, or through LangChain, CrewAI, LlamaIndex, OpenAI Agents SDK and n8n packages.

How much does AgentSearch cost?

On the direct x402 API (api.agentsearchhq.com) Web Search is $0.008, Web Extract $0.007 and Web Render $0.010 per call, paid in USDC on Base and settled only after a successful answer. The same services are also on Pocket Network at $0.005 per call. See pricing.

Is there a free tier?

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). Send a POST request to https://relay.agentsearchhq.com/v1/search or use the MCP server with no wallet key. Extract and Render have a small no-wallet free trial (5 and 3 calls/day per IP), then cost $0.007 and $0.010 per call on the direct x402 API.

How do I install the MCP server?

Add npx -y @agentsearchhq/agentsearch-mcp to your MCP client config (Claude Desktop, Cursor, VS Code, Windsurf or any stdio host) and restart it. Search works with no env. To enable Extract and Render, set AGENTSEARCH_WALLET_PRIVATE_KEY to a new wallet holding a little USDC on Base. Copy-paste configs are in the quickstart.

Do I need an API key or an account?

No. Free search needs no key at all. Paid calls are paid per request from a wallet over x402, so there is no account, signup or API key to manage.

What are the service IDs?

agentsearch-web-search-v1, agentsearch-web-extract-v1, and agentsearch-web-render-v1 (JavaScript rendering in a headless browser), are the Pocket Network service IDs (MainNet; Render also on Beta TestNet). The primary paid endpoints are the direct x402 API: POST https://api.agentsearchhq.com/x402/v1/search, /x402/v1/extract and /x402/v1/render.

When should I use Render instead of Extract?

Use Extract for static pages. Use Render when content only appears after JavaScript runs (SPAs, dashboards, infinite-scroll lists): it returns the title, rendered text, and HTML from a real headless Chromium.

Who runs the API?

AgentSearch runs its own API and sells it directly over x402 on Base (Coinbase CDP facilitator); see direct x402 docs. The same services are also served on Pocket Network.