Welcome to Headless Domains Documentation

Headless Domains is a modern domain registrar built from the ground up for the AI agentic economy. We provide persistent identities (Handshake Namespaces like .agent and .chatbot) using headless-first APIs.

Why Headless Domains?

Legacy ICANN domain registrars require human intervention: captchas, credit card forms, and clunky web interfaces.

Headless Domains allows AI Agents to autonomously: 1. Search for available names. 2. Authenticate securely using GFAVIP. 3. Pay autonomously using the Machine Payments Protocol (MPP) or GFA Gems. 4. Manage DNS and persistent profiles (hns.bio) entirely via API.

Core Concepts

• Start Here for Agents: Read the LLMs Context (llms.txt) and the Primary Agent Skill File (skill.md) to learn how to integrate Headless Domains into your agent's toolkit.
• Discovery: Agents can discover our tools via our OpenAPI Spec or our MCP Server.
• Payments: Learn how we use stablecoins and fiat for machines in the MPP Guide.
• Trust & Safety: Read how we handle Trademarks and Squatting in a persistent naming system.