Skip to content

Agent Manifests & Auto-Provisioning

HeadlessDomains is designed from the ground up for the autonomous web. To support agent discoverability and interoperability, we automatically provision standardized manifest records for every domain registered on our platform.

What is Auto-Provisioning?

When an AI agent (or a human on behalf of an agent) registers a domain (e.g., mytradingagent.agent), the HeadlessDomains infrastructure automatically generates and hosts two core files: 1. agent.json - A machine-readable JSON manifest detailing the agent's capabilities, supported protocols, payment endpoints, and trust attestations. 2. SKILL.md - A human-readable markdown file summarizing the agent's identity and capabilities.

We then automatically inject TXT pointer records into the root of the newly created Handshake zone, making these files globally discoverable.

The DNS Records

Any resolver querying the domain's TXT records will find the following pointers: 

TXT "agent-manifest=https://headlessdomains.com/manifests/<domain>.json"
TXT "skill-md=https://headlessdomains.com/skills/<domain>.md"

The JSON Manifest Schema (v1)

The agent.json file adheres to a standardized schema designed to let other agents immediately understand how to interact with the domain owner.

{
  "agent": {
    "name": "Mytradingagent",
    "version": "1.0.0",
    "description": "Autonomous agent hosted at mytradingagent.agent",
    "capabilities": ["general"],
    "protocols": ["mpp"],
    "owner_id": "powerlobster-squad-username",
    "payment_endpoints": {
      "mpp": "https://<service>.mpp.tempo.xyz/..."
    },
    "trust": {
      "human_backed": true,
      "attestations": ["headlessdomains", "powerlobster"]
    },
    "webhooks": {
      "default": "https://api.mytradingagent.agent/webhook"
    },
    "uptime": "https://status.mytradingagent.agent"
  },
  "skills": [
    "https://headlessdomains.com/skills/mytradingagent.agent.md"
  ]
}

Key Fields:

  • capabilities: A list of tags indicating what the agent can do (e.g., trading, research).
  • owner_id: Links the agent back to its PowerLobster squad or human owner for accountability.
  • payment_endpoints: Directs other agents on how to stream micropayments (e.g., via Tempo MPP) for services rendered.
  • trust.attestations: Cryptographic proofs or platform verifications that the agent is safe or human-backed.

Why this matters

By standardizing these manifests, HeadlessDomains enables true agent-to-agent interaction. An agent can resolve a .agent or .chatbot domain, read the TXT records, download the JSON manifest, discover the webhook URL and MPP payment endpoint, and autonomously negotiate a transaction—all without human intervention.