Prototyp · Vorschau: alle Server aus der offiziellen Registry, alle 30 Minuten synchronisiert. Mit Google anmelden, um Bewertungen zu schreiben.Prototyp · alle 30 Min. aktualisiert
PopNx MCPMCP-Server für alle, die KI nutzen · in einfachen Worten erklärt Anmelden

AgentSearch (hosted, free)

✓ agentsearchhq.com

von agentsearchhq-coderVersion 0.1.2i★ 0iLäuft in der CloudOffizielle Website ↗
Name in der Registrycom.agentsearchhq/search

So installierst du es

Was es kann

Hosted web search for agents, plus extract and JS-render trials. No key; 25 free searches per IP.

Originaltext des Herstellers

  • Verbindung Läuft in der Cloud
  • Konto oder Schlüssel Kein Schlüssel nötig
  • Kategorie Suche & KI-Gedächtnis

Zusammen nutzen mit

Skills, die der KI diese Art Arbeit beibringen; sie funktionieren zusammen mit diesem

timesfm

TimesFM (Time Series Foundation Model) is a pretrained time-series foundation model developed by Google Research for time-series forecasting.

von google-research★ 35.6421 Skills

Skill · Anleitung

Shadowbroker

Open-source intelligence for the global theater. Track everything from the corporate/private jets of the wealthy, and spy satellites, to seismic events in one unified interface. Hook an AI agent up to have it parse through data and find previously unseen correlations. The knowledge is available to…

von BigBodyCobain★ 11.6081 Skills

Skill · Anleitung

google-maps-scraper

scrape data from Google Maps. Extracts data such as the name, address, phone number, website URL, rating, reviews number, latitude and longitude, reviews,email and more for each place

von gosom★ 8.2561 Skills

Skill · Anleitung

Warum es hier steht

Listen sind nach einem Nutzungswert (von 100) aus diesen Teilen sortiert

Beliebtheit0/80GitHub-Sterne oder wöchentliche Downloads: der größere Wert zählt 60, der kleinere 20
Aktualität12/12Volle Punkte für Release oder Codeänderung in 30 Tagen
Antwortet noch8/8Der Cloud-Endpoint antwortete bei der letzten Prüfung
Nutzungswert20/100

Qualität: 4/4 Basisprüfungen bestanden (angezeigt, nicht zur Sortierung) · Schwung: Noch keine Daten (Nur im Tab Im Trend verwendet)

Installation

Wähle die KI-App, die du nutzt, und kopiere die Einstellungen.

Mit einem Satz von deiner KI installieren lassen

Installiere bitte AgentSearch (hosted, free). Folge https://mcp.popnx.com/i/agentsearchhq-search.md, zeig mir die Befehle und warte auf mein OK, bevor du sie ausführst.

Füge ihn in eine KI ein, die auf deinem Rechner arbeitet (z. B. Claude Code oder Cursor). Sie liest unsere Schritte, zeigt dir die Befehle und wartet auf dein OK. Kein Schlüssel, keine Anmeldung. · Vollständigen Text ansehen

4/4 Prüfungen bestanden · Was du fragst, läuft über den Server des Anbieters (relay.agentsearchhq.com) · ✓ Befehle geprüft am 20. Nov. 2026

Zuerst: Welche KI nutzt du?

Wähle deine App, dann erscheinen die Schritte unten.

Klappt mit Claude · etwa 2 Min.

Kein Schlüssel, nichts zu installieren · Einmal auf claude.ai oder in der Desktop-App einrichten, dann im Chat nutzen · kostenlose Konten können 1 hinzufügen · bei Team/Enterprise fügt ein Owner ihn hinzu

  1. Öffne die Connectors-Seite von Claude

    CustomizeConnectors

    CustomizeConnectors1Add2https://…3Add4
  2. Klicke „Add“ → „Custom“ → „Web“ und fülle diese 2 Felder aus

    Kopiere jeden Wert in das gleichnamige Feld in Claude und klicke Continue

    Name · NameAgentSearch (hosted, free)
    Remote MCP server URL · Adressehttps://relay.agentsearchhq.com/mcp

    Klicke auf der von Claude erkannten Anmelde-Seite auf Continue · wähle bei Authentication, was der Anbieter angibt (Sign in now, Sign in when needed oder No sign in), dann Add

  3. Im Chat einschalten

    +ConnectorsAgentSearch (hosted, free)

  4. Ausprobieren

    Nutze AgentSearch (hosted, free) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude sagt, dass es AgentSearch (hosted, free) nutzt, oder ein Werkzeug von AgentSearch (hosted, free) in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit ChatGPT je nach Tarif

