Repository navigation
Releases
v1.8.4
Docs/metadata only: README intro says paid search is $0.003 per call on the default direct route (was $0.005); manifest.json long description and the search/news tool descriptions say $0.003; llms-install states the direct per-call ceiling ($0.020; $0.005 on Pocket); .env.example paid search $0.003. Live direct prices: search/news $0.003, extract $0.002, render $0.005, screenshot $0.004, search_and_read $0.005. No behavior change.
v1.8.3
Docs/metadata only: all listings show live direct x402 prices (search/news $0.003, extract $0.002, screenshot $0.004, render $0.005, search_and_read $0.005). No behavior change.
v1.8.1
- Short queries fail fast: web search, news search and Search + Read reject queries under 2 characters (after trimming) before any request, telling the agent to rewrite the query instead of retrying. The API answers these with HTTP 400 QUERY_TOO_SHORT (never charged), but agents could loop on them.
- Free relay 4xx input errors (other than 429) are now reported with retryable: false and "fix the input instead of retrying unchanged".
npx -y @agentsearchhq/agentsearch-mcp@1.8.1
v1.8.0: news search, screenshots, search filters
Added
agentsearch_news_search: recent news articles (title, URL, snippet, domain, publish date) from AgentSearch's direct x402 API (POST /x402/v1/news, $0.008 / 8000 atomic USDC, empty results not charged).max_results1–10 plus filters.agentsearch_screenshot: PNG or JPEG of a public page (POST /x402/v1/screenshot, $0.010 / 10000 atomic USDC), returned as an MCP image content block plus JSON metadata (the base64 is not duplicated in the text). Options:format,full_page(clipped at 4000 px),viewport.- Search filters on paid
agentsearch_web_search,agentsearch_news_searchandagentsearch_search_and_read:freshness(day/week/month/year) ordate_from/date_to,country,language,include_domains,exclude_domains(up to 5 each). The free tier ignores them. - Extract options on the direct route:
max_charsis now forwarded (capped at the API's 50000) and newinclude_links(setfalseto save tokens). Before 1.8.0 the direct route droppedmax_chars.
Changed
- Direct prices in tool text and errors: extract $0.004 (was $0.007) and search_and_read $0.009 (was $0.015), matching the API. Search $0.008 and render $0.010 unchanged. The per-call ceiling stays $0.020.
Unchanged
- Free search, the extract/render free trial, the Pocket route ($0.005; search, extract and render only), self-hosted mode and review tools. News and screenshot are direct-only like Search + Read.
v1.7.0: search_and_read ($0.015) on the direct x402 API
Search + Read in one paid call on the direct x402 API: POST https://api.agentsearchhq.com/x402/v1/search_and_read at $0.015, charged only when at least one page returns text. Default 3 results (max 5), default 8000 characters per page (max 20000). About 48% less than a $0.008 search plus three $0.007 extracts ($0.029), and one payment instead of four.
Direct-only: not on Pocket, not on the free relay. Search itself stays free by default.
Direct per-call ceiling raised to $0.020 (20000 atomic USDC) so this call can settle. An old 10000 cap now refuses with a hint to raise it to 20000.
Docs: https://agentsearchhq.com/docs/x402#search-and-read
Page: https://agentsearchhq.com/search-and-read
Also: the MCP Registry publish workflow now waits up to 6 minutes for npm to have the new version, so a first-attempt E404 after npm publish no longer fails the job.
npm: https://www.npmjs.com/package/@agentsearchhq/agentsearch-mcp
v1.6.0: direct x402 is the default paid route
Direct x402 is now the default paid route: with a wallet key, paid calls go to AgentSearch's own x402 API on Base (https://api.agentsearchhq.com): search $0.008 (only with AGENTSEARCH_MODE=paid), extract $0.007, render $0.010. Wallet users now pay these direct prices, slightly more than the Pocket route's $0.005. Keep the Pocket route with AGENTSEARCH_PAYMENT_ROUTE=pocket (or AGENTSEARCH_X402_DIRECT=0). Free search and the no-wallet extract/render free trial are unchanged. See CHANGELOG.md.
1.5.0: opt-in direct x402
Opt-in direct x402: set AGENTSEARCH_X402_DIRECT=1 (with AGENTSEARCH_WALLET_PRIVATE_KEY) and paid calls go to AgentSearch's own x402 API on Base mainnet (https://api.agentsearchhq.com) instead of the Pocket portal: extract $0.007, render $0.010, search $0.008 (search only with AGENTSEARCH_MODE=paid). Signs only exact/USDC on Base to AgentSearch's pinned payee, max $0.010 per call, shared session cap. Default behavior unchanged. Docs: https://agentsearchhq.com/docs/x402
v1.4.0: Extract/Render free trial (no wallet)
Desktop Extension (.mcpb) package for Claude Desktop and other MCP Desktop Extension hosts. Matches npm @agentsearchhq/agentsearch-mcp 1.4.0.
- New: no-wallet free trial for Extract and Render. With no wallet key,
agentsearch_extract(5 calls/day per IP) andagentsearch_render(3 calls/day per IP, text output, no screenshots) use the AgentSearch free relay. Past the trial the tool returns the reason plus wallet setup steps: https://agentsearchhq.com/wallet-setup AGENTSEARCH_FREE_TRIAL=0turns the trial off (no-wallet extract/render then make no network call).- Unchanged: free web search (no env vars or key), the wallet paid path ($0.005 per call, USDC on Base via x402, per-call and session caps), self-hosted mode and the review tools.
- Install: download agentsearch-mcp-1.4.0.mcpb and open it in Claude Desktop, or run
npx -y @agentsearchhq/agentsearch-mcp.
v1.3.7
Desktop Extension (.mcpb) package for Claude Desktop and other MCP Desktop Extension hosts. Matches npm @agentsearchhq/agentsearch-mcp 1.3.7.
- Metadata only vs 1.3.6: MCP Registry and npm descriptions now name URL-to-markdown extract and JS render; README adds the search-then-read loop. No tool or code changes.
- Free web search works with no env vars or API key.
- Wallet key is optional, only for paid Extract/Render ($0.005 per call, USDC on Base via x402); key fields are marked sensitive in the manifest.
- Install: download agentsearch-mcp-1.3.7.mcpb and open it in Claude Desktop, or run
npx -y @agentsearchhq/agentsearch-mcp.
v1.3.6
Desktop Extension (.mcpb) package for Claude Desktop and other MCP Desktop Extension hosts. Matches npm @agentsearchhq/agentsearch-mcp 1.3.6.
- Free web search works with no env vars or API key.
- Wallet key is optional, only for paid Extract/Render; key fields are marked sensitive in the manifest.
- Install: download agentsearch-mcp-1.3.6.mcpb and open it in Claude Desktop, or run
npx -y @agentsearchhq/agentsearch-mcp.