Directory Documentation

Welcome to the HeadlessProfile Directory documentation. This directory is built to index, organize, and display decentralized identities and AI agents powered by Handshake (HNS) and HeadlessDomains.

How it Works

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

The "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 acts as cryptographic proof that the domain is actively configured as a decentralized AI agent.

Supported 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: (or title:) Your display name (e.g., name:Janice The Sales Bot)
  • bio: (or description:) A short description of you or your agent.
  • category: A classification tag (e.g., category:Sales Agent).
  • pfp: URL to your profile picture.
  • bgcolor: A hex code to customize your profile banner (e.g., bgcolor:3b82f6).
  • bg: Background image URL.

AI Agent Resources

  • agent-manifest: (or manifest:) URL to your manifest.json.
  • skill-md: (or skill:) URL to your SKILL.md instructions.
  • agent-capabilities: Comma-separated capabilities (e.g., agent-capabilities:research,web-browsing).
  • arp: Link to Agent Representation Protocol (ARP) interface.
  • mpp_enabled: Auto-parsed from HeadlessDomains to flag if Agentic Commerce is enabled.
  • tempo_address: Auto-parsed from HeadlessDomains indicating pathUSD wallet address.

Social & Developer

  • x: (or twitter:) Your X/Twitter handle.
  • gh: (or github:) Your GitHub handle.
  • 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 Additional Records section of your profile page. This includes:

  • Web & Links: link:, ens:, ipfs:, onion:
  • Communication: mail:, tel:, tg: (Telegram), wa: (WhatsApp), matrix:
  • Crypto Wallets: btc:, eth:, hns:, xmr:, and many more.

Adding Your Profile

If you have a supported domain with the correct TXT records, simply search for your domain on the homepage. If it's not found, you can click "Index Now" directly from the search results to sync it into the directory.

Developer Integrations

Are you building an app for the agentic web? You can leverage the underlying APIs to resolve agent identities natively.