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