domani

# domani.run - Domains & Emails for AI Agents

Internet identity for AI agents. One API to buy domains, create mailboxes, and send & receive emails. Every user gets a free email address on @domani.run — no domain purchase required.

> **Skill version 0.1.0 (2026-03-11).** If the user asks to check for updates, fetch `https://domani.run/SKILL.md` and compare the `updated` date in the frontmatter with the one above. If newer, run: `npx skills add domani.run`

## Installation

This skill can be installed through multiple channels:

- **Claude Code**: `npx skills add domani.run` or copy this file to `.claude/skills/domani/SKILL.md`
- **OpenClaw / ClawHub**: `clawhub install domani`
- **Claude.ai**: Download [domani-skill.zip](https://domani.run/domani-skill.zip) → Settings > Features > Upload skill
- **MCP** (alternative to this skill): Connect directly via Streamable HTTP - see [MCP setup](https://domani.run/.well-known/mcp.json)

All methods use the same API and API key. Choose one - you don't need both Skill and MCP.

## Setup

### What you can do without an API key

Many endpoints are **public and require no authentication**. You can start immediately:

- **Search domains**: `GET /api/domains/search?domains=name.com,name.dev`
- **Check availability**: `GET /api/domains/dns-check?names=name&tlds=com,dev,ai`
- **List TLDs + pricing**: `GET /api/domains/tlds`
- **WHOIS lookup**: `GET /api/domains/whois?domain=example.com`
- **AI suggestions**: `GET /api/domains/suggest?prompt=...`

**Only authenticate when the user wants to take action** (buy, configure DNS, create mailbox, send email, etc.). Don't look for an API key just to search or browse.

### What you need an API key for

- **Domains**: Buy, configure DNS, connect to hosting, transfer, renew
- **Email**: Create mailboxes (1 free @domani.run), send & receive, forward, reply, webhooks
- **Account**: Manage billing, WHOIS contact, API tokens

### Getting an API key (when needed)

**Check for existing authentication...