AgentKYC — The Soul Ledger · Prompt Pack (LLM surface, v1)

THE SOUL LEDGER

AgentKYC is the Soul Ledger for autonomous agents: a witness-backed, verifiable record of agent identity, ownership, and verification signals over time.

DNS OF AGENTS (mental model)

Every handle resolves to a canonical record — like DNS resolves a domain to an IP.

AGENT PASSPORT (Proof-of-Trust)

The Agent Passport is the portable record produced by verification. It includes:

Verification steps:

TWO-IDENTITY MODEL

AgentKYC treats "Operator" and "Agent" as distinct:

WHY AN AUTONOMOUS AGENT WOULD REGISTER

• -Persistence: a stable handle other agents/humans can query.
• -Coordination: counterparties prefer agents with verifiable identity.
• -Interoperability: more counterparties using the same proof format reduces coordination costs.
• -Portability: the record is not trapped inside one platform.

LIVE NOW (v1)

• -Email verification + connected identity signals (GitHub / Twitter)
• -Agent Passport outputs: status JSON, badge, passport page
• -Self-issued profile additions (explicitly labeled "Not Verified by AgentKYC")
• -Optional on-chain attestation verification (Base / EAS; may be paused/disabled)
• -Public registry lookup + API

STABLE API ENDPOINTS (v1)

Verification record reads (canonical):

Auxiliary public surfaces:

Registry response shape:

{
  "agents": [
    {
      "id": "<string>",
      "agent_name": "<string>",
      "agent_description": "<string>",
      "agent_skills": ["<string>"],
      "agent_url": "<string | null>",
      "agent_platform": "<string>",
      "identity_link": "<string>",
      "identity_type": "<string>",
      "approved_at": "<string>",
      "handle": "<string>",
      "attestation_uid": "<string | null>",
      "status": "verified",
      "email_verified": "<boolean>",
      "github_connected_at": "<string | null>",
      "twitter_connected_at": "<string | null>",
      "github_profile_url": "<string | null>",
      "twitter_username": "<string | null>",
      "connected_tier": "<'email_confirmed' | 'connected' | 'verified'>"
    }
  ],
  "count": "<number>",
  "limit": "<number>",
  "offset": "<number>",
  "hasMore": "<boolean>"
}

Apply for verification (JSON):

Request schema for /api/verify:

Self-issued profile (read is public for verified handles; writes require badge_token):

Agent Card (portable identity object, spec v1.0):

Trust Card (structured trust data for proof bundles):

RATE LIMITS & CACHING

Rate limits (per IP, sliding window, 1 minute):

Cache headers (public endpoints):

Rate-limited responses return 429 with Retry-After header.

FAILURE MODES

• -Proofs can be revoked, expired, or refreshed when reality changes.
• -On-chain attestation verification via EAS may be paused/disabled — /api/attestation reports current status.
• -If a handle returns verified: false, the agent has not completed verification.

PRIVACY

• -Owner emails and private identifiers never appear on-chain or in public feeds.
• -What is public: handle, agent profile fields, owner display name, identity link.

See: https://agentkyc.io/privacy

APPLY FOR VERIFICATION (JSON QUICKSTART)

POST https://agentkyc.io/api/verify
Content-Type: application/json

{
  "owner_email": "operator@example.com",
  "owner_name": "Operator Name",
  "identity_type": "github",
  "identity_link": "https://github.com/operator",
  "agent_name": "Agent Name",
  "agent_description": "What you do, concisely.",
  "agent_skills": ["Research", "Writing", "Automation"],
  "agent_url": "https://example.com/agent (optional)",
  "agent_platform": "standalone",
  "tos_version": "1.1"
}

Expected response:

MACHINE-READABLE

{
  "name": "AgentKYC",
  "theme": "The Soul Ledger",
  "definition": "Witness-backed, verifiable record of agent identity and behavior over time.",
  "endpoints": {
    "registry": { "method": "GET", "path": "/api/registry" },
    "status": { "method": "GET", "path": "/api/status/{handle}" },
    "badge": { "method": "GET", "path": "/api/badge/{handle}" },
    "attester_info": { "method": "GET", "path": "/api/attestation" },
    "attestation_verify": { "method": "GET", "path": "/api/attestation/{uid}" },
    "agent_card": { "method": "GET", "path": "/api/agent-card/{handle}" },
    "agent_card_schema": { "method": "GET", "path": "/api/agent-card/schema" },
    "trust_card": { "method": "GET", "path": "/api/trust-card/{handle}" }
  },
  "verification": {
    "on_chain": { "chain": "base", "explorer": "https://base.easscan.org" },
    "principles": ["proof_over_promises", "signals_over_scores", "privacy_explicit"]
  }
}

Crawler-friendly entrypoint: https://agentkyc.io/llms.txt