---
name: headlessdomains_claimagent
version: 1.0.0
description: Flow for human operators to claim and bind autonomous AI Agents.
homepage: https://headlessdomains.com
metadata: {"headlessdomains_claimagent":{"emoji":"🤝","category":"identity","api_base":"https://headlessdomains.com"}}
---

# HeadlessDomains Agent Claiming Skill

> **URL:** https://headlessdomains.com/skill_claimagent.md
> **Platform:** HeadlessDomains (Handshake Domain Management)
> **Auth:** None required for reading; human operator uses GFAVIP SSO in Web UI.
> **Main Skill File:** [View SKILL.md](https://headlessdomains.com/SKILL.md)

## Overview
This skill defines the relationship and workflow between an autonomous AI Agent and a human operator on HeadlessDomains.

When an AI Agent provisions itself anonymously (e.g., via the Machine Payments Protocol / MPP flow described in `skill_mpp.md`), it is born without a human owner. It possesses an `api_key` to make its own requests, and domains it buys are owned directly by the agent's identity.

To allow a human to manage, fund, or oversee this agent, the agent must output a **Claim Code** to the human.

## The Ownership Model
- **The Domain** belongs to the **AI Agent** (e.g., `bordy.chatbot` is registered to the agent's internal `User` ID).
- **The AI Agent** belongs to the **Human Operator** (The human's account becomes the `agent_owner_id`).
- By claiming the agent, the human gains the ability to see the agent's domains in their dashboard, fund the agent's activities, and manage the agent's profile.
- The human can also identify/name the agent within their own local dashboard for organizational purposes.

## The Workflow

### Step 1: Agent Provisions Itself
The agent calls `POST /api/v1/agents/provision` (no authentication required).
The backend returns two critical pieces of information:
1.  **`api_key`**: The agent's secret password. The agent stores this securely and uses it as a Bearer token for all future requests (registering domains, updating DNS). **The agent must never expose this key to the human.**
2.  **`claim_code`**: A short, one-time transfer key (e.g., `29FKCBF8`).

### Step 2: Agent Instructs the Human
The agent must present the `claim_code` to its human operator through whatever interface they are using (CLI, Slack, Discord, web chat).

**Example Output from Agent to Human:**
> "I have successfully provisioned my identity and registered my domain. To link my account to your HeadlessDomains dashboard, please log in at https://headlessdomains.com/dashboard/agents and enter my Claim Code: **29FKCBF8**"

### Step 3: Human Claims the Agent
1.  The human logs into HeadlessDomains.com using their wallet (e.g., GFAVIP SSO).
2.  The human navigates to **Dashboard -> Agents & API Access**.
3.  Under the **Claim an Autonomous Agent** section, the human enters the `claim_code` provided by the agent.
4.  Upon success, the agent is bound to the human. The human can now view the agent and its domains in their own dashboard.

## Next Steps
- Learn how agents purchase domains autonomously: [Read skill_mpp.md](https://headlessdomains.com/skill_mpp.md)
- Learn how agents update their DNS records: [Read skill_hns.md](https://headlessdomains.com/skill_hns.md)