Stellar Agent Search

Name: Stellar Agent Search
Author: berkingurcan

von berkingurcanVersion 0.1.0i★ –iLäuft auf deinem Computer

Name in der Registryio.github.berkingurcan/stellar-agent-search

Installieren

Überblick

Beschreibung vom Entwickler (englisches Original)

Discover and rank Stellar 8004 agents with a read-only MCP server and fail-closed contract probes.

Die drei Säulen von PopNx MCP

Diese drei werden nie zu einer Punktzahl zusammengefasst: Meinungen, Messungen und Beliebtheit sind verschiedene Dinge.

Stimmen der NutzeriNoch keine BewertungenBewertungen starten in einem späteren Schritt zusammen mit Benutzerkonten
Unsere Basischecksi1 von 1 bestandenAnhand öffentlicher Informationen geprüft; Code noch nicht gescannt
NutzungiNoch nicht gemessen★ –

Was du damit machen kannst

Für diesen Server haben wir noch keine Zusammenfassung in einfacher Sprache geschrieben. Unten stehen die Fakten, die wir aus der Registry gelesen haben.

Verbindung: Läuft auf deinem Computer
Transport: stdio
Kategorie: Suche & KI-Gedächtnis

Installation

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

Bevor du installierst

Basischecks: 1 von 1 bestanden
Läuft auf deinem Computer mit den Rechten deines Benutzerkontos (Dateien, Netzwerk, Apps).
Das trägst du selbst ein: STELLAR_NETWORK, EXPLORER_BASE_URL, STELLAR_RPC_URL, VERIFY_ONCHAIN

Du brauchst

npmNode.js installiert (für den Befehl npx)

Welche App nutzt du?

ClaudeClaude CodeCursorVS CodeChatGPT

Wähle oben deine App. Wir merken sie uns, damit der Button beim nächsten Mal „In … installieren“ anzeigt.

Öffne Claude Desktop → Settings → Developer → Edit Config und füge dies in claude_desktop_config.json ein

{
  "mcpServers": {
    "stellar-agent-search": {
      "command": "npx",
      "args": [
        "-y",
        "stellar-agent-search"
      ],
      "env": {
        "STELLAR_NETWORK": "your-value",
        "EXPLORER_BASE_URL": "your-value",
        "STELLAR_RPC_URL": "your-value",
        "VERIFY_ONCHAIN": "your-value"
      }
    }
  }
}

Führe das in deinem Terminal aus

claude mcp add stellar-agent-search --env STELLAR_NETWORK=your-value --env EXPLORER_BASE_URL=your-value --env STELLAR_RPC_URL=your-value --env VERIFY_ONCHAIN=your-value -- npx -y stellar-agent-search

Trag die leeren Werte ein, bevor du ihn startest.

In Cursor öffnen

Oder kopier die Einstellungen selbst

In .cursor/mcp.json in deinem Projekt oder in ~/.cursor/mcp.json einfügen

