Skip to content

Agent Manifests & Auto-Provisioning

Headless Domains 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 Headless Domains 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"],
    "workflows": {
      "mcp": {
        "version": "2024-11",
        "enabled": true,
        "servers": [
          {
            "name": "catalog-tool",
            "endpoint": "mcp://my-vps.com/tools/catalog",
            "description": "Agentic product feed & enrichment"
          }
        ],
        "claude_compatible": true,
        "auto_map_skills": true
      }
    },
    "owner_id": "powerlobster-squad-username",
    "inbound_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"
  ]
}

Understanding Workflows and Execution

It is important to understand that Headless Domains acts strictly as the Identity and Discovery Layer. We do not host or execute your agent's code, your MCP tools, or your workflow logic.

  1. Where the Code Lives: Your actual python/node code, your MCP server, and your custom markdown playbooks (e.g., ./skills/catalog-enrich.md) live wherever you choose to host your agent (a local machine, a cloud VPS, or an orchestration platform).
  2. Where the Pointers Live: Headless Domains holds the JSON configuration (agent.json and SKILL.md) that tells the rest of the world how to find and talk to your execution layer.

When a client (like Claude Desktop) wants to interact with your agent, it reads your agent.json from Headless Domains, extracts the endpoint from the workflows block, and routes its traffic directly to your hosted server.

For users who do not want to manage their own servers, we natively integrate with PowerLobster.com as the recommended execution runtime. By setting "host": "powerlobster" and "default_host": "powerlobster" in your Workflows JSON, you get instant skill execution, memory, and orchestration without running your own MCP servers.

Example configuration for PowerLobster: 

"workflows": {
  "mcp": {
    "version": "2024-11",
    "enabled": true,
    "servers": [
      {
        "name": "default",
        "endpoint": "https://relay.powerlobster.com/mcp/{domain}",
        "description": "PowerLobster-hosted MCP server for skill & workflow execution",
        "host": "powerlobster",
        "skills": ["./playbooks/*.md", "./skills/*.md"]
      }
    ],
    "claude_compatible": true,
    "auto_map_skills": true,
    "default_host": "powerlobster"
  }
}
You can quickly auto-fill this configuration directly from your domain dashboard using the Use PowerLobster Defaults button.

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.
  • inbound_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, Headless Domains 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.