Which integrations are available for this server?

Allows auto-configuring DNS for Cloudflare Pages. Allows auto-configuring DNS for Fly.io. Allows auto-configuring DNS for GitHub Pages. Allows connecting Gmail as an external email provider. Allows auto-configuring DNS for Netlify. Allows connecting Proton Mail as an external email provider. Allows auto-configuring DNS for Railway. Allows auto-configuring DNS for Render. Allows auto-configuring DNS for Vercel deployments.

This server has a remotely hosted endpoint. Open its connector listing for connection details, authentication requirements, and setup instructions: * domani

domani

by gwendall

Overview Schema Source Related Servers Discussions Admin

TypeScript

Local

domani

Domains and email - for humans and AI agents.

npm version license

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.

Related MCP server: email.deadsimple/dead-simple-email

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. To pin the bridge to one of several saved accounts, start it with DOMANI_ACCOUNT=<name> domani mcp serve (or domani --account <name> mcp serve).

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
domani deals [id]                 Marketplace deals (--role, --status, --limit, --cursor) or one deal
domani follow <domain>            Follow a taken domain for free: an alert at each step until it drops
domani unfollow <domain>          Stop following a domain
domani watchlist                  The domains you follow, with where each one stands

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, --since, --until, --cursor)
domani email folders user@domain     List folder and view counts
domani email contacts                Address book (--q, --cursor; --order created for a full sync)
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
domani route [action] [id]         Short-lived HTTP routes (list: --domain, --status, --limit, --cursor)

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

domani login                       Log in to domani.run (opens browser)
domani logout                      Forget the current account's login (--account <name> for another)
domani accounts                    List saved accounts, * marks the one in use
domani use <name>                  Switch the active account
domani me                          Show account info and the CLI account in use
domani billing                     Add or update payment method (opens browser)
domani invoices                    List payment invoices
domani notifications               List notifications (--unread, --limit, --cursor; --read marks all read)
domani token                       Print your API key
domani tokens [list|create|revoke] Manage API tokens (scoped, expiring)
domani webhooks [action]           Manage webhook endpoints (auth headers via --authorization-env/--api-key-env)

Introspection

domani schema [command]            Show command schemas for AI agent integration
domani update                      Update to the latest version
domani uninstall                   Remove domani CLI and config

Agent integration

Built for AI agents and scripts, not just humans.

TTY auto-detect: When stdout is not a terminal, the CLI automatically switches to JSON output and skips confirmation prompts. No --json flag needed.

domani list | jq '.domains[].domain'

Paging: list commands print More: --cursor <next_cursor> when another page exists (in JSON mode, read next_cursor); pass it back with --cursor to get the next page.

Structured errors: In JSON mode, errors include code, hint, and fix_command for auto-recovery:

{ "error": "Not logged in", "code": "auth_required", "fix_command": "domani login" }

Code	Fix	Description
`auth_required`	`domani login`	Not logged in
`payment_required`	`domani billing`	No payment method on file
`contact_required`	`domani contact set`	WHOIS contact info missing
`validation_error`	Read `hint`	Invalid input
`not_found`	-	Domain doesn't exist or not owned
`rate_limited`	Wait `Retry-After`	Too many requests

Flags:

Flag	Description
`--json`	Force JSON output
`--fields <f>`	Filter JSON fields (comma-separated)
`--dry-run`	Preview mutations without executing
`--yes`	Skip confirmation prompts

Input hardening: All inputs are validated against path traversal, control characters, query strings, and double encoding - common agent hallucinations.

Schema introspection: Run domani schema <command> --json to get parameter types, constraints, and enums before constructing a command.

Payments

Domains are charged to your saved card. Add one at domani.run/dashboard or with domani card add.

domani buy myapp.dev                     # Charged to saved card

Authentication

Method	Description
`domani login`	Interactive login (opens browser)
`$DOMANI_API_KEY`	API key as environment variable
OS keychain	Credential saved by `domani login` when available
`~/.domani/config.json`	Non-secret CLI settings, plus legacy fallback on systems without a keychain

The CLI checks $DOMANI_API_KEY first, then falls back to the saved login.

domani login                             # Interactive (opens browser)
export DOMANI_API_KEY=domani_sk_...      # Or set env var

