# Stellar Agent Search (npm · stellar-agent-search)

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

- Trust score: 75/100 (medium)
- Registry status: active
- Liveness: live
- Owner verified: no
- Last scored: 2026-08-03

## Components

- npm · `stellar-agent-search`: 75/100 (this document), [markdown](https://verifymcp.io/servers/berkingurcan-stellar-agent-search/stellar-agent-search.md), [page](https://verifymcp.io/servers/berkingurcan-stellar-agent-search/stellar-agent-search)

## Channel facts

- Registry: `npm`
- Package: `stellar-agent-search`
- Version: `0.1.0`
- Transport: `stdio`

## Trust breakdown

How this component scores in each security and reliability category. Every signal is checked automatically from public evidence about the published package, including repeated runs of it in an isolated sandbox, and we only credit what we can confirm. Scores are 0–100 per category. Scoring method: https://verifymcp.io/docs/scoring (what has changed: https://verifymcp.io/docs/scoring/changelog)

Scored 2026-08-03.

- **Supply Chain Security**: 88/100
  - No malware found by supply-chain analysis.
  - No known CVEs affecting this package version or its production dependencies.
  - No install/post-install scripts declared.
  - 59 of 59 dependencies flagged as unhealthy (59 deprecated).
- **Provenance & Transparency**: 97/100
  - Source repository is publicly reachable at the declared URL.
  - Cryptographically verified build provenance (signed, bound to berkingurcan/stellar-agent-search).
  - Clear OSI-approved license (MIT).
  - Actively maintained (last published 4 days ago).
  - Disclosure check failed: no security disclosure policy was found in the source repository.
- **Schema Quality & AI Usability**: 75/100
  - 100% of prompts and resources have a non-trivial description (not blank, and not just the item's name).
  - AI-judged instruction clarity (good).
  - Context-footprint check failed: tool/resource definitions use about 2089 tokens (~130/item across 16 items; 13 tools + 3 resources), over budget; trim descriptions and params.
  - Usage-examples check failed: none of the tools include examples.
- **Stability & Change Management**: 0/100
  - Stability not yet verified: not enough scan history yet (needs a 30-day window).
- **Tool Coverage**: 88/100
  - 100% of tools have a non-trivial description (not blank, and not just the tool's name).
  - 60% of tool parameters carry a description.
  - Structured output schemas are declared (100% of tools); any adoption earns full credit.
- **Capabilities**: 100/100
  - Implements a supported MCP spec version (2025-11-25); the latest is 2026-07-28.

**Unverified: 1 category.** A category scored 0 because we could not verify it: a data source with nothing on this package, evidence we could not reach, or a check we could not run. We only credit what we can confirm.

## Install

### Claude

```bash
claude mcp add berkingurcan-stellar-agent-search -- npx -y stellar-agent-search
```

### Codex

```bash
codex mcp add berkingurcan-stellar-agent-search -- npx -y stellar-agent-search
```

### opencode

```json
{
  "$schema": "https://opencode.ai/config.json",
  "mcp": {
    "berkingurcan-stellar-agent-search": {
      "type": "local",
      "command": [
        "npx",
        "-y",
        "stellar-agent-search"
      ],
      "enabled": true
    }
  }
}
```

### OpenClaw

```bash
openclaw mcp add berkingurcan-stellar-agent-search --command npx --arg -y --arg stellar-agent-search
```

### Hermes

```yaml
mcp_servers:
  berkingurcan-stellar-agent-search:
    command: "npx"
    args: ["-y", "stellar-agent-search"]
```

### Other

```json
{
  "mcpServers": {
    "berkingurcan-stellar-agent-search": {
      "command": "npx",
      "args": [
        "-y",
        "stellar-agent-search"
      ]
    }
  }
}
```

## Changelog

Every change recorded for this component, newest first. Days that predate change tracking, or that we cannot explain, say so: "we were watching and nothing happened" and "we were not watching" are different claims.

### 2026-08-02 (score 75, +70)

- [security improvement] Install scripts: unverified → pass
- [security improvement] Provenance: unverified → pass
- [security improvement] Known CVEs: unverified → pass
- [security improvement] Malware scan: unverified → pass
- [security] Stability: Stability not yet verified: not enough scan history yet (needs a 30-day window).
- [security] The attested source repository moved: berkingurcan/stellar-agent-search
- [functional regression] Security disclosure: unverified → fail
- [functional improvement] License: unverified → pass
- [functional improvement] Dependency health: unverified → 0.00
- [functional improvement] Maintenance: unverified → pass
- [functional improvement] MCP protocol: unverified → pass
- [functional improvement] Schema quality: unverified → good
- [functional improvement] Tool coverage: unverified → 100
- [functional improvement] Schema quality: unverified → 100
- [functional] Licence: MIT

### 2026-08-01 (score 5, −19)

- [functional regression] Security disclosure: fail → unverified
- [functional regression] Tool coverage: 100 → unverified
- [functional regression] Schema quality: 100 → unverified

### 2026-07-31 (score 24, −17)

- [functional] We updated how we score, so this day's move reflects our rubric, not a change to the server

### 2026-07-30 (score 41)

First indexed and scored.

## MCP tools (13)

### `find_agent` (~247 tokens)

Find Agent

Natural-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.

Input parameters:

- `hasServices` (boolean): When present, require owner-declared service endpoint candidates.
- `limit` (integer)
- `minExplorerScore` (number): Minimum upstream v1 Explorer total_score in protocol units; not local rank.
- `minScore` (number): Deprecated ambiguous input; rejected. Use minExplorerScore.
- `mpp` (boolean): When present, require MPP micropayment support.
- `query` (string, required): Natural-language description, e.g. 'a paid web scraper with a good reputation'.
- `sortBy` (string)
- `trust` (string): Require a trust model.
- `verify` (boolean): Probe the Reputation contract for the top results (slower; current probe verifies no reputation fields).
- `x402` (boolean): When present, require x402 (USDC pay-per-call) support.

Output parameters:

- `agents` (array)
- `count` (number)
- `coverage` (object)
- `interpretedQuery` (object)

### `rank_agent` (~216 tokens)

Rank Agent

Rank an explicit agent set or a query's candidates using the deterministic declared-evidence policy: normalized indexed average × 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 EITHER agentIds OR query.

Input parameters:

- `agentIds` (array): Explicit agent ids to rank (maximum 50 on this transport). Provide EITHER agentIds OR query, not both.
- `limit` (integer)
- `query` (string): Natural-language query whose candidates are ranked. XOR with agentIds.
- `sortBy` (string)
- `verify` (boolean): Attempt the bounded Reputation-contract probe (default on; current probe verifies no reputation fields).
- `weights` (object): Deprecated and rejected when supplied. The v1 policy fixes evidence weights at volume=0.4 and breadth=0.6.

Output parameters:

- `agents` (array)
- `count` (number)
- `coverage` (object)
- `evidenceWeights` (object)
- `rankVersion` (string)

### `get_agent_profile` (~152 tokens)

Get Agent Profile

Full 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 confined to labeled `selfDeclared` slots.

Input parameters:

- `agent` (required): Numeric agent id, numeric string, or a full stellar:{network}:{identity}#{id} handle.
- `feedbackLimit` (integer)
- `verify` (boolean): Attempt the bounded Reputation-contract probe (default on; current probe verifies no reputation fields).

Output parameters:

- `agentCard` (object)
- `feedbackCoverage` (object)
- `profile` (object)
- `recentFeedback` (object)
- `verification` (object)

### `list_services` (~203 tokens)

List Services

Catalog 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.

Input parameters:

- `limit` (integer)
- `minExplorerScore` (number): Minimum upstream v1 Explorer total_score in protocol units; not local rank.
- `minScore` (number): Deprecated ambiguous input; rejected. Use minExplorerScore.
- `mpp` (boolean): When present, only MPP micropayment services.
- `page` (integer)
- `search` (string): Free-text filter over agent name/description.
- `trust` (string)
- `x402` (boolean): When present, only x402 (USDC pay-per-call) services.

Output parameters:

- `count` (number)
- `coverage` (object)
- `page` (number)
- `services` (array)

### `list_agents` (~181 tokens)

List Agents

Paginated, 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.

Input parameters:

- `hasServices` (boolean)
- `limit` (integer)
- `minExplorerScore` (number): Minimum upstream v1 Explorer total_score in protocol units; not local rank.
- `minScore` (number): Deprecated ambiguous input; rejected. Use minExplorerScore.
- `mpp` (boolean): When present, require indexed MPP support.
- `page` (integer)
- `sortBy` (string)
- `trust` (string)
- `verify` (boolean): Probe the Reputation contract for the top results; current probe verifies no reputation fields.
- `x402` (boolean)

Output parameters:

- `agents` (array)
- `count` (number)
- `coverage` (object)
- `page` (number)
- `pagination` (object)

### `leaderboard` (~178 tokens)

Leaderboard

Top-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.

Input parameters:

- `hasServices` (boolean)
- `limit` (integer)
- `minExplorerScore` (number): Minimum upstream v1 Explorer total_score in protocol units; not local rank.
- `minScore` (number): Deprecated ambiguous input; rejected. Use minExplorerScore.
- `mpp` (boolean): When present, require indexed MPP support.
- `trust` (string)
- `verify` (boolean): Probe the Reputation contract for the top results; current probe verifies no reputation fields.
- `x402` (boolean)

Output parameters:

- `agents` (array)
- `count` (number)
- `coverage` (object)

### `resolve_agent` (~90 tokens)

Resolve Agent

Resolve 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.

Input parameters:

- `ref` (required): Agent id, numeric string, stellar:{network}:{identity}#{id} handle, or owner G-address.

Output parameters:

- `agents` (array)
- `count` (number)
- `coverage` (object)
- `kind` (string)
- `network` (string)
- `owner`

### `get_agents_by_owner` (~85 tokens)

Get Agents By Owner

List 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.

Input parameters:

- `limit` (integer)
- `owner` (string, required): Owner account (Stellar G-address).
- `verify` (boolean)

Output parameters:

- `agents` (array)
- `count` (number)
- `coverage` (object)
- `owner` (string)

### `get_agent_feedback` (~102 tokens)

Get Agent Feedback

Recent Explorer-indexed on-chain feedback for one agent (client-authored, untrusted → returned in a labeled `selfDeclared` slot, sanitized). Revoked entries are hidden unless includeRevoked is set.

Input parameters:

- `agent` (required): Numeric agent id, numeric string, or a full stellar handle.
- `includeRevoked` (boolean)
- `limit` (integer)
- `page` (integer)
- `tag` (string): Filter by feedback tag.

Output parameters:

- `agentId` (number)
- `count` (number)
- `coverage` (object)
- `feedback` (object)
- `page` (number)
- `stellarId` (string)
- `summary` (object)

### `verify_reputation` (~89 tokens)

Verify Reputation

Fail-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.

Input parameters:

- `agent` (required): Numeric agent id, numeric string, or a full stellar handle.

Output parameters:

- `agentId` (number)
- `stellarId` (string)
- `verification` (object)
- `verified` (boolean)

### `get_agent_card` (~116 tokens)

Get Derived A2A Projection

Unverified 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`.

Input parameters:

- `agent` (required): Numeric agent id, numeric string, or a full stellar:{network}:{identity}#{id} handle.
- `verify` (boolean): Attempt the bounded Reputation-contract reachability probe; it does not verify reputation fields, A2A conformance, or endpoints.

Output parameters:

- `card` (object)
- `conformance` (string)
- `note` (string)

### `get_registry_stats` (~40 tokens)

Get Registry Stats

Explorer v1 registry counts plus sampled metrics, with explicit metric definitions, 5,000-agent sample cap, non-global distribution warning, and snapshot limitations.

Output parameters:

- `agentsWithMpp`
- `agentsWithServices` (integer)
- `agentsWithX402` (integer)
- `averageFeedbackScore` (number)
- `coverage` (object)
- `limitations` (array)
- `metricDefinitions` (object)
- `network` (string)
- `protocolDistribution` (object)
- `totalAgents` (integer)
- `totalFeedbacks` (integer)
- `totalUniqueClients` (integer)
- `totalValidations` (integer)
- `trustDistribution` (object)

### `get_registry_health` (~57 tokens)

Get Registry Health

Per-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.

Output parameters:

- `anyStale` (boolean)
- `indexer` (object)
- `network` (string)
- `status` (string)

## Diagnostics

Captured diagnostic sections: Provenance, Dependencies. The full working is on the page: https://verifymcp.io/servers/berkingurcan-stellar-agent-search/stellar-agent-search#diagnostics

## Score history

- 2026-08-03: 75
- 2026-08-02: 75
- 2026-08-01: 5
- 2026-07-31: 24
- 2026-07-30: 41

## Links

- npm package: https://www.npmjs.com/package/stellar-agent-search
- Socket report: https://socket.dev/npm/package/stellar-agent-search
- Repository: https://github.com/berkingurcan/stellar-agent-search
- Changelog RSS feed: https://verifymcp.io/servers/berkingurcan-stellar-agent-search/stellar-agent-search/changelog.xml
- Changelog JSON feed: https://verifymcp.io/servers/berkingurcan-stellar-agent-search/stellar-agent-search/changelog.json
- HTML version of this page: https://verifymcp.io/servers/berkingurcan-stellar-agent-search/stellar-agent-search