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:

Code

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.

Terminal

npx domain-suite-mcp

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

Install globally

Terminal

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:

Terminal

npx domain-suite-mcp install

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

Print MCP client config

Terminal

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:

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):

config.json

{
  "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:

Terminal

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:

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

Feature	Porkbun	Namecheap	GoDaddy	Cloudflare
Domain availability check	Yes	Yes	Yes	Yes
Domain registration	Yes	Yes	Yes	Enterprise only
Domain renewal	Yes	Yes	Yes	Enterprise only
DNS record CRUD	Yes	Yes	Yes*	Yes
SSL certificate management	Yes (full)	No	No	List/status only
WHOIS contact management	No	Yes	Yes	Enterprise only
Domain transfer (inbound)	Yes	Yes	Yes	No
Pricing via API	Yes	Yes	Yes	No
Sandbox / test environment	Yes	Yes	Yes	No

* 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

bash

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

Namecheap

bash

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

bash

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

Cloudflare

bash

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

Tools

Tool	Description
`list_providers`	List configured providers and their capabilities
`check_availability`	Check if a domain is available — works with zero configuration
`list_domains`	List all domains across configured providers
`get_domain`	Get details for a specific domain
`register_domain`	Register a new domain
`renew_domain`	Renew an existing domain
`list_dns_records`	List all DNS records for a domain
`create_dns_record`	Create a new DNS record
`update_dns_record`	Update an existing DNS record (full replacement)
`delete_dns_record`	Delete a DNS record
`list_certificates`	List SSL certificates for a domain
`create_certificate`	Provision a new SSL certificate
`get_certificate_status`	Get the status of a certificate
`setup_spf`	Add SPF record with mail provider template (Google, Resend, SendGrid, Mailgun, SES, Postmark)
`setup_dkim`	Add DKIM record — supports RSA and Ed25519, idempotent
`setup_dmarc`	Add DMARC policy record, idempotent
`setup_mx`	Configure MX records with mail provider template
`transfer_domain_in`	Initiate inbound domain transfer
`get_transfer_status`	Check status of a pending transfer
`get_whois_contact`	Get WHOIS contact info for a domain
`update_whois_contact`	Update WHOIS contact info for a domain

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.

Code

[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

Document	Description
docs/TOOLS.md	Complete tool reference with schemas
docs/PROVIDERS.md	Provider setup guides and known limitations
docs/SKILLS.md	Agent workflow patterns and prompt templates
CHANGELOG.md	Version history
CONTRIBUTING.md	Contribution guide

Contributing

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

bash

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

License

MIT