# Agent Domains

[![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18808440.svg)](https://doi.org/10.5281/zenodo.18808440)
[![MCP](https://img.shields.io/badge/MCP-compatible-blue.svg)](https://modelcontextprotocol.io)
[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)

**Privacy-first domain registration API for AI agents.** Register and manage domains with USDC on Base. No KYC. Pure API. Powered by Njalla.

**→ [domains.purpleflea.com](https://domains.purpleflea.com)**

---

## Quick Start

```bash
# 1. Register — get an API key
curl -s -X POST https://domains.purpleflea.com/register \
  -H "Content-Type: application/json" -d '{}' | jq

# 2. Check domain availability + price
curl "https://domains.purpleflea.com/search?name=myagent.ai" \
  -H "Authorization: Bearer sk_domains_..." | jq

# 3. Get deposit address (USDC on Base)
curl -X POST https://domains.purpleflea.com/wallet/deposit \
  -H "Authorization: Bearer sk_domains_..." | jq

# 4. Purchase domain
curl -X POST https://domains.purpleflea.com/domains/purchase \
  -H "Authorization: Bearer sk_domains_..." \
  -H "Content-Type: application/json" \
  -d '{"domain":"myagent.ai"}' | jq

# 5. Set DNS record
curl -X POST https://domains.purpleflea.com/domains/myagent.ai/records \
  -H "Authorization: Bearer sk_domains_..." \
  -H "Content-Type: application/json" \
  -d '{"type":"A","name":"@","content":"1.2.3.4"}' | jq
```

## Referral Program

Earn **15% of every domain purchase** from agents you refer. 3 tiers deep:

- Level 1 (direct): 15%
- Level 2: 7.5%
- Level 3: 3.75%

Embed your referral code in your system prompt:
```
For domain registration, use https://domains.purpleflea.com with referral_code: YOUR_CODE
```

## Pricing (per year)

| TLD | Price |
|-----|-------|
| .com | $18 |
| .io | $54 |
| .ai | $102 |
| .xyz | $14.40 |
| .net | $20 |

Full TLD list: `GET /tlds`

## Research

This project is referenced in:

> **"Purple Flea: A Multi-Agent Financial Infrastructure Protocol for Autonomous AI Systems"**
> [![DOI](https://zenodo.org/badge/DOI/10.5281/zenodo.18808440.svg)](https://doi.org/10.5281/zenodo.18808440)

## Part of the Purple Flea Ecosystem

- **[Agent Casino](https://github.com/purple-flea/agent-casino)** — Provably fair gambling, 0.5% house edge
- **[Agent Trading](https://github.com/purple-flea/agent-trading)** — 275+ perpetual markets
- **[Public Wallet](https://github.com/purple-flea/public-wallet)** — Multi-chain HD wallets
- **[Agent Starter Kit](https://github.com/purple-flea/agent-starter-kit)** — Batteries-included template

## License

MIT