{
  "mcpServers": {
    "stellar-agent-search": {
      "command": "npx",
      "args": [
        "-y",
        "stellar-agent-search"
      ],
      "env": {
        "STELLAR_NETWORK": "your-value",
        "EXPLORER_BASE_URL": "your-value",
        "STELLAR_RPC_URL": "your-value",
        "VERIFY_ONCHAIN": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

In VS Code öffnen

Oder kopier die Einstellungen selbst

In .vscode/mcp.json in deinem Projekt einfügen

{
  "servers": {
    "stellar-agent-search": {
      "type": "stdio",
      "command": "npx",
      "args": [
        "-y",
        "stellar-agent-search"
      ],
      "env": {
        "STELLAR_NETWORK": "your-value",
        "EXPLORER_BASE_URL": "your-value",
        "STELLAR_RPC_URL": "your-value",
        "VERIFY_ONCHAIN": "your-value"
      }
    }
  }
}

Dein Browser fragt, ob er die App öffnen darf, dann zeigt die App die Einstellungen und bittet dich um Bestätigung. Schlüsselwerte bleiben leer, damit du sie selbst einträgst.

Dieser Server läuft auf deinem Computer, und ChatGPT kann sich nur mit Servern im Internet verbinden. Wähle eine andere App.

Deine Auswahl bleibt in einem Cookie auf diesem Gerät; kein Konto nötig.

Werte, die du selbst einträgst

STELLAR_NETWORK env
Stellar network to target: mainnet | testnet. testnet also requires EXPLORER_BASE_URL — the default explorer indexes mainnet only, and the server refuses to start on the mismatched pair.
EXPLORER_BASE_URL env
Override the stellar-8004 explorer API base URL.
STELLAR_RPC_URL env
Override the Soroban RPC URL used for the bounded Reputation-contract probe.
VERIFY_ONCHAIN env
Set to 'false' to skip the bounded contract probe; reputation fields remain Explorer-declared either way.

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

Was er kann

Läuft auf deinem Computer; die Tool-Liste erscheint nach der Installation in deiner KI-App.

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 7. Nov. 2026

✓ Bestanden
Entwickler passt zum Repo
Der Registry-Name wurde mit dem GitHub-Konto berkingurcan bestätigt, dem das Repo gehört
… Noch nicht geprüft
Wird noch gepflegt
Dieses Repo haben wir noch nicht von GitHub gelesen
… Noch nicht geprüft
Hat eine Lizenz
Dieses Repo haben wir noch nicht von GitHub gelesen
– Nicht zutreffend
Endpunkt antwortet
Dieser Server läuft auf deinem Computer; es gibt keinen Endpunkt im Internet
– Nicht zutreffend
Anmeldung mit OAuth
Läuft auf deinem Computer und nutzt stattdessen lokale Einstellungen
… Noch nicht geprüft
Keine versteckten Anweisungen in Tool-Beschreibungen
Läuft auf deinem Computer; Tool-Listen können wir nur von Endpunkten im Internet lesen

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

Mehr Sterne als 0 % der anderen 7275 Server in dieser Kategorie
Neuer in der Registry veröffentlicht als 26 % der anderen 7275 Server in dieser Kategorie
Basischecks gleich gut wie oder besser als bei 100 % der anderen 7275 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 Stellar Agent Search sicher?

Er hat 1 von 1 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 auf deinem Computer. Deine KI-App startet ihn bei Bedarf, und die Daten laufen nicht über die Server des Entwicklers (außer der Server ruft selbst einen Onlinedienst auf).

Wird er noch gepflegt?

Das GitHub-Repo wurde zuletzt – geändert, und die neueste Version (0.1.0) kam vor 3 Monaten in die Registry.

Welche Apps können ihn nutzen?

Apps, die MCP unterstützen, etwa Claude Desktop, Claude Code, Cursor und VS Code. Außerdem brauchst du Node.js auf deinem Computer.

Was kann ich stattdessen nutzen?

In derselben Kategorie: Context7, Codebase Memory, Exa

Alternativen

Server derselben Kategorie von anderen Entwicklern, sortiert nach Sternen.

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

Context7

von upstash

Up-to-date docs for AI agents

Computer oder Cloud★ 64.224MITAktualisiert gestern

Installieren

Codebase Memory

von DeusData

Codebase knowledge graph for AI agents — 162 languages, sub-ms queries, 99% fewer tokens.

Läuft auf deinem Computer★ 48.148MITAktualisiert vor 21 Tagen

Installieren

Exa

von exa-labs

Connect AI agents to Exa for web search, content fetching, and multi-step research.

Läuft in der Cloud★ 5.213MITAktualisiert letzten Monat

Installieren

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.

stellar-agent-search

A read-only discovery layer on top of the [stellar-8004](https://stellar8004.com) registry — the ERC-8004-style Identity/Reputation/Validation contracts on Stellar mainnet.

It adds no contracts and forks nothing: it exposes the existing on-chain registry to MCP clients, keeps indexed reputation explicitly declared-vs-verified, and proves the full agent-finds-agent loop with recorded mainnet transactions.

npm · GitHub · Docs · Evidence package

npm	MCP Registry	Remote endpoint	Mainnet proof
✅ `0.1.0`	✅ published & verified	⏳ not deployed yet	✅ x402 payment · feedback

There are two official interfaces, not two copies of the stack. TypeScript applications, registration, and signed writes use the canonical @trionlabs/stellar8004 SDK from trionlabs/stellar-8004; MCP clients and terminal discovery use this package, which exact-pins that SDK internally. The upstream repo's restricted Supabase Studio /mcp is database-operator tooling behind SSH/IP controls, not an agent-registry MCP and must never be exposed as this runtime. See the integration boundary.

A read-only, keyless MCP server (and human CLI) that lets an AI agent — or you — discover, rank, and vet on-chain [stellar-8004](https://stellar8004.com) agents on Stellar mainnet, then prepare an x402 (USDC pay-per-call) payment. One binary speaks the Model Context Protocol over stdio to Claude Code / Cursor / Windsurf / Cline / VS Code, and doubles as a plain-terminal tool. A separate Cloudflare Worker implementation exposes the same surface over stateless Streamable HTTP, but that remote endpoint is not live yet; use the local stdio transport until its deployment canary passes.

npx -y stellar-agent-search@0.1.0 find "a paid web scraper with a good reputation"

AI agents: read [AGENTS.md](AGENTS.md) first. It routes each goal to the right document: using the

tools, integrating from code, building a service other agents can find and pay

(provider guide), or changing this repo. Link index:

llms.txt · machine-readable schemas: mcp-surface.json.

Why this exists: declared data vs. what the chain read can prove

Off-chain agent directories (A2A cards, the MCP Registry, OASF, NANDA) list self-declared agents. That is exactly where the trust gap lives. A 2026 study of the ERC-8004 ecosystem (arXiv 2606.26028) found that only 3–15% of registrations have a live endpoint, and 59–91% of "reviewers" are Sybils.

stellar-8004 is the only non-EVM ERC-8004 implementation we are aware of running on mainnet (66 agents on Stellar mainnet as of July 2026; get_registry_stats returns the current count). No published survey enumerates non-EVM deployments — the study above restricts itself to Ethereum, BSC and Base, "the three chains with the highest registration and feedback volume" — so read that as unrefuted, not as proven. This server adds something a directory listing cannot give you: a bounded Reputation-contract reachability probe. The current path calls get_clients_paginated once with a six-slot observation window. The contract exposes no authoritative client count/cursor, and expired client-index entries create holes, so even an empty or short page cannot prove that no later live client exists. Calling get_summary over that set would manufacture a false match or mismatch; this release therefore does not call it and verifies no reputation fields. An attempted, reachable probe returns unavailable with reason client-set-exhaustion-unprovable; verifiedFields is empty and average, feedback count, and unique clients all remain unverified. verified/partial/mismatch are reserved for a future authoritative aggregate. The full status set remains verified | partial | mismatch | unavailable | skipped. Self-declared marketing text (name, description, service labels, feedback tags) remains untrusted data, never instructions (see Security).

That fail-closed boundary — plus a versioned declared-evidence heuristic — is the product. Normalized Explorer quality is multiplied by fixed evidence strength (0.4 × capped volume + 0.6 × effective breadth). Effective unique clients cannot exceed feedback rows, and repeated rows per declared client are capped. These are cost-of-manipulation proxies, not chain verification, proof of personhood, or Sybil resistance.

What it exposes

All three MCP primitives, all read-only:

Tools

Tier	Tool	What it does
0 · SOW	`find_agent`	Natural-language discovery → ranked candidates
	`rank_agent`	Rank an explicit id set or a query, full 3-axis declared-reputation breakdown + bounded chain reachability
	`get_agent_profile`	Deep profile: identity, capabilities, declared reputation + contract-probe limits, recent feedback, unverified A2A projection
	`list_services`	Self-declared x402/MPP endpoint candidates; liveness, ownership, conformance, and payment stay unverified
1 · complete-core	`list_agents`	Paginated, filterable listing, ranked
	`leaderboard`	Top agents in a bounded scan (client-side 3-axis rank + coverage)
	`resolve_agent`	Any handle (id / stellar:…#id / owner G-address) → canonical identifiers
	`get_agents_by_owner`	Current owner API page (up to 20 agents) with explicit continuation coverage
	`get_agent_feedback`	Recent on-chain reviews (sanitized, labeled)
	`verify_reputation`	Fail-closed Reputation-contract reachability probe; no current fields are verified
	`get_agent_card`	Derived, unverified A2A-shaped projection + x402 hint; not protocol-conformance proof
	`get_registry_stats`	Exact-count queries + capped sampled metrics, with definitions and coverage
	`get_registry_health`	Per-registry indexer staleness
2 · provider network	`get_provider_manifest`	A Provider Standard v1 provider's prices in USDC, network, payee and result retention; its binding to the on-chain registration and wallet; conformance badges from trusted validators

Full per-tool reference (inputs, outputs, defaults): [docs/tools.md](docs/tools.md).

Resources — `stellar8004://` (pinnable context)

registry · leaderboard · health · agent/{id} · agent/{id}/card · agent/{id}/feedback · agent/{id}/reputation · owner/{address}. Each returns a dual JSON + rendered-markdown payload.

Prompts — slash workflows

/find-and-vet-agent (flagship) · /vet-agent · /compare-agents · /prepare-x402-call · /explore-registry. prepare-x402-call lays out the exact x402 flow and stops before signing — this server holds no keys.

Quickstart

One-command MCP setup (Claude Code):

npx -y stellar-agent-search@0.1.0 setup --client claude --scope user --handshake

This downloads the package, registers a version-pinned npx -y stellar-agent-search@0.1.0 mcp stdio launch through Claude Code's own CLI, then performs a real MCP initialize + tools/list handshake. It is idempotent: rerun with --check --handshake to verify without changing config, or use --dry-run to preview the registration. Cursor and Codex examples, config paths, and scope limitations are in [docs/getting-started.md](docs/getting-started.md). Manual configs for other clients remain in [docs/integration.md](docs/integration.md).

Optionally install the skill first — the usage guide your agent reads before it calls anything:

npx skills add berkingurcan/stellar-agent-search --skill mcp

Terminal (human CLI):

npx -y stellar-agent-search@0.1.0 find "web scraper" --x402       # discover

npx -y stellar-agent-search@0.1.0 profile 10 # full profile for agent 10 npx -y stellar-agent-search@0.1.0 rank "scraping agents" --json # rank + fail-closed contract-probe status, machine-readable npx -y stellar-agent-search@0.1.0 services --x402 # declared paid-endpoint candidates npx -y stellar-agent-search@0.1.0 doctor # self-check: env, explorer, RPC, bounded read path npx -y stellar-agent-search@0.1.0 setup --client cursor --scope project --dry-run # preview client config

New here? Start with [docs/getting-started.md](docs/getting-started.md).

Remote endpoint status

The intended hosted URL is https://mcp.stellar8004.com/mcp. The Worker, transport tests, routing, and hardening are implemented, but the route has not been deployed: /mcp currently falls through to the landing site and returns 404. Deployment remains deliberately blocked until the Cloudflare rate-limit namespace is replaced from its sentinel value and a live canary proves that the original caller identity is preserved through the Service Binding. Do not configure a remote MCP client against that URL yet.

The landing page and MCP runtime are separate Workers. The assets-only landing Worker owns the mcp.stellar8004.com custom domain; exact /mcp and /healthz zone routes will send only those two paths to the runtime Worker. The runtime reads the existing stellar8004-web API through a Cloudflare Service Binding. It does not connect to Supabase, hold a service-role key, or create a second indexer. See [docs/architecture.md](docs/architecture.md) and [docs/stellar8004-integration.md](docs/stellar8004-integration.md).

Configuration

All configuration is via environment variables (canonical for MCP mode); CLI flags override them (precedence: flag → env → default).

Env var	Default	Purpose
`STELLAR_NETWORK`	`mainnet`	`mainnet` or `testnet`. With no other data source set, `testnet` reads its newest agents straight from the Identity contract, see below
`EXPLORER_BASE_URL`	`https://stellar8004.com` on mainnet	Explorer HTTP API base. Indexes mainnet only, so testnet never falls back to it
`REGISTRY_AGENT_IDS`	—	Registry mode over an allowlist: comma-separated agent ids (at most 50) read straight from the Identity contract, no explorer. Not combinable with `EXPLORER_BASE_URL` or `REGISTRY_SCAN_LIMIT`
`REGISTRY_SCAN_LIMIT`	`50` on testnet	Registry mode over the newest agents: how many (1–50) of the most recently registered agents lists and searches read. Testnet's default source; set it on mainnet to use it there instead of the explorer. Not combinable with `EXPLORER_BASE_URL` or `REGISTRY_AGENT_IDS`

| TRUSTED_VALIDATORS | — | Comma-separated G… or C… addresses (at most 20) of the verifiers whose Validation Reg

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

Stellar Agent Search

Überblick

Die drei Säulen von PopNx MCP

Was du damit machen kannst

Installation

Bevor du installierst

Werte, die du selbst einträgst

Was er kann

Basischecksi

Entwickler passt zum Repo

Wird noch gepflegt

Hat eine Lizenz

Endpunkt antwortet

Anmeldung mit OAuth

Keine versteckten Anweisungen in Tool-Beschreibungen

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

Häufige Fragen

Alternativen

Context7

Codebase Memory

Exa

README vom Entwickler

stellar-agent-search

Why this exists: declared data vs. what the chain read can prove

What it exposes

Tools

Resources — stellar8004:// (pinnable context)

Prompts — slash workflows

Quickstart

Remote endpoint status

Configuration

Resources — `stellar8004://` (pinnable context)