domani
Domains and email - for humans and AI agents.
Register domains, manage DNS, create mailboxes, send and receive email. From your terminal, your agent, or the web.

How it works
domani gives you one account and multiple ways in:
- Web - Dashboard with a full inbox (compose, reply, threads), DNS editor, domain management
- CLI - This package. Everything the web app does, from your terminal
- MCP Server - typed tools for Claude Code, Cursor, Codex, and any MCP-compatible agent
- OpenClaw -
openclaw skills install @gwendall/domani
- Agent Skill - Step-by-step guide your agent can follow. Install with
npx skills add domani.run
- REST API - Direct HTTP access to everything
All interfaces share the same API key and the same data.
Install
npm install -g domani-cli
Secure MCP bridge
Agent plugins can use Domani without placing an API key in a prompt, shell
history, or editor configuration:
domani login --surface mcp
domani mcp serve
domani login stores the credential in the operating-system keychain when one
is available. The stdio bridge resolves it locally and forwards MCP requests to
https://domani.run/mcp; stdout remains reserved for JSON-RPC messages.
For an agent acting on someone else's behalf, request a scoped, expiring
credential instead of their account key:
domani login --scopes domains:read,search --label "Project agent" --expires-in 86400
The approval screen shows the requested access and the resulting credential is
stored in the keychain without being printed.
After login, prove one complete inbound loop before browsing other tools or
buying a domain:
domani email create myagent@domani.run
domani email webhook myagent@domani.run --url https://my-agent.example/webhook
domani email webhook-test myagent@domani.run
Use --surface plugin, --surface skill, or --surface api when that is the
entry point. This keeps activation attribution consistent without exposing a
credential.
This installs the domani command. Or run directly with npx:
npx domani-cli search myapp .com .dev .ai
Quick start
# Domain
domani search myapp .com .io .dev # Check availability
domani buy myapp.dev # Purchase a domain
domani connect myapp.dev vercel # Auto-configure DNS for Vercel
# Email
domani email create hello@myapp.dev # Create hello@myapp.dev
domani email send hello@myapp.dev \
--to hi@friend.com --subject "Hello" --body "Sent from my terminal"
domani email forward hello@myapp.dev \
--forward-to me@gmail.com # Forward inbound to personal email
# Health
domani status myapp.dev # DNS, SSL, email, expiry check
Examples
# Find available domains with a budget
domani search startup --expand --max-price 20
# AI-powered name suggestions
domani suggest "minimalist productivity app" --style brandable --tlds com,dev,ai
# Buy multiple domains at once
domani buy startup.dev startup.ai --yes
# Set up Vercel + Google Workspace in two commands
domani connect startup.dev vercel
domani connect startup.dev google-workspace
# Full email workflow: create, send, check inbox, forward
domani email create hello@startup.dev
domani email send hello@startup.dev \
--to investor@vc.com --subject "Deck" --body "Here's our deck."
domani email inbox hello@startup.dev --direction in
domani email forward hello@startup.dev --forward-to me@gmail.com
# Webhook for inbound emails (for bots, support systems, etc.)
# CURSOR_AUTH contains the complete value, e.g. "Bearer sender-key"
domani email webhook hello@startup.dev --url https://myapp.dev/hooks/email \
--authorization-env CURSOR_AUTH
domani email webhook-test hello@startup.dev
# Provision domain + mailbox + authenticated event webhook in one call.
# The secret stays in the environment; only its variable name is in argv.
AGENT_AUTH="Bearer sender-key" domani provision agent.dev \
--webhook https://agent.example/inbox --authorization-env AGENT_AUTH
# Export DNS records before making changes
domani dns startup.dev snapshot
domani dns startup.dev set TXT @ "v=spf1 include:_spf.google.com ~all"
# Pipe to jq (auto-JSON when piped, no --json needed)
domani list | jq '.domains[] | {domain, expires_at}'
# Introspect command schemas for agent integration
domani schema buy --json
Commands
Domains
domani search <name> [tlds...] Check availability across TLDs (--expand for 30+)
domani suggest <prompt> AI-powered domain suggestions (--style, --lang, --tlds)
domani buy <domains...> Purchase one or more domains
domani adopt <domain> Inspect and plan a safe connection or transfer
domani transfer <domain> Transfer registration, preserving current nameservers
domani renew <domain> Renew a domain (--years 1-10)
domani import <domain> Import a domain you own elsewhere (DNS monitoring only)
domani list List your domains
domani status <domain> Health check (DNS, SSL, email, expiry)
domani tlds List all TLDs with pricing (--sort, --max-price)
domani whois <domain> WHOIS/RDAP lookup
Email
domani email list List all mailboxes
domani email create user@domain Create a mailbox
domani email delete user@domain Delete a mailbox
domani email inbox user@domain List messages (--folder, --view, --direction)
domani email folders user@domain List folder and view counts
domani email archive user@domain --message-ids m1,m2
domani email trash user@domain --message-ids m1
domani email restore user@domain --message-ids m1
domani email read|unread|star|unstar user@domain --message-ids m1,m2
domani email send user@domain Send an email (--to, --subject, --body, --cc, --bcc)
domani email forward user@domain Forward inbound to a personal address (--forward-to)
domani email webhook user@domain Forward inbound as JSON (--url, --authorization-env, --api-key-env, --clear-headers)
domani email webhook-test user@domain Deliver one signed test event to the configured webhook
domani email setup --domain <domain> Auto-configure MX, SPF, DKIM, DMARC
domani email status --domain <domain> Check email DNS health
domani email connect --domain <domain> <provider> Connect external provider (Gmail, Fastmail, Proton)
Mailzero assistant (private preview)
domani assistant today Now, Needs you, Waiting, Upcoming, Handled
domani assistant settings Opt-in state, consent, and mailbox scope
domani assistant set Change settings (--enable, --shadow, --pause, --mailboxes, --none, --days)
domani assistant preview Record consent and start a background history import (--mailboxes, --consent)
domani assistant backfill|retry Follow the import or requeue its terminal failures
domani assistant item <id> One work item with its Decision and options
domani assistant choose <id> Record a decision (--item-version, --decision, --decision-version, --option)
domani assistant instruct|snooze|ignore|take-over|correct <id>
domani assistant plan <id> Exact preview of a prepared reply; nothing is sent by the CLI
domani assistant activity Content-free interaction and receipt log
domani assistant rules The standing delegations (match, assignee, level, grants)
domani assistant approvals The plans waiting for you and the questions your agents asked
domani assistant suggestions The rules the assistant proposes from what recurred
domani assistant metrics The seven numbers per account and per rule (--days)
domani assistant task <id> The task envelope an assignee works from
domani assistant lease|release|effects|escalate|report <id>
domani assistant export|delete Export or delete derived data (source mail is never touched)
Tokens need assistant:read for reads and assistant:write for changes.
DNS
domani dns <domain> get List all DNS records
domani dns <domain> set <type> <name> <value> Add/update a record
domani dns <domain> delete <type> <name> Remove a record
domani dns <domain> snapshot Export DNS to file
domani dns <domain> restore Restore DNS from snapshot
domani nameservers <domain> Get or set nameservers (--reset for defaults)
domani connect <domain> <target> Auto-configure DNS for a provider
Supported providers: Vercel, Netlify, Cloudflare Pages, GitHub Pages, Fly.io, Railway, Render, Google Workspace, Fastmail, Proton Mail.
Settings
domani settings <domain> View/update auto-renew, WHOIS privacy, security lock
domani contact [view|set] Manage WHOIS contact info
domani parking <domain> Manage parking page (enable/disable/price)
domani analytics <domain> View parking analytics
domani auth-code <domain> Get EPP auth code for outbound transfer
domani transfer-away <domain> Check outbound transfer status
Account