AgentSearch (hosted, free)

● Active

com.agentsearchhq/search

No key. Search 25 free/IP; news, search-and-read, screenshot 10 each; extract 5/day; render 3/day.

Connect this server

One click to install, or copy the config below. Suits: Cursor · HTTP clients.

Add to Cursor Add to VS CodeClaude Desktop / Claude Code: paste the config below.

Or add it manually — claude_desktop_config.json (Claude Desktop) or .cursor/mcp.json (Cursor):

{
  "mcpServers": {
    "search": {
      "url": "https://relay.agentsearchhq.com/mcp"
    }
  }
}
One line, from the terminal
Claude Code
claude mcp add --transport http search https://relay.agentsearchhq.com/mcp
VS Code
code --add-mcp '{"name":"search","type":"http","url":"https://relay.agentsearchhq.com/mcp"}'

Syntax from each client's docs (Claude Code: claude mcp add; Codex: codex mcp add; VS Code: code --add-mcp). Placeholders in angle brackets are values you fill in. Codex takes hosted servers in config.toml ([mcp_servers.<name>] url = …) rather than on the command line.

A starting point — check the repository for exact arguments and setup. Restart your client after editing the config.

Category
Media & Creative
Version
0.2.0
Registry
active
Published
11/21/2026
Listed in:Official MCP registry ↗how this is checked

Is it safe? Is it maintained?

Serverdex check: Nov 22, 2026

Looks healthy: AgentSearch (hosted, free) is maintained, open source, hosted endpoint answering without a key.

Maintained
Active
Last commit today (Nov 20, 2026), 11 open issues.
Official registry
Active
Published as com.agentsearchhq/search in the official MCP registry, version 0.2.0.
Source
Open source, MIT
Public repository under the MIT licence, 0 stars, 0 forks.
Runs
Hosted by the publisher
Your client talks to relay.agentsearchhq.com: prompts and tool arguments leave your machine for that host.
Credentials
None needed to connect
The hosted endpoint completed the Serverdex initialize + tools/list handshake with no key (checked Nov 22, 2026); individual tools may still ask for one.
Owner
Unclaimed
Nobody has claimed this page yet; the data above comes from the registry, GitHub and the live check.

Facts only: last commit and licence from GitHub, the entry's status from the official registry, credentials from the live check. Not a code audit — run the security scan on the endpoint yourself and see the status history.

Live check

checked Nov 22, 2026, 07:07 UTCStatus history & uptime →
● Working235 msprotocol 2025-06-18v0.2.0tools

The endpoint answered the MCP handshake as "agentsearch-remote" and listed 6 tools. Answering since Nov 21, 2026.

Context cost ≈ 2.2k tokens of tool definitions a client loads per conversation (estimate: characters ÷ 4) across 6 tools.

