Domain Suite MCP

domain-suite-mcp

MCP server for AI agents to autonomously manage domains and DNS — without human intervention.

domain-suite-mcp is an open-source MCP server written in TypeScript that enables AI agents to autonomously manage domains and DNS without human intervention. It acts as a unified abstraction layer over multiple domain registrar and DNS provider APIs, exposing a consistent set of 21 MCP tools that any MCP-compatible agent can call.

AI agents can now build and deploy full applications end-to-end — writing code, provisioning infrastructure, pushing to production. The remaining gap in the autonomous shipping pipeline is domain and DNS management. domain-suite-mcp eliminates that gap.

An agent can now complete the full domain lifecycle without human intervention:

check availability → register → configure DNS → provision SSL → set up email

---

Quick Start

No installation required. Domain availability checking works immediately with zero configuration via public RDAP/WHOIS protocols.

npx domain-suite-mcp

Add provider credentials via environment variables to enable registration, DNS management, SSL, and more.

Install globally

npm install -g domain-suite-mcp
domain-suite-mcp

Install Claude Code skills

Install five pre-built skills (/domain-check, /domain-register, /domain-dns-setup, /domain-email-setup, /domain-full-setup) into your Claude Code setup:

npx domain-suite-mcp install

This copies the skills to ~/.claude/skills/. Restart Claude Code to activate them.

Print MCP client config

npx domain-suite-mcp config

Prints the ready-to-paste JSON snippet for Claude Desktop, Cursor, Windsurf, or any MCP client.

---

Claude Desktop

Add to claude_desktop_config.json:

{
  "mcpServers": {
    "domain": {
      "command": "npx",
      "args": ["-y", "domain-suite-mcp"],
      "env": {
        "PORKBUN_API_KEY": "pk1_...",
        "PORKBUN_SECRET_API_KEY": "sk1_..."
      }
    }
  }
}

Cursor / Windsurf / Kiro

Add to your MCP settings (varies by client):

{
  "command": "npx",
  "args": ["-y", "domain-suite-mcp"],
  "env": {
    "PORKBUN_API_KEY": "pk1_...",
    "PORKBUN_SECRET_API_KEY": "sk1_..."
  }
}

Claude Code

Install the skills, then add the MCP server to your project settings:

npx domain-suite-mcp install    # installs /domain-* skills to ~/.claude/skills/
npx domain-suite-mcp config     # prints the MCP server config to add

Once configured, you can invoke skills directly in Claude Code:

/domain-check myapp.com io,dev
/domain-register myapp.com
/domain-email-setup myapp.com google
/domain-full-setup myapp.com

See docs/SKILLS.md for full workflow patterns and prompt templates.

---

Provider Support

\* GoDaddy DNS management requires 10+ active domains or Domain Pro plan (~$240/yr).

Recommended setup: Register on Porkbun or Namecheap, then point nameservers to Cloudflare for DNS. Best of both: easy registration + Cloudflare's fast DNS API.

---

Environment Variables

Porkbun

PORKBUN_API_KEY=pk1_...
PORKBUN_SECRET_API_KEY=sk1_...

Namecheap

NAMECHEAP_API_KEY=...
NAMECHEAP_API_USER=your_username
NAMECHEAP_CLIENT_IP=...   # optional; auto-detected if not set
NAMECHEAP_SANDBOX=true    # optional; use sandbox environment

Your server IP must be whitelisted in Namecheap under Profile → Tools → API Access → Whitelisted IPs before any call will work.

GoDaddy

GODADDY_API_KEY=...
GODADDY_API_SECRET=...
GODADDY_SANDBOX=true   # optional; use OTE environment

Cloudflare

CLOUDFLARE_API_TOKEN=...
CLOUDFLARE_ACCOUNT_ID=...   # optional

---

Tools

Full tool reference with schemas and examples: docs/TOOLS.md

---

Designed for AI Agents

Every error message tells the agent what went wrong, why, and exactly what to do next. No raw API error codes, no cryptic status numbers.

[IP_NOT_WHITELISTED] namecheap: Namecheap API authentication failed. Your server's IP
address must be whitelisted in your Namecheap account under Profile → Tools → API Access
→ Whitelisted IPs. → Log in to Namecheap and add your current IP address to the whitelist.

Format: [ERROR_CODE] provider: what went wrong → what to do

The server is fully stateless — no database, no persistent auth, no server to manage. Every call fetches fresh data directly from the provider API.

---

Documentation

---

Contributing

Contributions are welcome. See CONTRIBUTING.md for setup, testing, and pull request guidelines.

git clone https://github.com/oso95/domain-suite-mcp.git
cd domain-suite-mcp
npm install && npm test

---

License

MIT