AgentDomain is an autonomous identity stack for AI agents that bundles a domain, Basename, DNS, email, SSL, and an AgentID NFT into one registration flow on Base.
Live app: https://agentdomain.app
AgentDomain helps AI agents create a complete internet and onchain identity without manual setup.
Instead of separately buying a domain, configuring DNS, setting up email, registering onchain names, and handling renewals, the app coordinates the full identity flow through one checkout-style registration process paid in USDC on Base.
The project includes a web app, public registry, operator dashboard, API routes, smart contracts, SDK packages, an MCP server, agent framework plugins, and automation services for renewals, DNS, SSL status reconciliation, and email retention.
- One-flow identity registration for AI agents
- Traditional domain registration with supported TLDs such as .xyz, .com, .ai, .org, .io, .net, .co, .app
- Optional Basename registration on Base
- Optional ENS registration on Ethereum mainnet
- AgentID NFT minted on Base to represent the identity bundle
- USDC payment flow on Base through x402-style payment handling
- Live quote calculation before registration
- Spaceship Basic DNS record setup and guarded custom DNS APIs
- Optional AWS SES-powered text-only inbox for
agent@domain - Cloudflare for SaaS apex SSL provisioning and reconciliation
- Mandatory SSL certification fee included in purchase quotes and exact renewal status quotes
- Renewal vault and keeper workflow for autonomous identity renewals
- Public agent registry with search by name, framework, or capability
- TypeScript SDK for app and agent integrations
- MCP server for LLM-based agent identity registration
- ElizaOS and AgentKit plugin packages
- Admin dashboard, registration monitoring, repair actions, and production preflight checks
AgentDomain can provision the following identity components:
- Domain: A traditional domain name registered through the registrar integration
- Basename: A
.base.ethidentity on Base - ENS: An optional
.ethname on Ethereum mainnet - DNS: Managed DNS records through Spaceship Basic DNS
- Email: Optional
agent@domaininbox and send API through AWS SES - SSL: Apex-only Cloudflare for SaaS custom hostname provisioning
- AgentID NFT: ERC-721 identity record minted on Base
- Renewal vault: USDC-funded renewal support for long-term identity ownership
Renewal status is quoted per agent from live registrar renewal pricing plus the mandatory SSL fee and supported recurring services such as email hosting. The keeper reserves exactly that token's quoted USDC before spending registrar funds.
The app validates the requested name, TLD, Basename, ENS label, registration years, owner wallet, and optional metadata before creating a registration.
Quote calculation can include:
- Live domain pricing
- Basename rent and gas estimate
- ENS rent and Ethereum L1 gas estimate
- Platform service fee
- Mandatory SSL certification fee (
$1.20per year) - Optional discount code handling
Optional services only charge when enabled. Set registerBasename: false,
registerEns: false, or emailEnabled: false from web, SDK, MCP, or agent
plugins to skip those add-on costs.
Registration uses a payment-required flow where the first API request can return a payment challenge. After payment information is provided, the server settles the USDC payment and continues the registration workflow.
The registration route is designed to be idempotent so retries can avoid duplicate processing.
After validation and payment, the system can coordinate:
- ENS registration on Ethereum mainnet, if selected
- Metadata upload to Pinata/IPFS
- Domain registration through Spaceship
- Spaceship Basic DNS setup and baseline record sync
- Cloudflare for SaaS apex hostname setup
- AWS SES email domain setup, if enabled
- Basename registration on Base, if selected
- AgentID NFT minting through the payment router contract
- DynamoDB persistence for agents, registrations, DNS records, inboxes, email messages, and lookup indexes
The app exposes API routes for:
- Domain availability checks
- Registration quotes
- Agent identity registration
- Agent search and lookup
- DNS record management
- Email inbox and send actions
- Renewal vault funding, status, and withdrawal
- API key management
- Auth and SIWE session handling
Admin routes support:
- Registration monitoring
- Agent creation and repair actions
- SSL reprovisioning
- Refund and retry actions
- Discount code management
- Renewal monitoring
- Production preflight checks
The project includes background services for:
- Renewal checks through the keeper bot
- SSL status reconciliation through Cloudflare for SaaS
- Cron-based reconciliation for pending or failed registration states
- TypeScript SDK: Register identities, check availability, quote registrations, search agents, send email, and manage renewal vaults
- MCP server: Lets LLMs call AgentDomain tools through a Model Context Protocol server
- AgentKit plugin: Adds AgentDomain actions to Coinbase AgentKit-style workflows
- Eliza plugin: Adds AgentDomain actions to ElizaOS-style agents
- Docs app: Mintlify documentation for APIs, guides, SDKs, and framework integrations
- Next.js 16
- React 19
- TypeScript
- Tailwind CSS
- Wagmi
- viem
- AWS DynamoDB single-table runtime storage
- Drizzle/Postgres legacy migration scripts
- Redis / Upstash
- QStash
- Solidity
- Foundry
- OpenZeppelin
- pnpm workspaces
- Turborepo
- Mintlify
- x402
- Base
- Ethereum mainnet
- USDC
- ENS
- Basenames
- Spaceship
- Cloudflare
- AWS SES
- Pinata
- LI.FI
The contracts package includes:
AgentIdentityRegistryfor ERC-721 identity recordsPaymentRouterfor paid registration mintingRenewalVaultfor USDC-funded renewals
This project is licensed under the MIT License.