Stellar Agent Search MCP server
Discover and rank Stellar 8004 agents with a read-only MCP server and fail-closed contract probes.
1 stars31 downloads/wk
Reviews
Write oneNobody has reviewed Stellar Agent Search yet.
If you have run it, two minutes of your experience saves the next person an afternoon.
Stellar Agent Search tools (13)
write = sends, deletes, buys or postsRead from the package source without running it. The installed server may list more.
find_agentNatural-language discovery of on-chain Stellar (stellar-8004) agents. Returns a ranked list with capability/reputation signals. Use rank_agent for per-axis breakdowns and get_agent_profile for full detail. Agent names/descriptions are self-declared (unverified) and live only in each row's labeled `selfDeclared` slot.
get_agent_cardUnverified A2A-shaped projection from indexed Stellar 8004 metadata. It is not an agent-published AgentCard and proves neither A2A conformance nor endpoint ownership. Owner-authored metadata and service candidates are isolated under `card.selfDeclared`.
get_agent_feedbackRecent Explorer-indexed on-chain feedback for one agent (client-authored, untrusted \u2192 returned in a labeled `selfDeclared` slot, sanitized). Revoked entries are hidden unless includeRevoked is set.
get_agent_profileFull profile for one agent: typed identity, capabilities, declared scores, a rank breakdown, bounded Reputation-contract reachability status, recent feedback, the canonical stellar:{network}:{identity}#{id} handle, and an explicitly unverified derived A2A-shaped projection. The current probe verifies no reputation fields. No A2A conformance or endpoint ownership is implied; self-declared text is c
get_agents_by_ownerList the owner endpoint's current page (up to 20 agents), ranked by the 3-axis engine. Coverage explicitly reports whether more owner rows exist. Self-declared text lives in each row's labeled `selfDeclared` slot.
get_registry_healthPer-registry indexer health: last indexed ledger and staleness for the identity, reputation, and validation indexers. Staleness weakens the freshness of Explorer-declared data; it does not make a bounded contract read exhaustive.
get_registry_statsExplorer v1 registry counts plus sampled metrics, with explicit metric definitions, 5,000-agent sample cap, non-global distribution warning, and snapshot limitations.
leaderboardTop-ranked agents in a bounded registry scan (or filter), by the 3-axis engine, with per-axis `breakdown`. On-chain verification of the top rows is optional. Coverage states whether the scan exhausted the filtered set; self-declared text lives in each row's labeled `selfDeclared` slot.
list_agentsPaginated, filterable listing of registered agents, ranked by the 3-axis engine. Filter by x402/mpp/hasServices/trust/minExplorerScore. Self-declared text lives in each row's labeled `selfDeclared` slot.
list_servicesCatalog of self-declared service endpoint candidates, each with its owning agent's indexed owner-declared capability/trust signals and ranked score. Filter by x402/mpp/trust/minExplorerScore/search. No endpoint is probed for liveness, ownership, protocol conformance, or payment behavior. Service labels/endpoints are unverified and live in each row's labeled `selfDeclared` slot.
rank_agentRank an explicit agent set or a query's candidates using the deterministic declared-evidence policy: normalized indexed average \xD7 fixed evidence strength (0.4 capped volume + 0.6 breadth). Owner-declared capability fields add zero. On-chain checks are evidence metadata and never inflate rank. Every row carries a full per-axis `breakdown` and a declared-vs-verified `verification` block. Provide
resolve_agentResolve any agent reference (id, numeric string, stellar handle, or owner G-address) to the canonical typed identifiers (numeric id + stellar + CAIP-2). Owner addresses expand the current owner API page (up to 20); coverage reports whether more rows may exist.
verify_reputationFail-closed reputation observation for one agent. The current Reputation contract has no authoritative client-set count/cursor and expired index entries can create holes, so the server performs one bounded reachability read but does not call get_summary or claim a diff. Current attempted checks return unavailable with explicit scope; skipped means not attempted.
Public scan report
scanner v0.1.9 · 2026-09-24 · same rubric, same numbers if you re-run it
- Code scan2 source files scanned25/25
- –Live reliabilityno gateway calls yet and no remote to proben/a
- –Tool poisoningtools not inspected (local package is not executed); not countedn/a
- Auth qualitylocal package, no credentials required12/15
- Maintenancelast push 56 days ago12/15
- Maintainer identityregistry namespace matches repository owner; GitHub account older than a year8/10
What the publisher says
From the Stellar Agent Search repository's README, as published. We do not edit it. Read it on GitHub
stellar-agent-search
A read-only discovery layer on top of the stellar-8004 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
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 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"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.
Shortened. The full README is on GitHub.
Nothing above is checked by us. What we check is on the safety report.
Install directly
Runs npx -y stellar-agent-search on your machine. Read the scan report first; the gateway never runs local packages.
claude mcp add stellar-agent-search -- npx -y stellar-agent-search
Stellar Agent Search: common questions
- Is Stellar Agent Search MCP server safe?
- Yes, by our scan: it is graded A (88/100). Read the Stellar Agent Search safety report
- How do I install Stellar Agent Search?
- It runs on your machine. Copy the Claude Code, Claude Desktop or Cursor config from the install section.
- Does Stellar Agent Search need an API key?
- No secret keys are declared. It reads 4 settings from the environment.
- Is Stellar Agent Search maintained?
- The last commit was 57 days ago (2026-07-30). The latest release is v0.1.0.
- What can I use instead of Stellar Agent Search?
- Servers from other publishers that do the same job: three.ws Signals MCP server, Scholar Feed MCP server and DispatchSEO MCP server. Compare all Stellar Agent Search alternatives.
Alternatives to Stellar Agent Search
Same job from other publishers: the closest match first, then the best rated.
- three.ws SignalsDiscover signal feeds ranked by proven edge, rank publishers, and subscribe + track results.not reviewedEstablishedB
- Scholar FeedRank CS/AI/ML papers by citations, forecast impact, or code adoption; trace 23.2M citation edges.not reviewedEstablishedB
DispatchSEOOpen-source SEO manager for coding agents: keyword research, content PRs, rank + Search Console.not reviewedGrowingA- Log10x MCPTools to rank log patterns by volume and cost and to compact, tier down or offload each patternnot reviewedGrowingA
MencoroTrack how your brand appears in AI answers: rank, mentions, sentiment, share of voice.not reviewedGrowingA