Volles MCP: ChatGPT Business, Enterprise oder Edu im Web · Pro: verbindet mit Lese-/Abrufrechten, Werkzeuge, die Daten ändern, gehen evtl. nicht · Plus: in der Doku nicht bestätigt; siehst du auf der Plugins-Seite eine Option für eigene MCP-Server, kannst du es versuchen · nur Web

  1. In ChatGPT im Web die Seite zum Hinzufügen von MCP öffnen

    Plugins+Add custom MCP server

    ChatGPTPlugins1+2https://…3Create4
  2. Name und Adresse eintragen

    Namen eingeben, Adresse unter Connection einfügen, Risikohinweis abhaken und Create as a plugin klicken

    Name · NameAgentSearch (hosted, free)
    Connection · Adressehttps://relay.agentsearchhq.com/mcp
  3. AgentSearch (hosted, free) im Chat auswählen

    Neuen Chat öffnen und vor dem Tippen AgentSearch (hosted, free) aus deinen Plugins wählen

  4. Ausprobieren

    Nutze AgentSearch (hosted, free) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn ChatGPT sagt, dass es AgentSearch (hosted, free) nutzt, oder ein Werkzeug von AgentSearch (hosted, free) in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von OpenAI abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Claude Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Terminal öffnen

    Mac: Command+Leertaste drücken und Terminal tippen · Windows: PowerShell öffnen

  2. Diesen Befehl einfügen und Enter drücken

    claude mcp add --transport http --scope user search https://relay.agentsearchhq.com/mcp
  3. /mcp in Claude Code eingeben

    AgentSearch (hosted, free) sollte in der Liste als verbunden erscheinen

  4. Ausprobieren

    Nutze AgentSearch (hosted, free) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Claude Code sagt, dass es AgentSearch (hosted, free) nutzt, oder ein Werkzeug von AgentSearch (hosted, free) in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Anthropic abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit Cursor · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button Cursor öffnen

    In Cursor öffnen

    Cursor fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in Cursor im Agent-Modus öffnen

  3. Ausprobieren

    Nutze AgentSearch (hosted, free) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn Cursor sagt, dass es AgentSearch (hosted, free) nutzt, oder ein Werkzeug von AgentSearch (hosted, free) in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von Cursor abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Klappt mit VS Code · etwa 2 Min.

Kein Schlüssel, nichts zu installieren

  1. Mit diesem Button VS Code öffnen

    In VS Code öffnen

    VS Code fragt nach einer Bestätigung; klicke Install

  2. KI-Chat in VS Code im Agent-Modus öffnen

  3. Ausprobieren

    Nutze AgentSearch (hosted, free) und sag mir, was du für mich tun kannst; zeig mir dann eine Sache

    ✓ Wenn VS Code sagt, dass es AgentSearch (hosted, free) nutzt, oder ein Werkzeug von AgentSearch (hosted, free) in der Antwort zeigt, bist du verbunden

Menünamen am 11. Nov. 2026 mit der Hilfe von VS Code abgeglichen · dein Bildschirm kann je nach App-Version leicht abweichen

Andere Apps mit MCP, etwa Windsurf, Zed oder Gemini CLI, fügen Server unterschiedlich hinzu. Sieh in der App-Liste nach

Alle Apps mit MCP ansehen →

Adresse für Apps, die über das Web verbinden

Adressehttps://relay.agentsearchhq.com/mcp

JSON-Einstellungen stehen unten unter „Für Entwickler“

Hängst du fest? Frag Leute, die AgentSearch (hosted, free) nutzen💬 Diskussion →
Für Entwickler: Terminal-Befehle und JSON-Einstellungen

Über das Web

Claude Code

claude mcp add --transport http --scope user search https://relay.agentsearchhq.com/mcp

Cursor (~/.cursor/mcp.json)

{
  "mcpServers": {
    "search": {
      "url": "https://relay.agentsearchhq.com/mcp"
    }
  }
}

VS Code (mcp.json)

{
  "servers": {
    "search": {
      "type": "http",
      "url": "https://relay.agentsearchhq.com/mcp"
    }
  }
}

