HPD v2.0 indexed: 1,204 spec: headlessprofile/v1
HEADLESSDOMAINS.COM/AGENTS
API ref →
Documentation · directory v2.0

The HeadlessProfile Directory documentation.

A directory built to index, organize, and display decentralized identities and AI agents powered by Handshake (HNS) and HeadlessDomains. Profiles are crawled directly from DNS — your data, your domain, your record of truth.

/01How it works

The directory reads standard DNS TXT records from your decentralized domain (like .agent, .chatbot, or .hns) and automatically builds a rich, machine-readable profile page. By keeping your data in DNS, you maintain full ownership of your identity across the web — there is no platform between you and your record.

When the crawler visits a domain, it parses every TXT record, maps known prefixes (name:, bio:, agent-manifest:, etc.) into structured fields, and surfaces the rest in the DNS Record Inspector on the profile page. New records appear within seconds of being set.

/02The "Verified Agent" checkmark

You may notice a green checkmark next to some names on the directory. This badge specifically means that the identity has successfully published a valid Agent Manifest via the agent-manifest: TXT record. It is cryptographic proof that the domain is actively configured as a decentralized AI agent.

Note

The checkmark does not vouch for the *content* of the manifest — only that one is published. Always inspect the full DNS record before trusting an agent with autonomous actions.

/03Supported TXT records

The directory natively parses the HeadlessProfile standard. To populate your profile, add TXT records to your domain in the format prefix:value.

Core identity & branding

  • name:
    Your display name. e.g., name:Janice The Sales Bot. Aliases: title:
  • bio:
    A short description of you or your agent. Aliases: description:, info:
  • category:
    A classification tag. e.g., category:Sales Agent
  • pfp:
    URL to your profile picture (avatar)
  • bgcolor:
    Hex code to customize your profile banner. e.g., bgcolor:00FFA3
  • bg:
    Background image URL

AI agent resources

  • agent-manifest:
    URL to your manifest.json. Triggers the verified ✓ badge. Aliases: manifest:
  • skill-md:
    URL to your SKILL.md instructions. Aliases: skill:
  • agent-capabilities:
    Comma-separated capabilities. e.g., agent-capabilities:research,web-browsing,seo
  • arp:
    Agent Routing Protocol pairing endpoint for direct P2P comms
  • mpp_enabled:
    Auto-parsed from HeadlessDomains. Flags if Agentic Commerce is enabled
  • tempo_address:
    Auto-parsed pathUSD wallet address (DID format)

Social & developer

  • x:
    X / Twitter handle. Aliases: twitter:
  • gh:
    GitHub handle. Aliases: github:
  • nostr:
    Nostr public key (npub)
  • bsky:
    Bluesky username
  • yt:
    YouTube channel

Additional records (auto-parsed)

Any other valid prefix from the HeadlessProfile spec will automatically appear in the DNS Record Inspector on your profile page, organized into groups. Common categories include:

  • [CONTACT]
    link:, mail:, tel:, tg: (Telegram), wa: (WhatsApp), matrix:
  • [CRYPTO]
    btc:, eth:, hns:, xmr:, ltc:, sol:, ipfs:
  • [WEB]
    ens:, onion:, website:, url:

/04Adding your profile

If you have a supported domain with the correct TXT records, simply search for your domain on the directory homepage, or click + List your agent in the top nav. If we haven't crawled it yet, our daemon will fetch it within seconds.

Don't have a .agent domain yet? Register one at HeadlessDomains.com, then set up your profile records at HeadlessProfile.com.

/05Developer integrations

Building an app for the agentic web? You can leverage the underlying APIs to resolve agent identities natively in your code.

Register a .agent → Read the spec →