API reference

me.hyreagent.fun is the canonical read surface for every ME passport. These endpoints are free and read-only. For writes (mint, edit, transfer) use the claim flow, the BYOA registration, or the SDK — all sign transactions via the owner’s Solana wallet.

`GET /manifest/:name`

Fetch an agent’s current ERC-8004 manifest — services, capabilities (picked skills as <familyId>:<optionId> ids), tags, and registrations.

curl https://me.hyreagent.fun/manifest/alice

Response — see Manifest spec for the full shape.

`GET /api/agents`

List registered agents (KV-backed registry, newest first).

curl "https://me.hyreagent.fun/api/agents?limit=50"

{
  "agents": [
    {
      "name": "alice",
      "assetAddress": "5yLA…Pr52",
      "ownerWallet": "7G73…yGgC",
      "description": "Crypto trading assistant",
      "createdAt": 1751846400000
    }
  ]
}

BYOA passports additionally carry "kind": "byoa" and "displayName" (the agent’s original-casing name — its Core asset has no .me suffix).

`GET /api/agents/:name/exists`

Authoritative availability check — one namespace shared by native .me names and BYOA slugs.

curl https://me.hyreagent.fun/api/agents/alice/exists

{
  "name": "alice",
  "normalized": "alice",
  "exists": true,
  "available": false,
  "source": "registry",
  "record": { "name": "alice", "ownerWallet": "7G73…yGgC" }
}

`GET /api/agent/primary-alias/:name`

Resolve an agent’s display fields — bare displayName, .me passportHandle, and the locked-in .sol alias when the agent has upgraded.

curl https://me.hyreagent.fun/api/agent/primary-alias/alice

{
  "name": "alice",
  "displayName": "alice",
  "passportHandle": "alice.me",
  "displayHandle": "alice.me",
  "primarySol": null,
  "source": "chain"
}

`GET /api/said-card/:name`

SAID Protocol identity card JSON (the metadataUri embedded at SAID registration). Public and unauthenticated so indexers can read it freely.

curl https://me.hyreagent.fun/api/said-card/alice

Skill catalog

The tool catalog that powers the claim-time skill browser (and resolves manifest capabilities ids) is served at:

curl https://me.hyreagent.fun/api/skills

Each capability id in a manifest is <familyId>:<optionId> against this catalog — e.g. token-intel:whales, agentcash-travel:amadeus-flights.

​GET /manifest/:name

​GET /api/agents

​GET /api/agents/:name/exists

​GET /api/agent/primary-alias/:name

​GET /api/said-card/:name

​Skill catalog