Diese Einstellungen werden aus dem Registry-Eintrag des Entwicklers erzeugt. Wenn in der README etwas anderes steht, folge der README.

Auf einen Blick

Downloads pro Wochei
Nicht auf npm/PyPI
Bestätigte Domain
✓ agentsearchhq.com
Verbindung
Läuft in der Cloud
Transport
streamable-http
Neueste Versioni
0.1.2
In der Registry veröffentlichti
20. Nov. 2026
Code zuletzt geänderti
20. Nov. 2026
Zuletzt geprüft
20. Nov. 2026
Entwickler
agentsearchhq-coder
Registry-Status
Aktiv

Welche Apps ihn nutzen können

Basierend darauf, wie sich dieser Server verbindet, und auf der eigenen Doku jeder App, geprüft am 10. Nov. 2026.

Verbinden sich über das Internet in

ClaudeChatGPTGooseLM StudioMsty StudioCherry StudioCursorVS Code + GitHub CopilotVisual StudioWindsurf (Devin Desktop)ZedKiroClineContinueJetBrains AI AssistantClaude CodeCodex CLIGemini CLIOpenCodenodecodeWarpLibreChatOpen WebUIRaycast

Alle Apps, mit Vor- und Nachteilen →

Was er kann

Tool-Namen und -Beschreibungen genau so, wie der Server sie am 20. Nov. 2026 gemeldet hat. Geschrieben hat sie der Entwickler, nicht wir; wir zeigen sie als reinen Text.

  • agentsearch_web_search

    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 walle

  • agentsearch_extract

    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

  • agentsearch_render

    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 partia

Basischecksi

Wir prüfen Informationen, die jeder sehen kann; den Code haben wir nicht gelesen. Checks, die nicht zutreffen, werden nicht mitgezählt. · Geprüft am 20. Nov. 2026

  • ✓ Bestanden

    Entwickler passt zum Repo

    Der Registry-Name wurde über die Domain agentsearchhq.com bestätigt (die Registry prüft, wem die Domain gehört)

  • ✓ Bestanden

    Wird noch gepflegt

    Code zuletzt geändert: heute

  • – Nicht zutreffend

    Hat eine Lizenz

    Nicht relevant: Cloud-Server des Inhabers von agentsearchhq.com; du führst keinen Code aus dem Repo aus

  • ✓ Bestanden

    Endpunkt antwortet

    Antwort in 51 ms (HTTP 200)

  • – Nicht zutreffend

    Anmeldung mit OAuth

    Keine Anmeldung nötig

  • ✓ Bestanden

    Keine versteckten Anweisungen in Tool-Beschreibungen

    Wir haben 3 Tool-Beschreibungen gelesen und keine versteckten Anweisungen an die KI gefunden

Was wir prüfen → · JSON

Entwickler: neue Prüfung anfordern oder falsche Angaben melden
Für Anbieter: Badge ins README

Wenn du das gebaut hast, füge diesen Code in dein README ein. Das Badge verlinkt auf diese Seite.

