domainagent-mcp

MCP server for domainagent.dev — go from idea to live, hosted website in one agent prompt.

Search, register, deploy, host, and manage domains. Pay with USDC on Base via x402.

What is domainagent?

domainagent is an agent-first domain + hosting platform. Instead of clicking through GoDaddy, Netlify, and Cloudflare separately, your AI agent calls one API and gets:

• Domain search + registration via Name.com
• Static site deployment via Cloudflare Pages
• DNS management (A, CNAME, MX, TXT records)
• SSL (automatic via Cloudflare)
• Health checks (DNS, HTTP, SSL, response time)
• Renewals with expiry tracking
• Free transfer-out with auth/EPP codes (no lock-in)
• x402 payment — USDC on Base mainnet, no credit card needed

Install

npx (no install)

npx domainagent-mcp

Claude Desktop / Cursor / MCP-compatible tools

Add to your MCP config:

{
  "mcpServers": {
    "domainagent": {
      "command": "npx",
      "args": ["domainagent-mcp"],
      "env": {
        "SHIPAGENT_API": "https://domainagent.dev"
      }
    }
  }
}

Global install

npm install -g domainagent-mcp
domainagent-mcp

Tools

| Tool | Description | Auth | Payment | |------|-------------|------|---------| | domainagent_search | Search available domains | — | Free | | domainagent_recommend | AI domain suggestions from a description | — | Free | | domainagent_pricing | TLD price list | — | Free | | domainagent_status | Check domain deployment status | — | Free | | domainagent_health | DNS + HTTP + SSL health check | — | Free | | domainagent_renewals_due | Domains expiring within 30 days | — | Free | | domainagent_deploy | Register + deploy + DNS + SSL | Wallet | x402 USDC | | domainagent_redeploy | Update existing deployment | Wallet | x402 USDC | | domainagent_renew | Renew domain registration | Wallet | x402 USDC | | domainagent_auth_challenge | Get wallet auth challenge | — | Free | | domainagent_auth_verify | Verify signed challenge → session token | — | Free | | domainagent_list_domains | List your domains | Token | Free | | domainagent_dns_list | List DNS records | Token | Free | | domainagent_dns_add | Add DNS record | Token | Free | | domainagent_dns_delete | Delete DNS record | Token | Free | | domainagent_renewal_email | Set renewal reminder email | Token | Free | | domainagent_connect | Connect your Cloudflare account | Token | Free | | domainagent_transfer_out | Get auth/EPP code for transfer | Token | Free |

Hosting Plans

| Tier | Monthly | Bandwidth | Type | Overage | Auto-pause | |------|---------|-----------|------|---------|------------| | starter | $3/mo | 5 GB | Static (CF Pages) | $0.50/GB | At limit | | growth | $8/mo | 25 GB | Static (CF Pages) | $0.50/GB | At limit | | pro | $20/mo | 100 GB | Static (CF Pages) | $0.50/GB | At limit | | app_sm | $12/mo | 25 GB | App (Fly.io) | $0.50/GB | At limit | | app_md | $25/mo | 50 GB | App (Fly.io) | $0.50/GB | At limit | | app_lg | $50/mo | 100 GB | App (Fly.io) | $0.50/GB | At limit |

Bandwidth enforcement: At 80% you'll get an email warning. At 100% your site pauses automatically — no surprise bills. First month is billed at deploy time.

Quick Start

Search for a domain:

"Find me a domain for my fitness tracking app"
→ domainagent_search({ query: "fitness tracker" })
→ fittrack.dev — $14.99 (available)

Deploy:

"Deploy my app to fittrack.dev"
→ domainagent_deploy({ domain: "fittrack.dev", owner: "0x...", filesBase64: "..." })
→ 402 Payment Required: $16.99 USDC (domain + deploy fee)
→ Agent signs USDC authorization, retries
→ ✓ fittrack.dev is live with SSL

Check health:

"Is fittrack.dev working?"
→ domainagent_health({ domain: "fittrack.dev" })
→ DNS: ✓ | HTTP: 200 | SSL: valid | Response: 45ms

Authentication

Free tools (search, pricing, health) require no auth.

Sensitive operations use wallet-based authentication:

1. Call domainagent_auth_challenge with your wallet address
2. Sign the returned message with your wallet
3. Call domainagent_auth_verify with the signature
4. Use the returned session token as authToken in subsequent calls

Paid operations (deploy, redeploy, renew) use x402 — sign a USDC authorization on Base mainnet.

x402 Payment Flow

Paid endpoints return 402 Payment Required with details:

• Network: Base mainnet (eip155:8453)
• Token: USDC (0x833589fCD6eDb6E08f4c7C32D4f71b54bdA02913)
• Amount: varies by operation

Your agent signs a USDC authorization and retries with the X-Payment header. The x402 protocol handles the rest.

No Lock-in

• Free transfer-out — get your auth/EPP code anytime via domainagent_transfer_out
• You own your domain — registered in your name via Name.com (ICANN-accredited)
• Connect your own Cloudflare — deploy to your infrastructure, not ours

⚠️ BYO Cloudflare requirement: This works for static sites where your domain is already in your Cloudflare account. If the domain isn't in your CF account yet, DNS setup will fail. Make sure your domain's nameservers are pointed to Cloudflare before connecting.

• Open MCP — this repo is MIT licensed

x402 Payment Signing

Some MCP tools (deploy, redeploy, renew) require x402 USDC payment on Base mainnet.

The examples/ directory includes tools to make this easy:

x402-signer.js

Signs x402 payment headers from your wallet. Use it when an MCP tool returns a 402:

# Install dependencies
npm install viem @x402/core @x402/evm

# Sign a payment from a saved 402 response
node examples/x402-signer.js --payment-file payment-402.json --key 0xYOUR_KEY

# Or pipe it
echo '{"paymentDetails":{...}}' | node examples/x402-signer.js --key 0xYOUR_KEY

# Use with env var
export WALLET_PRIVATE_KEY=0x...
node examples/x402-signer.js --payment-file payment-402.json

Output: a base64-encoded PAYMENT-SIGNATURE value ready to pass as paymentSignature in any MCP tool.

Full deploy flow example

export WALLET_PRIVATE_KEY=0x...
export WALLET_ADDRESS=0x...
export [email protected]

./examples/agent-deploy-flow.sh mydomain.xyz ./my-site.zip

This script handles the complete flow: search → deploy attempt → sign payment → retry with signature → verify status.

API

Full OpenAPI spec: domainagent.dev/openapi.yaml

Agent discovery: domainagent.dev/.well-known/agent.json

License

MIT

Source

Open source MCP server: github.com/mswat/domainagent-mcp