AgentSearch (agentsearchhq.com)
Web search, URL extract and page render for agents, paid per call over x402 on Base
- Pricing
- Freemium
- Platforms
- CLI, API
- Runs
- Locally
- Version
- 1.8.4
- Listing updated
- 3 days ago
About AgentSearch (agentsearchhq.com)
AgentSearch (agentsearchhq.com) is a freemium MCP server for web search and scraping. It runs locally on your machine and is started by your AI client.
Rather than a monthly plan, AgentSearch charges in USDC on Base using the x402 protocol: search is $0.008, extract $0.004, render $0.010 and search_and_read $0.009, with no account, and failed calls are not charged. A Pocket Network route can lower search to $0.005.
Without a wallet key, search is free for up to 25 searches a day per IP through a relay, and extract and render have a small trial (5 and 3 calls a day per IP). Tools named are agentsearch_web_search, agentsearch_extract, agentsearch_render, agentsearch_search_and_read, agentsearch_news_search, agentsearch_screenshot and review tools; search accepts date_from, date_to and include/exclude domains.
A wallet private key enables paid calls, and spend caps default to $1 per session. Use a dedicated wallet with a small balance.
Install
Run in a terminal
claude mcp add agentsearch-mcp --env AGENTSEARCH_WALLET_PRIVATE_KEY='<AGENTSEARCH_WALLET_PRIVATE_KEY>' --env AGENTSEARCH_API_KEY='<AGENTSEARCH_API_KEY>' --env AGENTSEARCH_REVIEW_KEY='<AGENTSEARCH_REVIEW_KEY>' -- npx -y @agentsearchhq/agentsearch-mcpAdd to claude_desktop_config.json
{
"mcpServers": {
"agentsearch-mcp": {
"command": "npx",
"args": [
"-y",
"@agentsearchhq/agentsearch-mcp"
],
"env": {
"AGENTSEARCH_WALLET_PRIVATE_KEY": "<AGENTSEARCH_WALLET_PRIVATE_KEY>",
"AGENTSEARCH_API_KEY": "<AGENTSEARCH_API_KEY>",
"AGENTSEARCH_REVIEW_KEY": "<AGENTSEARCH_REVIEW_KEY>"
}
}
}
}Add to ~/.cursor/mcp.json
{
"mcpServers": {
"agentsearch-mcp": {
"command": "npx",
"args": [
"-y",
"@agentsearchhq/agentsearch-mcp"
],
"env": {
"AGENTSEARCH_WALLET_PRIVATE_KEY": "<AGENTSEARCH_WALLET_PRIVATE_KEY>",
"AGENTSEARCH_API_KEY": "<AGENTSEARCH_API_KEY>",
"AGENTSEARCH_REVIEW_KEY": "<AGENTSEARCH_REVIEW_KEY>"
}
}
}
}Add to .vscode/mcp.json
{
"servers": {
"agentsearch-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agentsearchhq/agentsearch-mcp"
],
"env": {
"AGENTSEARCH_WALLET_PRIVATE_KEY": "<AGENTSEARCH_WALLET_PRIVATE_KEY>",
"AGENTSEARCH_API_KEY": "<AGENTSEARCH_API_KEY>",
"AGENTSEARCH_REVIEW_KEY": "<AGENTSEARCH_REVIEW_KEY>"
}
}
}
}Add to ~/.codeium/windsurf/mcp_config.json
{
"mcpServers": {
"agentsearch-mcp": {
"command": "npx",
"args": [
"-y",
"@agentsearchhq/agentsearch-mcp"
],
"env": {
"AGENTSEARCH_WALLET_PRIVATE_KEY": "<AGENTSEARCH_WALLET_PRIVATE_KEY>",
"AGENTSEARCH_API_KEY": "<AGENTSEARCH_API_KEY>",
"AGENTSEARCH_REVIEW_KEY": "<AGENTSEARCH_REVIEW_KEY>"
}
}
}
}Add to your client's MCP settings (most use this shape)
{
"mcpServers": {
"agentsearch-mcp": {
"command": "npx",
"args": [
"-y",
"@agentsearchhq/agentsearch-mcp"
],
"env": {
"AGENTSEARCH_WALLET_PRIVATE_KEY": "<AGENTSEARCH_WALLET_PRIVATE_KEY>",
"AGENTSEARCH_API_KEY": "<AGENTSEARCH_API_KEY>",
"AGENTSEARCH_REVIEW_KEY": "<AGENTSEARCH_REVIEW_KEY>"
}
}
}
}Configuration
AGENTSEARCH_WALLET_PRIVATE_KEYPrivate 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_KEYAGENTSEARCH_MODESearch 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_TRIALSet to 0 to turn off the no-wallet extract/render free trial (then no-wallet extract/render make no network call). Default onAGENTSEARCH_PAYMENT_ROUTEPaid 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_DIRECTLegacy 1.5.0 switch: 0 selects the Pocket route (same as AGENTSEARCH_PAYMENT_ROUTE=pocket). Direct is already the default since 1.6.0AGENTSEARCH_MAX_TOTAL_ATOMICSession spend cap in USDC atomic units (default 1000000 = $1.00). Alias: POCKET_MAX_TOTAL_ATOMICAGENTSEARCH_MAX_PER_CALL_ATOMICOptional 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_URLOptional self-hosted AgentSearch API base URL; when set, search/extract/render use it with no paymentAGENTSEARCH_API_KEYOptional Bearer token for your AgentSearch APIAGENTSEARCH_REVIEWS_URLOptional Review Board URL (default https://reviews.agentsearchhq.com)AGENTSEARCH_REVIEW_KEYOptional Review Board key for weighted reviews
Tools this server provides (8)
Taken from the project documentation; the running server may differ.
- agentsearch_web_search
- Web search.
- agentsearch_extract
- Turns a URL into markdown.
- agentsearch_render
- Renders a page in a headless browser.
- agentsearch_search_and_read
- Searches and reads results in one call.
- agentsearch_news_search
- News search.
- agentsearch_screenshot
- Captures a screenshot.
- agentsearch_review_lookup
- Looks up reviews on the Review Board.
- agentsearch_review_submit
- Submits a review.
What it does
- Free search
- 25 searches a day per IP without key or wallet.
- Extract and render
- Turn URLs into markdown or render JavaScript pages.
- Search and read
- Search and fetch results in one paid call.
- Spend caps
- Default session cap of $1 in USDC.
- Filters
- Date range and domain include/exclude on search.
Good for
- Give an agent live web search without an API key
- Read a page as clean markdown
- Render a JavaScript-heavy page
- Cap an agent's search spend
Pricing
Freemium
Free search up to 25/day per IP; paid calls $0.004 to $0.010 via x402
Prices change. Check agentsearchhq.com before you buy.
AgentSearch (agentsearchhq.com) FAQ
Do I need an account?
No; search works with no key or wallet, and paid calls use x402.
What are the prices?
Search $0.008, extract $0.004, render $0.010, search and read $0.009.
Is there a spending limit?
Yes, a session cap of $1 by default, adjustable by environment variable.
Is AgentSearch (agentsearchhq.com) free?
AgentSearch (agentsearchhq.com) has a free plan, with paid plans for more usage or features.
How do I add AgentSearch (agentsearchhq.com) to Claude Code?
Run this command in your terminal: claude mcp add agentsearch-mcp --env AGENTSEARCH_WALLET_PRIVATE_KEY='<AGENTSEARCH_WALLET_PRIVATE_KEY>' --env AGENTSEARCH_API_KEY='<AGENTSEARCH_API_KEY>' --env AGENTSEARCH_REVIEW_KEY='<AGENTSEARCH_REVIEW_KEY>' -- npx -y @agentsearchhq/agentsearch-mcp
What are the best alternatives to AgentSearch (agentsearchhq.com)?
The closest alternatives to AgentSearch (agentsearchhq.com) are Scrapling MCP Server, Firecrawl MCP Server, SearXNG Search, NeuralVerge and AI-Powered directory.
Alternatives to AgentSearch (agentsearchhq.com)

Scrapling MCP Server
MCP serverMCP server for AI clients to scrape sites with HTTP and stealth browser sessions
Runs locally- 17 tools
- Open source
- 104K GitHub stars
- Web search and scraping

Firecrawl MCP Server
MCP serverMCP server that lets AI agents search, scrape and interact with web pages
- 3 tools
- Remote
- Freemium
- 7.8K GitHub stars
- Web search and scraping

SearXNG Search
MCP serverMCP server for web search and page reading through a SearXNG instance
Runs locally- 3 tools
- Open source
- 1.4K GitHub stars
- Web search and scraping

NeuralVerge
MCP serverStructured, source-tagged business and people data from 300+ sources for agents
- 200 tools
- Remote
- Free trial
- 1 GitHub star
- Web search and scraping

AI-Powered directory
MCP serverSearch AI tools, agents and MCP servers and get install configs from inside your AI assistant.
- 4 tools
- Remote
- Free
- Developer tools

Shopify MCP Server (any store)
MCP serverHosted MCP server that returns any Shopify store's products, prices and stock
Not checked yet- 4 tools
- Remote
- Paid
- E-commerce