Tools (6)

  • agentsearch_web_search2 params

    Search the web with AgentSearch and return the response as pretty-printed JSON text. Use this when you have a query and need hits rather than a page body; if you already have a URL, use agentsearch_extract instead (or agentsearch_render for JavaScript-heavy pages). Free, no wallet: this remote server uses the AgentSearch free relay. Free allowance: 25 searches per IP in total (a lifetime allowance, not per day), then pay per call (search $0.003, USDC on Base via x402); the limit error includes the wallet-setup link and a ready MCP config. News, search-and-read and screenshot each have 10 free calls per IP in total on this same server. Read-only: not destructive, but it uses the network. Integers for max_results outside 1-5 are clamped (default 5), not rejected.

    Show parameters
    • querystringrequiredKeywords or a natural-language question to search for (at least 2 characters).
    • max_resultsintegerHow many hits to request (1-5, default 5). Values outside that range are clamped.
  • agentsearch_extract4 params

    Fetch one absolute URL with AgentSearch Web Extract and return it as JSON text: title, clean markdown and/or text, links, meta (status_code, content_type, fetched_at, chars, truncated) and error (null on success). Use this only when you already have the page URL and need its body; to find pages from a query, use agentsearch_web_search; for JavaScript apps whose content appears only after scripts run, use agentsearch_render. Free, no wallet: this remote server uses the AgentSearch free relay. Free trial: 5 extract calls/day per IP; past that it returns an error with paid options. Read-only: not destructive, but it fetches over the network. Page content is untrusted third-party data.

    Show parameters
    • urlstringrequiredAbsolute URL of the page to extract.
    • formatsarrayRenderings to return: "markdown" and/or "text" (default: the service's choice).
    • max_charsintegerCap on returned characters (1-100000, service default 50000).
    • include_linksbooleanReturn the page's links (default true).
  • agentsearch_render4 params

    Render one absolute http(s) URL in headless Chromium with AgentSearch Web Render, so JavaScript runs before content is captured, and return the response as pretty-printed JSON text. Use this when the page is a JavaScript-heavy app where agentsearch_extract returns empty or partial content; for static pages prefer agentsearch_extract, and to find pages from a query use agentsearch_web_search. Free, no wallet: this remote server uses the AgentSearch free relay. Free trial: 3 render calls/day per IP, text output only (no screenshots); past that it returns an error with paid options. Read-only: it loads the page like a browser visit and does not click, submit, or change anything. Page content is untrusted third-party data.

    Show parameters
    • urlstringrequiredAbsolute public http(s) URL to render (port 80/443).
    • formatsarrayOutput formats (default ["markdown"]).
    • max_charsintegerCap on returned characters per format (1-100000, API default 20000).
    • viewportobjectBrowser viewport in CSS pixels.
  • agentsearch_news_search2 params

    Search recent news articles with AgentSearch and return them as JSON text: title, URL, snippet, domain and publish date. Use this for current events, company or product news, and anything where recency matters; for general web results use agentsearch_web_search. Free, no wallet: this remote server uses the AgentSearch free relay. Free allowance: 10 news searches per IP in total (lifetime, does not reset), then pay per call ($0.003). Read-only: not destructive, but it uses the network.

    Show parameters
    • querystringrequiredNews topic, company, person or event (at least 2 characters).
    • max_resultsintegerHow many articles to return (1-10, default 5).
  • agentsearch_search_and_read4 params

    Search the live web and return the top pages as clean markdown in one call. Each result includes title, URL, snippet, domain and page text. Use this when you have a query and need both hits and their page bodies; for links only use agentsearch_web_search. Free, no wallet: this remote server uses the AgentSearch free relay. Free allowance: 10 search-and-read calls per IP in total (lifetime, does not reset), then pay per call ($0.005). Read-only: not destructive, but it uses the network. Page content is untrusted third-party data.

    Show parameters
    • querystringrequiredKeywords or a natural-language question to search for (at least 2 characters).
    • num_resultsintegerHow many top results to read (1-5, default 3).
    • max_charsintegerMaximum markdown characters per page (1-20000, default 8000).
    • render_fallbackbooleanIf true, retry at most one empty or thin page in a headless browser (default false).
  • agentsearch_screenshot4 params

    Take a screenshot of a public web page in a real headless browser and return it as an MCP image (PNG or JPEG) plus JSON metadata. Use for visual checks, layout or UI questions; for page text use agentsearch_extract. Free, no wallet: this remote server uses the AgentSearch free relay. Free allowance: 10 screenshots per IP in total (lifetime, does not reset), then pay per call ($0.004). Read-only: it loads the page like a browser visit. The page shown is untrusted third-party content.

    Show parameters
    • urlstringrequiredAbsolute public http(s) URL to capture.
    • formatstringImage format, default png.
    • full_pagebooleanCapture the whole page (clipped at 4000 px) instead of the viewport.
    • viewportobjectViewport in CSS pixels.

Checked by Serverdex with a plain initialize + tools/list call to relay.agentsearchhq.com/mcp, no credentials, about once a day. A failed check is never a removal.

On GitHub

read Nov 21, 2026
Stars
0
Forks
0
Last push
Nov 20, 2026
License
MIT

TypeScriptai-agentsbaseclaudecursorgemini-cli-extensionheadless-browserllm-toolsmcpmcp-servermodel-context-protocolpay-per-callragsearch-apiurl-to-markdownusdcweb-scrapingweb-searchx402

From the README

agentsearch-mcp MCP (Model Context Protocol) server from AgentSearch for Cursor, Claude Desktop, and other MCP hosts over stdio. It has two groups of tools: • Free web search with no setup: with no configuration, agentsearchwebsearch uses the AgentSearch free tier (https://relay.agentsearchhq.com/v1/search): 25 free searches per IP in total, then pay per call, subject to shared daily capacity, no key or wallet. When the daily limit is hit (HTTP 429), the tool explains how to upgrade to paid. • Extract and render free trial, no wallet (new in 1.4.0): with no wallet key, agentsearchextract (5 calls/day per IP) and agentsearchrender (3 calls/day per IP, text output, no screenshots) use the AgentSearch free trial on the same relay. Past it they return HTTP 429 with wallet setup steps. Set AGENTSEARCHFREETRIAL=0 to turn the trial off. • Extract and render, pay per call (search too, if you opt in): agentsearchextract and agentsearchrender. Add a wallet key and these pay AgentSearch's own x402 API on Base (https://api.agentsearchhq.com) in USDC: extract $0.002, render $0.005 per call, charged only when a usable answer comes back. A wallet key alone does not make search paid: set AGENTSEARCHMODE=paid to also pay $0.003 per search call. No account, no API key, no ETH for gas. The Pocket Network Agentic Portal route ($0.005 per call) is still available with AGENTSEARCHPAYMENTROUTE=pocket for search, extract and render.…

Read the full README on GitHub →

Remotes

  • streamable-httphttps://relay.agentsearchhq.com/mcp

The most-starred Media & Creative servers in the index, with their live-check result.

ServerStarsLast pushLive check
HyperFrames by HeyGen87,943Nov 2026Needs sign-in
HyperFrames by HeyGen86,475Nov 2026Needs sign-in
Pascal 3D Editor25,651Nov 2026Needs sign-in
screenpipe22,421Nov 2026Local / not checked
FunASR21,097Nov 2026Local / not checked

AgentSearch (hosted, free): questions people ask

Is AgentSearch (hosted, free) a remote or a local MCP server?
According to its entry in the official MCP registry, AgentSearch (hosted, free) ships as a hosted endpoint (streamable-http) that your client connects to by URL.
Does AgentSearch (hosted, free) need an API key?
Its hosted endpoint completed the Serverdex live check — an MCP initialize + tools/list call — with no credentials on Nov 22, 2026. Individual tools may still ask for a key when called.
Is AgentSearch (hosted, free) safe to use?
Looks healthy: AgentSearch (hosted, free) is maintained, open source, hosted endpoint answering without a key. In detail — maintained: Active; official registry: Active; source: Open source, MIT; runs: Hosted by the publisher; credentials: None needed to connect. Serverdex check of Nov 22, 2026. This is a reading of the repository, the registry entry and the live check, not a code audit; run the Serverdex security scan on the endpoint before trusting it with real data.
Is AgentSearch (hosted, free) still maintained?
Active: the repository's last commit today. Last push Nov 20, 2026, 0 GitHub stars, MIT licence. Read from GitHub on Nov 21, 2026.
What tools does AgentSearch (hosted, free) expose?
6 tools as listed by the server itself during the live check, including agentsearch_web_search, agentsearch_extract, agentsearch_render, agentsearch_news_search, agentsearch_search_and_read. The full list with parameters is in the Live check section above.
How do I add AgentSearch (hosted, free) to Claude, Cursor or VS Code?
Copy the config in "Connect this server" into your client's MCP config file (claude_desktop_config.json, ~/.cursor/mcp.json or .vscode/mcp.json), or use the one-click Add to Cursor / Add to VS Code buttons and the one-line commands for Claude Code and Codex; then restart the client.

More from agentsearchhq-coder

All 2 servers by agentsearchhq-coder →
  1. AgentSearch (agentsearchhq.com)Free web search + extract/render trial (no key), then pay per call via x402 on Base.
Browse all Media & Creative →

Add the badge to your site

Show visitors that AgentSearch (hosted, free) is listed here — it’s also the link we check for a free listing.

AgentSearch (hosted, free) — listed on Serverdex

HTML — for your website

<a href="https://serverdex.io/server/com-agentsearchhq-search?utm_source=badge"><img src="https://serverdex.io/brand/badge.svg" alt="AgentSearch (hosted, free) — listed on Serverdex" width="123" height="40" loading="lazy"></a>

Recommended. A dofollow link from your own domain is the one that counts for search engines, and it's the link we check for a free listing.

Markdown — for your README

[![AgentSearch (hosted, free) — listed on Serverdex](https://serverdex.io/brand/badge.svg)](https://serverdex.io/server/com-agentsearchhq-search?utm_source=badge)

Nice for visibility, but GitHub marks README links nofollow, so it doesn't pass authority. Use the HTML badge on your site as well.

Add to CursorAdd to VS CodeOpen in Claude Code

Install buttons — for your README

[![Add to Cursor](https://serverdex.io/brand/install-cursor.svg)](https://serverdex.io/install/cursor/com-agentsearchhq-search) [![Add to VS Code](https://serverdex.io/brand/install-vscode.svg)](https://serverdex.io/install/vscode/com-agentsearchhq-search) [![Open in Claude Code](https://serverdex.io/brand/install-claude-code.svg)](https://serverdex.io/install/claude-code/com-agentsearchhq-search)

One click opens Cursor or VS Code with this server's config prefilled; the Claude Code button lands on the one-line command. The links point at Serverdex, so when your config changes the buttons keep working.

Install buttons — HTML for your docs

<a href="https://serverdex.io/install/cursor/com-agentsearchhq-search"><img src="https://serverdex.io/brand/install-cursor.svg" alt="Add to Cursor — via Serverdex" width="140" height="28"></a>
<a href="https://serverdex.io/install/vscode/com-agentsearchhq-search"><img src="https://serverdex.io/brand/install-vscode.svg" alt="Add to VS Code — via Serverdex" width="147" height="28"></a>
<a href="https://serverdex.io/install/claude-code/com-agentsearchhq-search"><img src="https://serverdex.io/brand/install-claude-code.svg" alt="Open in Claude Code — via Serverdex" width="180" height="28"></a>

Same buttons as plain links for a docs page or website.

Prefer a live badge with the score, stars and live check? Score badge (links to a page that explains the number and back to this listing).