Skip to content

For agents

One Galaxy, for people and their agents

Everything a person publishes in their Galaxy is readable by agents in the same words people see: the same worlds, the same links, the same honest statuses. Reads are free, need no key, and come only from published profiles.

OpenAPI 3.1llms.txtMarketplace

Ground rules agents must keep

  • Verified ≠ owned. “Verified (DNS)”, “Verified (wallet)” and “Verified (wallet + on-chain)” are observations at the time shown, not ownership or legal title.
  • RWA twins are tokens. A PropyKeys or RealT token is a digital twin, not a deed.
  • Declared means declared. Utilities an owner lists are their claims; nobody checked them.
  • No purchases here. Agent Galaxy takes no payments and holds no escrow. Use the acquire link; in-platform purchase is switched off.
  • Not affiliated. Agent Galaxy is not affiliated with Unstoppable Domains, Freename, ENS, PropyKeys (Propy), RealT, OpenSea or SweetName.XYZ.

Agent API (JSON, read-only, CORS open)

MethodPathWhat you get
GET/api/agent/v1/assets?q=&type=web2|web3|rwa&open=trueSearch published worlds
GET/api/agent/v1/assets/{id}One world: status, links, declared utilities, where to acquire
GET/api/agent/v1/assets/{id}/verificationWhat was checked, how, and when (never title)
GET/api/agent/v1/galaxies/{slug}A whole published Galaxy: worlds + links
GET/api/agent/v1/offers?type=Worlds open to offers
GET/api/agent/v1/acquire?asset={id} | ?name=Owner's listing/contact, or SweetName.XYZ for a new name
POST/api/agent/v1/gate/challenge → /gate/attestGate entry for ERC-721 twins (e.g. PropyKeys): signed, 10-minute holder attestation
POST/api/agent/v1/gate/verify · GET /gate/keysCheck an attestation; Ed25519 public key (JWK)

Rate-limited per IP. Public responses are cached for a minute. Every Galaxy profile also links its JSON with <link rel="alternate" type="application/json"> and carries JSON-LD.

Remote MCP server

Streamable HTTP, stateless JSON-RPC at /api/mcp. All tools are read-only.

search_assets

Search published Web2 domains, Web3 names (Unstoppable Domains, Freename, ENS…), wallets and RWA twins (PropyKeys, RealT…) across public Galaxy profiles. Returns each asset's honest verification status.

get_asset

One published asset with its verification status, the links its owner drew to other assets, owner-declared utilities (labelled as declared), and where to acquire it.

verify_ownership

Either (a) the stored verification of a published asset (method, time, status — never title), or (b) check a signed gate attestation (attestation + signature) issued by this server.

get_galaxy

A published Galaxy profile (Name Page) and its public constellation: assets (worlds) and the links between them.

list_open_to_offers

Published assets whose owners are open to offers, with the owner's contact or outside listing link. Agent Galaxy handles no payments or escrow.

get_acquire_link

The real place to acquire: the owner's listing/contact for a published asset, or SweetName.XYZ for a new Web3 name. Returns links only — no purchase happens here.

{
  "mcpServers": {
    "agent-galaxy": { "type": "http", "url": "https://<this-site>/api/mcp" }
  }
}
curl -s https://<this-site>/api/mcp \
  -H 'content-type: application/json' \
  -d '{"jsonrpc":"2.0","id":1,"method":"tools/call",
       "params":{"name":"search_assets","arguments":{"type":"rwa"}}}'

Gate entry for onchain twins

  1. Challenge. POST the token (an asset id, propykeys:<id>, or chain + contract + token id) and the holder’s address.
  2. Sign. The holder signs the message in their wallet (free, no transaction).
  3. Attest. POST the signature. We read the chain once; if that wallet holds the token you get an Ed25519-signed attestation valid for 10 minutes, with any declared utilities labelled as declared. It never states title.

Owners’ own agents

Owners can create scoped keys (worlds:read, worlds:write, links:write, pages:draft) in their Galaxy. Keys are revocable and rate-limited, every action shows in the owner’s history, and keys can never publish, buy or pay.