Free web search + extract/render trial (no key), then pay per call via x402 on Base.
Connect Runs on your machine
claude mcp add agentsearch-mcp -e AGENTSEARCH_WALLET_PRIVATE_KEY=<AGENTSEARCH_WALLET_PRIVATE_KEY> -e AGENTSEARCH_MODE=<AGENTSEARCH_MODE> -e AGENTSEARCH_FREE_TRIAL=<AGENTSEARCH_FREE_TRIAL> -e AGENTSEARCH_PAYMENT_ROUTE=<AGENTSEARCH_PAYMENT_ROUTE> -e AGENTSEARCH_X402_DIRECT=<AGENTSEARCH_X402_DIRECT> -e AGENTSEARCH_MAX_TOTAL_ATOMIC=<AGENTSEARCH_MAX_TOTAL_ATOMIC> -e AGENTSEARCH_MAX_PER_CALL_ATOMIC=<AGENTSEARCH_MAX_PER_CALL_ATOMIC> -e AGENTSEARCH_BASE_URL=<AGENTSEARCH_BASE_URL> -e AGENTSEARCH_API_KEY=<AGENTSEARCH_API_KEY> -e AGENTSEARCH_REVIEWS_URL=<AGENTSEARCH_REVIEWS_URL> -e AGENTSEARCH_REVIEW_KEY=<AGENTSEARCH_REVIEW_KEY> -- npx -y @agentsearchhq/[email protected]{
"mcpServers": {
"agentsearch-mcp": {
"command": "npx",
"args": [
"-y",
"@agentsearchhq/[email protected]"
],
"env": {
"AGENTSEARCH_WALLET_PRIVATE_KEY": "<AGENTSEARCH_WALLET_PRIVATE_KEY>",
"AGENTSEARCH_MODE": "<AGENTSEARCH_MODE>",
"AGENTSEARCH_FREE_TRIAL": "<AGENTSEARCH_FREE_TRIAL>",
"AGENTSEARCH_PAYMENT_ROUTE": "<AGENTSEARCH_PAYMENT_ROUTE>",
"AGENTSEARCH_X402_DIRECT": "<AGENTSEARCH_X402_DIRECT>",
"AGENTSEARCH_MAX_TOTAL_ATOMIC": "<AGENTSEARCH_MAX_TOTAL_ATOMIC>",
"AGENTSEARCH_MAX_PER_CALL_ATOMIC": "<AGENTSEARCH_MAX_PER_CALL_ATOMIC>",
"AGENTSEARCH_BASE_URL": "<AGENTSEARCH_BASE_URL>",
"AGENTSEARCH_API_KEY": "<AGENTSEARCH_API_KEY>",
"AGENTSEARCH_REVIEWS_URL": "<AGENTSEARCH_REVIEWS_URL>",
"AGENTSEARCH_REVIEW_KEY": "<AGENTSEARCH_REVIEW_KEY>"
}
}
}
}{
"mcpServers": {
"agentsearch-mcp": {
"command": "npx",
"args": [
"-y",
"@agentsearchhq/[email protected]"
],
"env": {
"AGENTSEARCH_WALLET_PRIVATE_KEY": "<AGENTSEARCH_WALLET_PRIVATE_KEY>",
"AGENTSEARCH_MODE": "<AGENTSEARCH_MODE>",
"AGENTSEARCH_FREE_TRIAL": "<AGENTSEARCH_FREE_TRIAL>",
"AGENTSEARCH_PAYMENT_ROUTE": "<AGENTSEARCH_PAYMENT_ROUTE>",
"AGENTSEARCH_X402_DIRECT": "<AGENTSEARCH_X402_DIRECT>",
"AGENTSEARCH_MAX_TOTAL_ATOMIC": "<AGENTSEARCH_MAX_TOTAL_ATOMIC>",
"AGENTSEARCH_MAX_PER_CALL_ATOMIC": "<AGENTSEARCH_MAX_PER_CALL_ATOMIC>",
"AGENTSEARCH_BASE_URL": "<AGENTSEARCH_BASE_URL>",
"AGENTSEARCH_API_KEY": "<AGENTSEARCH_API_KEY>",
"AGENTSEARCH_REVIEWS_URL": "<AGENTSEARCH_REVIEWS_URL>",
"AGENTSEARCH_REVIEW_KEY": "<AGENTSEARCH_REVIEW_KEY>"
}
}
}
}{
"servers": {
"agentsearch-mcp": {
"type": "stdio",
"command": "npx",
"args": [
"-y",
"@agentsearchhq/[email protected]"
],
"env": {
"AGENTSEARCH_WALLET_PRIVATE_KEY": "<AGENTSEARCH_WALLET_PRIVATE_KEY>",
"AGENTSEARCH_MODE": "<AGENTSEARCH_MODE>",
"AGENTSEARCH_FREE_TRIAL": "<AGENTSEARCH_FREE_TRIAL>",
"AGENTSEARCH_PAYMENT_ROUTE": "<AGENTSEARCH_PAYMENT_ROUTE>",
"AGENTSEARCH_X402_DIRECT": "<AGENTSEARCH_X402_DIRECT>",
"AGENTSEARCH_MAX_TOTAL_ATOMIC": "<AGENTSEARCH_MAX_TOTAL_ATOMIC>",
"AGENTSEARCH_MAX_PER_CALL_ATOMIC": "<AGENTSEARCH_MAX_PER_CALL_ATOMIC>",
"AGENTSEARCH_BASE_URL": "<AGENTSEARCH_BASE_URL>",
"AGENTSEARCH_API_KEY": "<AGENTSEARCH_API_KEY>",
"AGENTSEARCH_REVIEWS_URL": "<AGENTSEARCH_REVIEWS_URL>",
"AGENTSEARCH_REVIEW_KEY": "<AGENTSEARCH_REVIEW_KEY>"
}
}
}
}Replace the values in angle brackets with your own. Keys stay on your machine; we never see them.
Tools
This server runs locally, so its tools are listed by your MCP client once it starts.
Environment variables
| Name | Description |
|---|---|
AGENTSEARCH_WALLET_PRIVATE_KEYOptional, secret | Private 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.004, render $0.010, search_and_read $0.009). Without it, extract/render use the free trial (5/3 calls per day per IP). Search stays free unless AG… |
AGENTSEARCH_MODEOptional | Search mode: free (default; free relay even with a wallet key), paid (pay per search, $0.008 direct or $0.005 via Pocket; needs a key) or auto (paid search when a key is set) |
AGENTSEARCH_FREE_TRIALOptional | Set 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_ROUTEOptional | Paid route: direct (default since 1.6.0; AgentSearch's own x402 API on Base, search $0.008, extract $0.004, render $0.010, search_and_read $0.009) or pocket (Pocket Network Agentic Portal, $0.005 per call) |
AGENTSEARCH_X402_DIRECTOptional | Legacy 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_ATOMICOptional | Session spend cap in USDC atomic units (default 1000000 = $1.00). Alias: POCKET_MAX_TOTAL_ATOMIC |
AGENTSEARCH_MAX_PER_CALL_ATOMICOptional | Optional 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 | Optional self-hosted AgentSearch API base URL; when set, search/extract/render use it with no payment |
AGENTSEARCH_API_KEYOptional, secret | Optional Bearer token for your AgentSearch API |
AGENTSEARCH_REVIEWS_URLOptional | Optional Review Board URL (default https://reviews.agentsearchhq.com) |
AGENTSEARCH_REVIEW_KEYOptional, secret | Optional Review Board key for weighted reviews |
Details
| Package | @agentsearchhq/[email protected] (NPM, stdio) |
| First published | 11 Nov 2026 |
| Last updated | 11 Nov 2026 |
| Registry name | io.github.agentsearchhq-coder/agentsearch-mcp |
More ai and media servers See all
Listing data from the official MCP registry. Status and tools from NestDaddy's daily check. Browse all MCP servers.