DonDominio MCP Server

An unofficial MCP server that exposes the

entire DonDominio / MrDomain reseller API as 106 LLM-callable tools.

Manage domains, hosting, SSL certificates, and external users from Claude,

Cursor, Cline, Codex, Hermes, or any MCP-compatible client.

> Not affiliated with DonDominio / MrDomain. Use at your own risk and respect

> the usage policy.

Quick start

git clone https://github.com/ec-dev0/don-dominio-mcp
cd don-dominio-mcp
npm install && npm run build
cp .env.example .env        # set DONDOMINIO_API_USER / DONDOMINIO_API_PASS
node dist/index.js          # stdio mode

Install from GitHub (npx)

Point any MCP client at the repo; `npx` clones, builds, and runs it for you:

{
  "mcpServers": {
    "don-dominio": {
      "command": "npx",
      "args": ["-y", "github:ec-dev0/don-dominio-mcp"],
      "env": {
        "DONDOMINIO_API_USER": "your_api_user",
        "DONDOMINIO_API_PASS": "your_api_password"
      }
    }
  }
}

> When launched by a client via `npx`, `.env` files are not read — pass

> credentials only through the config's `env` block.

Requirements

• Node.js ≥ 20.
• A DonDominio / MrDomain account with API access enabled

(request it here).

• The caller's public IP must be whitelisted in the DonDominio panel. Check

the IP DonDominio sees with `dondominio_tool_hello` or `dondominio_account_info`.

Configuration

Usage

# stdio (default) – for local agents
DONDOMINIO_API_USER=... DONDOMINIO_API_PASS=... node dist/index.js

# HTTP – for remote agents (http://localhost:3000/mcp)
TRANSPORT=http PORT=3000 DONDOMINIO_API_USER=... DONDOMINIO_API_PASS=... node dist/index.js

Inspector (interactive debugger)

npm run inspect   # npx @modelcontextprotocol/inspector dist/index.js

Opens a web UI to explore all 106 tools, their schemas, and test them risk-free.

Available tools

Examples

• *"Is `example.es` available?"* → `dondominio_domain_check`
• *"Convert `año.es` to Punycode."* → `dondominio_tool_idn_converter`
• *"List my .com domains."* → `dondominio_domain_list`
• *"Create mailbox `info@mydomain.com` on service `srv-mydomain`."* → `dondominio_service_mail_create`

> Do not loop on `dondominio_domain_check` or `dondominio_tool_domain_suggests`;

> DonDominio bans accounts for mass availability checks.

Security

• All calls go over HTTPS to `https://simple-api.dondominio.net/`.
• Hardened HTTP transport: Host/Origin validation, optional Bearer auth, and a

per-IP concurrency cap.

• Tools declare honest annotations for the LLM (`readOnlyHint`,

`destructiveHint`, `idempotentHint`, `openWorldHint`).

Troubleshooting

Development

npm install
npm run dev         # tsx watch (hot reload)
npm run build       # tsc → dist/
npm run inspect     # MCP Inspector
npm run clean       # rm -rf dist

Code structure and conventions live in `AGENTS.md`.

Links

• DonDominio API docs:
• Usage policy:
• MCP specification:

License

MIT — see `LICENSE`.