# AgentSearch (agentsearchhq.com)

> AgentSearch (agentsearchhq.com) is a freemium MCP server for web search and scraping. Web search, URL extract and page render for agents, paid per call over x402 on Base. It runs locally on your machine and is started by your AI client.

- **Kind:** MCP server
- **Pricing:** Freemium
- **Platforms:** CLI, API
- **Website:** https://agentsearchhq.com
- **Repository:** https://github.com/agentsearchhq-coder/agentsearch-mcp
- **MCP Registry name:** io.github.agentsearchhq-coder/agentsearch-mcp
- **Categories:** web search and scraping
- **Listing updated:** 2026-11-14

## About

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.

## Features

- **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

## Install

### Claude Code (Terminal)

```sh
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
```

### Claude Desktop (claude_desktop_config.json)

```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>"
      }
    }
  }
}
```

### Cursor (~/.cursor/mcp.json)

```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>"
      }
    }
  }
}
```

### VS Code (.vscode/mcp.json)

```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>"
      }
    }
  }
}
```

### Windsurf (~/.codeium/windsurf/mcp_config.json)

```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>"
      }
    }
  }
}
```

### Other clients (your client's MCP settings (most use this shape))

```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>"
      }
    }
  }
}
```

## Tools

- `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.

## 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

- [Scrapling MCP Server](https://ai-powered.com/mcp/scrapling-mcp-server): Scrapling MCP Server is an open-source MCP server for web search and scraping.
- [Firecrawl MCP Server](https://ai-powered.com/mcp/firecrawl-mcp-server): Firecrawl MCP Server is a freemium MCP server for web search and scraping.
- [SearXNG Search](https://ai-powered.com/mcp/searxng-search): SearXNG Search is an open-source MCP server for web search and scraping.
- [NeuralVerge](https://ai-powered.com/mcp/neuralverge): NeuralVerge is an MCP server for web search and scraping.
- [AI-Powered directory](https://ai-powered.com/mcp/ai-powered-directory): AI-Powered directory is a free MCP server for developer tools.
- [Shopify MCP Server (any store)](https://ai-powered.com/mcp/shopify-mcp-server-any-store): Shopify MCP Server (any store) is a paid MCP server for e-commerce.
- [Chanroll: YouTube Channel Video Scraper (Official API)](https://ai-powered.com/mcp/chanroll-youtube-channel-video-scraper-official-api): Chanroll: YouTube Channel Video Scraper (Official API) is a paid MCP server for design and media.
- [Vidvett: YouTube Video Details Scraper (Official API)](https://ai-powered.com/mcp/vidvett-youtube-video-details-scraper-official-api): Vidvett: YouTube Video Details Scraper (Official API) is a paid MCP server for design and media.

---
Source: https://ai-powered.com/mcp/agentsearch-agentsearchhq-com
