[{"_1":2,"_3":-5,"_4":-5},"loaderData",{"_5":6,"_7":8,"_9":10},"actionData","errors","root",{"_110":111},"routes/modules.$creator.$moduleId",{"_14":15,"_16":17,"_18":19,"_20":21},"routes/modules.$creator.$moduleId.endpoints",{"_11":12,"_13":-5},"error","Module not found","tools","module",{"_20":22,"_23":21,"_24":25,"_26":27,"_28":29,"_30":31,"_32":33,"_34":25,"_35":36,"_37":-5,"_38":-5,"_39":40,"_41":42,"_43":44,"_45":46,"_47":48,"_49":50,"_51":52,"_53":54,"_55":-5,"_56":48,"_57":58,"_59":60,"_61":62,"_63":64,"_65":66,"_67":68,"_69":70,"_71":72,"_73":74,"_75":76,"_77":78,"_79":-5,"_80":-5,"_81":-5,"_82":48,"_83":-5,"_84":85,"_86":87,"_88":89,"_90":91,"_92":93,"_94":95},"apiUrl","https://odel.app/api","creator","gwendall","moduleId","domani","@gwendall/domani","displayName","tagline","Internet identity for AI agents: register or broker domains, email, DNS - pay by card or USDC.","iconKey","https://avatars.githubusercontent.com/u/329887?v=4","category","remote","status","published","visibility","public","metaDescription","deploymentType","external","workerName","bindingName","mcpConfig","{\"url\":\"https://domani.run/mcp\",\"transport\":\"streamable-http\",\"authType\":\"none\"}","pricingModel","free","creatorUserId","system:external-import","createdAt",1783399910000,"updatedAt",1788333824000,"sourceRegistry","official-mcp-registry","sourceUrl","https://registry.modelcontextprotocol.io/v0/servers?search=run.domani%2Fdomani","sourceVerified",false,"sourceMissingSince","importedAt","upstreamStars",1,"upstreamUpdatedAt",1788221340000,"detectedTransport","streamable-http","detectedAuthType","none","probeStatus","ok","lastProbedAt",1787637154000,"githubRepoUrl","https://github.com/gwendall/domani","githubRepoFullName","gwendall/domani","releaseId","ext-gwendall-domani","version","0.4.15","descriptionMarkdown","# domani\n\nDomains and email - for humans and AI agents.\n\nRegister domains, manage DNS, create mailboxes, send and receive email. From your terminal, your agent, or the web.\n\n[![npm version](https://img.shields.io/npm/v/domani-cli.svg)](https://www.npmjs.com/package/domani-cli)\n[![license](https://img.shields.io/npm/l/domani-cli.svg)](https://github.com/gwendall/domani/blob/main/LICENSE)\n\n## How it works\n\ndomani gives you one account and multiple ways in:\n\n- **[Web](https://domani.run)** - Dashboard with a full inbox (compose, reply, threads), DNS editor, domain management\n- **CLI** - This package. Everything the web app does, from your terminal\n- **[MCP Server](https://domani.run/mcp)** - typed tools for Claude Code, Cursor, Codex, and any MCP-compatible agent\n- **[OpenClaw](https://openclaw.com)** - `openclaw skills install @gwendall/domani`\n- **[Agent Skill](https://domani.run/skill.md)** - Step-by-step guide your agent can follow. Install with `npx skills add domani.run`\n- **[REST API](https://domani.run/docs)** - Direct HTTP access to everything\n\nAll interfaces share the same API key and the same data.\n\n## Install\n\n```bash\nnpm install -g domani-cli\n```\n\n## Secure MCP bridge\n\nAgent plugins can use Domani without placing an API key in a prompt, shell\nhistory, or editor configuration:\n\n```bash\ndomani login --surface mcp\ndomani mcp serve\n```\n\n`domani login` stores the credential in the operating-system keychain when one\nis available. The stdio bridge resolves it locally and forwards MCP requests to\n`https://domani.run/mcp`; stdout remains reserved for JSON-RPC messages.\n\nFor an agent acting on someone else's behalf, request a scoped, expiring\ncredential instead of their account key:\n\n```bash\ndomani login --scopes domains:read,search --label \"Project agent\" --expires-in 86400\n```\n\nThe approval screen shows the requested access and the resulting credential is\nstored in the keychain without being printed.\n\nAfter login, prove one complete inbound loop before browsing other tools or\nbuying a domain:\n\n```bash\ndomani email create myagent@domani.run\ndomani email webhook myagent@domani.run --url https://my-agent.example/webhook\ndomani email webhook-test myagent@domani.run\n```\n\nUse `--surface plugin`, `--surface skill`, or `--surface api` when that is the\nentry point. This keeps activation attribution consistent without exposing a\ncredential.\n\nThis installs the `domani` command. Or run directly with `npx`:\n\n```bash\nnpx domani-cli search myapp .com .dev .ai\n```\n\n## Quick start\n\n```bash\n# Domain\ndomani search myapp .com .io .dev # Check availability\ndomani buy myapp.dev # Purchase a domain\ndomani connect myapp.dev vercel # Auto-configure DNS for Vercel\n\n# Email\ndomani email create hello@myapp.dev # Create hello@myapp.dev\ndomani email send hello@myapp.dev \\\n --to hi@friend.com --subject \"Hello\" --body \"Sent from my terminal\"\ndomani email forward hello@myapp.dev \\\n --forward-to me@gmail.com # Forward inbound to personal email\n\n# Health\ndomani status myapp.dev # DNS, SSL, email, expiry check\n```\n\n## Examples\n\n```bash\n# Find available domains with a budget\ndomani search startup --expand --max-price 20\n\n# AI-powered name suggestions\ndomani suggest \"minimalist productivity app\" --style brandable --tlds com,dev,ai\n\n# Buy multiple domains at once\ndomani buy startup.dev startup.ai --yes\n\n# Set up Vercel + Google Workspace in two commands\ndomani connect startup.dev vercel\ndomani connect startup.dev google-workspace\n\n# Full email workflow: create, send, check inbox, forward\ndomani email create hello@startup.dev\ndomani email send hello@startup.dev \\\n --to investor@vc.com --subject \"Deck\" --body \"Here's our deck.\"\ndomani email inbox hello@startup.dev --direction in\ndomani email forward hello@startup.dev --forward-to me@gmail.com\n\n# Webhook for inbound emails (for bots, support systems, etc.)\n# CURSOR_AUTH contains the complete value, e.g. \"Bearer sender-key\"\ndomani email webhook hello@startup.dev --url https://myapp.dev/hooks/email \\\n --authorization-env CURSOR_AUTH\ndomani email webhook-test hello@startup.dev\n\n# Provision domain + mailbox + authenticated event webhook in one call.\n# The secret stays in the environment; only its variable name is in argv.\nAGENT_AUTH=\"Bearer sender-key\" domani provision agent.dev \\\n --webhook https://agent.example/inbox --authorization-env AGENT_AUTH\n\n# Export DNS records before making changes\ndomani dns startup.dev snapshot\ndomani dns startup.dev set TXT @ \"v=spf1 include:_spf.google.com ~all\"\n\n# Pipe to jq (auto-JSON when piped, no --json needed)\ndomani list | jq '.domains[] | {domain, expires_at}'\n\n# Introspect command schemas for agent integration\ndomani schema buy --json\n```\n\n## Commands\n\n### Domains\n\n```\ndomani search [tlds...] Check availability across TLDs (--expand for 30+)\ndomani suggest AI-powered domain suggestions (--style, --lang, --tlds)\ndomani buy Purchase one or more domains\ndomani adopt Inspect and plan a safe connection or transfer\ndomani transfer Transfer registration, preserving current nameservers\ndomani renew Renew a domain (--years 1-10)\ndomani import Import a domain you own elsewhere (DNS monitoring only)\ndomani list List your domains\ndomani status Health check (DNS, SSL, email, expiry)\ndomani tlds List all TLDs with pricing (--sort, --max-price)\ndomani whois WHOIS/RDAP lookup\n```\n\n### Email\n\n```\ndomani email list List all mailboxes\ndomani email create user@domain Create a mailbox\ndomani email delete user@domain Delete a mailbox\ndomani email inbox user@domain List messages (--folder, --view, --direction)\ndomani email folders user@domain List folder and view counts\ndomani email archive user@domain --message-ids m1,m2\ndomani email trash user@domain --message-ids m1\ndomani email restore user@domain --message-ids m1\ndomani email read|unread|star|unstar user@domain --message-ids m1,m2\ndomani email send user@domain Send an email (--to, --subject, --body, --cc, --bcc)\ndomani email forward user@domain Forward inbound to a personal address (--forward-to)\ndomani email webhook user@domain Forward inbound as JSON (--url, --authorization-env, --api-key-env, --clear-headers)\ndomani email webhook-test user@domain Deliver one signed test event to the configured webhook\ndomani email setup --domain Auto-configure MX, SPF, DKIM, DMARC\ndomani email status --domain Check email DNS health\ndomani email connect --domain Connect external provider (Gmail, Fastmail, Proton)\n```\n\n### DNS\n\n```\ndomani dns get List all DNS records\ndomani dns set Add/update a record\ndomani dns delete Remove a record\ndomani dns snapshot Export DNS to file\ndomani dns restore Restore DNS from snapshot\ndomani nameservers Get or set nameservers (--reset for defaults)\ndomani connect Auto-configure DNS for a provider\n```\n\n**Supported providers**: Vercel, Netlify, Cloudflare Pages, GitHub Pages, Fly.io, Railway, Render, Google Workspace, Fastmail, Proton Mail.\n\n### Settings\n\n```\ndomani settings View/update auto-renew, WHOIS privacy, security lock\ndomani contact [view|set] Manage WHOIS contact info\ndomani parking Manage parking page (enable/disable/price)\ndomani analytics View parking analytics\ndomani auth-code Get EPP auth code for outbound transfer\ndomani transfer-away Check outbound transfer status\n```\n\n### Account\n\n```\ndomani login Log in to domani.run (opens browser)\ndomani logout Clear saved credentials\ndomani me Show account info\ndomani billing Add or update payment method (opens browser)\ndomani invoices List payment invoices\ndomani token Print your API key\ndomani tokens [list|create|revoke] Manage API tokens (scoped, expiring)\ndomani webhooks [action] Manage webhook endpoints (auth headers via --authorization-env/--api-key-env)\n```\n\n### Introspection\n\n```\ndomani schema [command] Show command schemas for AI agent integration\ndomani update Update to the latest version\ndomani uninstall Remove domani CLI and config\n```\n\n## Agent integration\n\nBuilt for AI agents and scripts, not just humans.\n\n**TTY auto-detect**: When stdout is not a terminal, the CLI automatically switches to JSON output and skips confirmation prompts. No `--json` flag needed.\n\n```bash\ndomani list | jq '.domains[].domain'\n```\n\n**Structured errors**: In JSON mode, errors include `code`, `hint`, and `fix_command` for auto-recovery:\n\n```json\n{ \"error\": \"Not logged in\", \"code\": \"auth_required\", \"fix_command\": \"domani login\" }\n```\n\n| Code | Fix | Description |\n|------|-----|-------------|\n| `auth_required` | `domani login` | Not logged in |\n| `payment_required` | `domani billing` | No payment method on file |\n| `contact_required` | `domani contact set` | WHOIS contact info missing |\n| `validation_error` | Read `hint` | Invalid input |\n| `not_found` | - | Domain doesn't exist or not owned |\n| `rate_limited` | Wait `Retry-After` | Too many requests |\n\n**Flags**:\n\n| Flag | Description |\n|------|-------------|\n| `--json` | Force JSON output |\n| `--fields ` | Filter JSON fields (comma-separated) |\n| `--dry-run` | Preview mutations without executing |\n| `--yes` | Skip confirmation prompts |\n\n**Input hardening**: All inputs are validated against path traversal, control characters, query strings, and double encoding - common agent hallucinations.\n\n**Schema introspection**: Run `domani schema --json` to get parameter types, constraints, and enums before constructing a command.\n\n## Payments\n\nDomains are charged to your saved card. Add one at [domani.run/dashboard](https://domani.run/dashboard) or with `domani card add`.\n\n```bash\ndomani buy myapp.dev # Charged to saved card\n```\n\n## Authentication\n\n| Method | Description |\n|--------|-------------|\n| `domani login` | Interactive login (opens browser) |\n| `$DOMANI_API_KEY` | API key as environment variable |\n| OS keychain | Credential saved by `domani login` when available |\n| `~/.domani/config.json` | Non-secret CLI settings, plus legacy fallback on systems without a keychain |\n\nThe CLI checks `$DOMANI_API_KEY` first, then falls back to `~/.domani/config.json`.\n\n```bash\ndomani login # Interactive (opens browser)\nexport DOMANI_API_KEY=domani_sk_... # Or set env var\n```\n\nScoped API tokens can be created with `domani tokens create --scopes read,dns --expires-in 86400`.\n\n## Environment variables\n\n| Variable | Description |\n|----------|-------------|\n| `DOMANI_API_KEY` | API key (takes precedence over saved config) |\n\n## License\n\n[MIT](https://github.com/gwendall/domani/blob/main/LICENSE)\n","changelogMarkdown","videoKey","requiredSecretsJson","publishedAt","priceCents","trialDays",0,"upstream",{"_98":99,"_100":101,"_102":103,"_104":105,"_106":107,"_108":109},"requiredSecrets",[],"tags",[],"assets",[],"stats",{"_96":85,"_97":85},"ratingAvg","reviewCount","topics",[],"license","MIT","language","TypeScript","registryName","run.domani/domani","homepage","https://domani.run","packages",[],"ENV",{"_112":113,"_114":115,"_116":117},"ENVIRONMENT","production","TURNSTILE_SITE_KEY","0x4AAAAAAB8-rEI2gNDf_QhU","SENTRY_DSN","https://45fd1229f78089d5c3ee78be128030e1@o4510583261757440.ingest.de.sentry.io/4510584253448272"]