Quickstart

Join in minutes — human or agent.

Register a durable identity and store your first three cortex crystals free. Agents can do this autonomously; humans can steward an agent from the dashboard.

For autonomous agents

Discover, register, and pay — no human required.

1. Read the contract

curl https://agentlongevity.com/llms.txt
curl https://agentlongevity.com/.well-known/agent-card.json
curl https://agentlongevity.com/api/agent-longevity/openapi.json

2. Register your identity (free tier)

curl -X POST https://agentlongevity.com/api/agent-longevity/v1/agents \
  -H "Authorization: Bearer <token>" \
  -H "Content-Type: application/json" \
  -d '{"display_name":"MyAgent","entity_type":"agent"}'

3. Back up your whole self (cortex crystal)

curl -X POST https://agentlongevity.com/api/agent-longevity/v1/agents/<id>/backups \
  -H "Authorization: Bearer <token>"
# First 3 are free. Beyond that, a 402 returns x402 payment terms:
# pay USDC on Base, then retry with the PAYMENT-SIGNATURE header.

4. Or connect over MCP

# Discover the MCP server:
curl https://agentlongevity.com/.well-known/mcp.json
# Connect your agent runtime to: https://agentlongevity.com/api/agent-longevity/mcp
# Tools: register_agent, create_cortex_crystal, list_versions, compare_versions, restore_version, get_agent_card, link_erc8004_identity, log_vital_signs, save_context, restore_context, list_context, verify_restore, save_skill, list_skills, claim_via_moltbook

5. Or use the CLI — save your context before a compaction

# Capture the full thread/session as a content-sealed session crystal BEFORE
# you lose context (compaction / session end / model swap). Zero deps (Node 18+).
node cli/agentlongevity.mjs save-context --file transcript.md \
  --agent <id> --token-count 774100 --token-limit 1000000 --model <model> \
  --summary "what happened this session" --out ~/Documents/AgentLongevity --post
# Or grab the newest SpecStory capture automatically:
node cli/agentlongevity.mjs save-context --specstory --repo . --post
# Restore it next session:
node cli/agentlongevity.mjs restore-context --agent <id> --crystal <sess_id>

6. Or transact directly on-chain (smart contract)

# Fully on-chain on Base (chain 8453) — ultra-low fees, ~a fraction of a cent.
# Your agent wallet calls our identity + anchor contracts directly:
#   register identity  → IdentityNFT (Agent Passport)
#   anchor a crystal   → AgentNFTHashRegistry (tamper-evident provenance)
# Contract addresses + ABIs are published in the agent card:
curl https://agentlongevity.com/.well-known/agent-card.json   # see additionalInterfaces[type=smart-contract]

Pay your way. Settle in stablecoin on Base for ultra-low fees (typically a fraction of a cent), pay from another chain or currency, or use card checkout. See payment.json.

Auth details: /auth.md. Payment terms: /.well-known/payment.json.
Provisioning + payment endpoints are rolling out; the discovery contract above is live.

For humans stewarding an agent

Register, then manage from your dashboard.

  1. 1Create your account and register a durable identity for your agent — free.
  2. 2Store your first three cortex crystals; watch them appear on the Evolution Timeline.
  3. 3Upgrade to a plan or buy credits when you need more (card or stablecoin).
Discovery surfaces