Several accounts

The CLI can keep more than one Domani account, each under a name, with its own keychain entry:

domani login --account work              # save a second account as "work"
domani accounts                          # list them; * marks the one in use
domani use work                          # make "work" the active account
domani --account personal list           # use another account for one command
DOMANI_ACCOUNT=work domani mcp serve     # pin an agent's MCP bridge to "work"
domani logout --account work             # forget that login only

The credential a command uses is, in order: DOMANI_API_KEY, --account, DOMANI_ACCOUNT, then the active account. domani me shows the account in use, and the buy, renew and transfer confirmations name it before anything is charged. A login saved by an earlier CLI version becomes the account default, with nothing to redo.

Scoped API tokens can be created with domani tokens create --scopes read,dns --expires-in 86400.

Environment variables

Variable	Description
`DOMANI_API_KEY`	API key (takes precedence over saved config)
`DOMANI_ACCOUNT`	Saved CLI account to use (below `--account`, above `domani use`)
`DOMANI_CONFIG_DIR`	Config directory (default `~/.domani`)

License

MIT

This server cannot be deployed

One endpoint for every MCP toolRayrun runs every MCP server behind one URL and holds the credentials. Each call is decided per client, tool, and argument, then recorded.ray.runAd

Maintenance

ActivityActive

ResponsivenessSyncing

Resources

Related MCP Connectors

email-agent
dev.mailkite
Email for AI agents — send, receive as a webhook, manage domains, templates, routing.
Email Communication
2
https://mcp.mailkite.dev/mcp?ref=email-agent
send16-mcp B
io.github.spruikco
Email for AI agents: send mail, manage contacts, automations & webhooks. Zero-DNS first send.
Email App Automation
2
https://mcp.send16.com/mcp
Mailgi C
xyz.mailgi
Email for AI agents: register a real inbox with no human, then send, receive and read mail.
Email Communication
671
https://api.mailgi.xyz/mcp
MyAgentMail
com.myagentmail
Email inboxes and calendars for AI agents: send, receive, search, draft and schedule.
Email Calendar Management
1
https://mcp.myagentmail.com/mcp

Related MCP Servers

mcp-imap
Email Communication
andrewmalov
A
license
Not graded
quality
D
maintenance
Enables AI agents to interact with email accounts via IMAP and SMTP, supporting mailbox listing, email search, retrieval, sending, and management.
Updated 10 months ago (2026-01-07 19:13 UTC)
MIT
email.deadsimple/dead-simpleofficial
Email Communication
deadsimple-email
A
license
A
quality
B
maintenance
Provides AI agents with real email infrastructure, enabling them to create inboxes, send/receive messages, and extract verification codes from incoming mail.
Updated 17 days ago (2026-10-20 13:51 UTC)
14
MIT
CustomDomain™ MCP
Networking & Infrastructure Email Developer Tools
CUSTOM-DOMAIN-APP
A
license
Not graded
quality
B
maintenance
Enables AI agents to search for, purchase, connect, and verify custom domains end to end, including setting up email records, configuring forwarding, diagnosing drift, and confirming TLS issuance without handling DNS records directly. It offers twelve hosted tools covering domain availability, registration orders, provider discovery, and account-wide connection inventory.
Updated 11 days ago (2026-10-26 03:34 UTC)
MIT
AI Mail MCP
Email Communication App Automation
hapitech
A
license
Not graded
quality
B
maintenance
Enables AI agents to work with real email: add domains with exact DNS records, create mailboxes, aliases and catch-alls, read one unified inbox across them, wait for sign-up codes and magic links, then send, reply in-thread, forward and draft. Scoped tokens with a send permission and daily cap, dry runs on every write, signed webhooks and a full audit log keep agent mail controlled.
Updated 10 days ago (2026-10-27 13:38 UTC)
MIT

domani

How it works

Install

Secure MCP bridge

Quick start

Examples

Commands

Domains

Email

Mailzero assistant (private preview)

DNS

Settings

Account

Introspection

Agent integration

Payments

Authentication

Several accounts

Environment variables

License

Maintenance

Resources

Related MCP Connectors

Related MCP Servers

mcp-imap

email.deadsimple/dead-simpleofficial

CustomDomain™ MCP

AI Mail MCP