Skip to content
MCP server

AgentSearch (agentsearchhq.com)

Web search, URL extract and page render for agents, paid per call over x402 on Base

Runs locallyStatus and history
Install
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-mcp

Add 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_KEY
  • AGENTSEARCH_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 on
  • AGENTSEARCH_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.0
  • AGENTSEARCH_MAX_TOTAL_ATOMICSession spend cap in USDC atomic units (default 1000000 = $1.00). Alias: POCKET_MAX_TOTAL_ATOMIC
  • AGENTSEARCH_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 payment
  • AGENTSEARCH_API_KEYOptional Bearer token for your AgentSearch API
  • AGENTSEARCH_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)

  1. MCP 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
  2. MCP server that lets AI agents search, scrape and interact with web pages

    • 3 tools
    • Remote
    • Freemium
    • 7.8K GitHub stars
    • Web search and scraping
  3. SearXNG Search

    MCP server

    MCP 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
  4. NeuralVerge

    MCP server

    Structured, source-tagged business and people data from 300+ sources for agents

    • 200 tools
    • Remote
    • Free trial
    • 1 GitHub star
    • Web search and scraping
  5. Search AI tools, agents and MCP servers and get install configs from inside your AI assistant.

    • 4 tools
    • Remote
    • Free
    • Developer tools
  6. Hosted MCP server that returns any Shopify store's products, prices and stock

    Not checked yet
    • 4 tools
    • Remote
    • Paid
    • E-commerce