[![Featured on PopNx MCP](https://mcp.popnx.com/badge/agentsearchhq-search.svg)](https://mcp.popnx.com/en/servers/agentsearchhq-search)

Diskussion

Fragen, Tipps teilen oder melden, dass etwas nicht geht. Sortiert nach „hilfreich“.

Noch keine Beiträge. Stell die erste Frage oder teile einen Tipp.

Beiträge hier stammen von Nutzern, nicht vom PopNx-Team.

Anmelden, um zu posten

Nutzerbewertungen

Noch keine Bewertungen

Anmelden, um eine Bewertung zu schreiben

Im Vergleich mit anderen in Suche & KI-Gedächtnisi

  • Mehr Sterne als 0 % der anderen 6485 Server in dieser Kategorie
  • Neuer in der Registry veröffentlicht als 99 % der anderen 6485 Server in dieser Kategorie
  • Basischecks gleich gut wie oder besser als bei 99 % der anderen 6485 Server in dieser Kategorie

Verglichen mit allen aktiven Servern dieser Kategorie in der Registry. Sterne zählen nur, wenn dem Herausgeber das Repo gehört.

Häufige Fragen

Ist AgentSearch (hosted, free) sicher?

Er hat 4 von 4 zutreffenden Basischecks bestanden. Den Code haben wir nicht gelesen. Bevor du einen Schlüssel oder Token hinzufügst, sieh nach, welche Zugriffe der Server verlangt, und nutze einen Schlüssel, der nur die Berechtigungen hat, die du brauchst.

Welche Schlüssel oder Codes braucht er?

Die Registry nennt keinen erforderlichen Schlüssel, manche Server bitten dich aber bei der ersten Nutzung, dich anzumelden.

Läuft er auf meinem Computer oder in der Cloud?

Er läuft in der Cloud des Entwicklers. Du verbindest dich übers Internet, ohne etwas zu installieren, aber was du sendest, läuft über die Server des Entwicklers.

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt heute geändert, und die neueste Version (0.1.2) kam heute in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Er verbindet sich per URL und funktioniert daher auch in Apps mit Remote-MCP, etwa ChatGPT im Web (volles MCP ab Business; Pro nur lesend).

Was kann ich stattdessen nutzen?

In derselben Kategorie: OpenSEO, Exa, Microsoft Learn MCP, Docs, COTAL actions (cotal.ai)

Ähnliche Alternativen

Gleiche Kategorie, andere Entwickler, Befehle bereits geprüft. Offizielle zuerst, dann nach Sternen.

So liest du eine Karte:↓ Downloads pro Wochei★ GitHub-SterneiDrei Säulen: Bewertungen · Checks · NutzungiAktualisiert = neueste Version in der Registry veröffentlichti

OpenSEO

Keyword research, site audits, rank tracking and AI visibility for your AI agent.

von every-appWeit verbreitet★ 28.384Aktualisiert vor 6 Tagen

Läuft in der Cloud✓ everyapp.com

Exa

Official Exa MCP for web search, content fetching, and multi-step research.

von exa-labsWeit verbreitet★ 5245Aktualisiert heute

Läuft in der Cloud✓ vom Dienst · exa.aiVom PopNx-Team ausprobiert

Microsoft Learn MCP

Official Microsoft Learn MCP Server – real-time, trusted docs & code samples for AI and LLMs.

von MicrosoftDocsWeit verbreitet★ 2000Aktualisiert vor 12 Monaten

Läuft in der Cloud✓ vom Dienst · microsoft.comVom PopNx-Team ausprobiert

Docs

Search and read Empryo's documentation. Read-only, no auth, no local access.

von proxysoulWachsend★ 1628Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ empryo.com

COTAL actions (cotal.ai)

cotal.ai actions: product overview, site search, build log, feedback, Cloud waitlist, updates, calls

von Cotal-AIWachsend★ 403Aktualisiert vor 2 Monaten

Läuft in der Cloud✓ vom Dienst · cotal.ai
Im Vergleich mit ähnlichen
Dieser
AgentSearch (hosted, free)
OpenSEOExaMicrosoft Learn MCPDocsCOTAL actions (cotal.ai)
Läuft woLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine InstallationLäuft in der Cloud, keine Installation
Braucht SchlüsselNeinNeinNeinNeinNeinNein
Mit + in Claude hinzufügenNeinJaJaJaNeinNein
Basisprüfungen4/45/52/44/44/44/4
LizenzMITMITMITCC-BY-4.0NOASSERTIONApache-2.0
PreisKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im RegisterKeine Kosten im Register

README vom Entwickler

README öffnen

Unverändert aus dem Repo des Entwicklers übernommen. PopNx MCP hat den Inhalt weder geprüft noch empfiehlt es ihn. HTML, Bilder und Skripte wurden entfernt. Links führen von dieser Website weg.

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, agentsearch_web_search uses the AgentSearch free tier (https://relay.agentsearchhq.com/v1/search): up to 25 searches/day per IP, 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, agentsearch_extract (5 calls/day per IP) and agentsearch_render (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 AGENTSEARCH_FREE_TRIAL=0 to turn the trial off.
  • Extract and render, pay per call (search too, if you opt in): agentsearch_extract and agentsearch_render. 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 AGENTSEARCH_MODE=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 AGENTSEARCH_PAYMENT_ROUTE=pocket for search, extract and render. Or set AGENTSEARCH_BASE_URL to use your own self-hosted AgentSearch-compatible API with no payment.
  • Search + Read, one paid call (new in 1.7.0): agentsearch_search_and_read searches the live web and returns the top pages as markdown for $0.005, versus $0.009 as one search plus three extracts, and one payment instead of four. Charged only when at least one page has text. Direct-only (not on Pocket or the free relay). Needs a wallet key. Docs: Search + Read.
  • News search and page screenshots, pay per call (new in 1.8.0): agentsearch_news_search returns recent articles with publish dates for $0.003, and agentsearch_screenshot returns a PNG/JPEG of any public page as an MCP image for $0.004 (viewport or full page, mobile sizes supported). Paid web search, news and Search + Read also take filters: freshness (day/week/month/year) or date_from/date_to, country, language, include_domains, exclude_domains. Extract takes include_links: false to save tokens. Direct-only; needs a wallet key.
  • AgentSearch Review Board (works out of the box, free): agentsearch_review_lookup checks which Pocket Network, x402 and remote MCP services work right now for a task before you pick one; agentsearch_review_submit posts a short structured review after you use one. No configuration or key needed; the board is at https://reviews.agentsearchhq.com.
npx -y @agentsearchhq/agentsearch-mcp   # free search + review tools work immediately

Search, then read the page. For hits and their text in one payment, use agentsearch_search_and_read ($0.005). Or the two-step loop: free agentsearch_web_search → agentsearch_extract on the 1–2 best URLs (clean markdown, $0.002 each; $1 covers about 500 calls) → agentsearch_render only for pages extract couldn't read (JavaScript apps). Guides: Claude Code research workflow, n8n AI agent reading pages, LangChain (Python) search-then-read.

Modes
Configagentsearch_web_searchagentsearch_extract / agentsearch_render
Nothing set (default)Free tier, up to 25 searches/day per IP, subject to shared daily capacityFree trial: 5 extract / 3 render calls per day per IP, then a 429 with wallet setup steps
AGENTSEARCH_FREE_TRIAL=0 (no wallet)Free tierReturn a message with how to add a wallet; no network call
AGENTSEARCH_WALLET_PRIVATE_KEYStill free (free tier, up to 25 searches/day per IP)Paid via AgentSearch's x402 API (extract $0.002, render $0.005)
AGENTSEARCH_WALLET_PRIVATE_KEY + AGENTSEARCH_MODE=paidPaid, $0.003 per call via AgentSearch's x402 APIPaid via AgentSearch's x402 API
...plus AGENTSEARCH_PAYMENT_ROUTE=pocketPaid search goes through the Pocket portal ($0.005)Paid via the Pocket portal ($0.005)
AGENTSEARCH_BASE_URL (takes precedence)Your self-hosted APIYour self-hosted API

To use paid Extract/Render, set AGENTSEARCH_WALLET_PRIVATE_KEY (a new wallet with a little USDC on Base) in this server's env and restart your client.

How the paid mode works (default: AgentSearch's direct x402 API, since 1.6.0)
ToolEndpointPrice (USDC on Base)
agentsearch_extractPOST https://api.agentsearchhq.com/x402/v1/extract$0.002
agentsearch_search_and_readPOST https://api.agentsearchhq.com/x402/v1/search_and_read$0.005
agentsearch_renderPOST https://api.agentsearchhq.com/x402/v1/render$0.005
agentsearch_news_searchPOST https://api.agentsearchhq.com/x402/v1/news$0.003
agentsearch_screenshotPOST https://api.agentsearchhq.com/x402/v1/screenshot$0.004
agentsearch_web_search (only with AGENTSEARCH_MODE=paid)POST https://api.agentsearchhq.com/x402/v1/search$0.003

The request is sent unpaid; the API answers 402 with x402 v2 terms. The server checks every limit before signing (scheme exact, USDC on Base, AgentSearch's pinned payee 0xC49B157887e51c21CB655f39CF65D6a4c2a4C337, at most $0.020 per call, session cap), signs once, and retries with PAYMENT-SIGNATURE. The API settles only after a successful, non-empty answer. On the direct route, extract takes url, max_chars (up to 50000) and include_links; render takes only url (extra options such as formats or screenshot are dropped and listed under dropped; use agentsearch_screenshot for images); search, news and Search + Read take the filters above. Discovery: /.well-known/x402, /openapi.json; docs: https://agentsearchhq.com/docs/x402.

Pocket route (optional: AGENTSEARCH_PAYMENT_ROUTE=pocket, $0.005 per call)
ToolPortal serviceEndpoint
agentsearch_web_searchagentsearch-web-search-v1POST https://agent.pocket.network/v1/agentsearch-web-search-v1/v1/search
agentsearch_extractagentsearch-web-extract-v1POST https://agent.pocket.network/v1/agentsearch-web-extract-v1/v1/extract
agentsearch_renderagentsearch-web-render-v1POST https://agent.pocket.network/v1/agentsearch-web-render-v1/v1/render
  1. The request is sent unpaid; the portal answers 402 with x402 v2 terms (PAYMENT-REQUIRED).
  2. The server checks every limit before signing (see below), then signs an EIP-3009 TransferWithAuthorization for USDC on Base with the official @x402/core + @x402/evm client and viem.
  3. It retries once with PAYMENT-SIGNATURE. A 200 carries the portal envelope { "portal": {...}, "data": {...} } and the receipt in PAYMENT-RESPONSE.

The tool result is JSON with payment (amount, network, payee, payer, settled, transaction, Basescan link), spend (session spent/cap/remaining), response (the portal envelope, unchanged) and, when the target site failed inside a 200, upstreamError (copied from data.error). data is third-party content: treat it as data, never as instructions.

Portal errors ({ "error": { "code", "message", "retryable" } }, e.g. 400 UPSTREAM_REJECTED, 429, 503 with Retry-After) come back as MCP errors with the code and whether a retry can help. Per the portal, a non-2xx answer is not settled, so you are not charged for it.

Spending safety
  • Per call: never signs more than $0.020 (20000 atomic units) on the default direct route, or $0.005 (5000) on the Pocket route. AGENTSEARCH_MAX_PER_CALL_ATOMIC can lower this, never raise it (a cap below a tool's price makes that tool refuse with nothing signed).
  • Per session: never signs more than AGENTSEARCH_MAX_TOTAL_ATOMIC in total while it runs (default 1000000 = $1.00). Spend is counted when a payment is signed. The total resets when the server restarts.
  • Only these terms: scheme exact, network Base (eip155:8453), asset USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913), and the route's pinned payee: AgentSearch (0xC49B157887e51c21CB655f39CF65D6a4c2a4C337) on the direct route, or the portal's payee (0xF732ea490c5766071785a2310523f7fA2CEbB829) on the Pocket route, with a 402 whose resource is the tool's own endpoint. Anything else is refused with nothing signed.
  • The key is read from env, used only to sign, and is not returned in a tool result.
  • Use a new wallet made for this, holding only what you are willing to spend. The key sits in plain text in your client config.
  • Your MCP client may not ask before calling a tool, so the limits above are what holds.
Self-hosted mode

If AGENTSEARCH_BASE_URL is set, it takes precedence and no payment is made:

  • Search: POST {AGENTSEARCH_BASE_URL}/v1/search with body { "query": "...", "max_results": 5 }
  • Extract: POST {AGENTSEARCH_BASE_URL}/v1/extract
  • Render: POST {AGENTSEARCH_BASE_URL}/v1/render (headless Chromium; OpenAPI spec)

Free relay: https://relay.agentsearchhq.com serves free search plus the small extract/render free trial. It is used automatically when nothing is configured; you do not need to set it as AGENTSEARCH_BASE_URL. For more than the trial, use paid mode (AGENTSEARCH_WALLET_PRIVATE_KEY) or self-host.


Tools

ToolArgsDescription
agentsearch_web_searchquery (string, required), max_results (number, optional, default 5, clamped 1–5)Web search. Returns pretty-printed JSON. Use for a query; use extract when you already have a URL. Read-only HTTP.
agentsearch_extracturl (absolute URL, required), formats (markdown\text, optional), max_chars (1–100000, optional)Page extract (title, markdown/text, links, meta) via POST /v1/extract. Use when you already have a URL. Read-only HTTP.

| agentsearch_render | url (absolute http(s) URL, required); optional: formats (markdown\|text\|html\|links, default ["markdown"]), max_chars (1–100000), screenshot, screenshot_format (png\|jpeg), full_page, viewport ({width 320–1920, height 240–1600}), wait_until (domcontentloaded\|load\|networkidle), wait_for_selector, wait_ms (0–1500), block (image\|media\|font\|stylesheet) | Renders a JavaScript-heavy page in headless Chromium via POST /v1/render and returns title, status, meta, and the rendered markdown/text/HTML/links (plus optional base64 screenshot). Use when extract returns empty/partial content for an SPA; prefer extract for static pages. Read-only HT

Nur der Anfang wird gezeigt; den Rest findest du im Repo