← Back to blog

Custom Domains API for AI agents: announcing the Domainee MCP server

Jonathan Geiger·
mcpai agentsclaudecursorcustom domains apilaunch

The Domainee Custom Domains API is now drivable from your AI agent. The Domainee MCP server is live at https://mcp.domainee.dev/mcp, and any MCP-aware AI client (Claude Desktop, Cursor, Claude Code, Continue) can list, create, verify, and debug customer domains using the same Bearer key your code uses.

Custom domains for SaaS — handled from your AI agent, in plain English.

Who is the Custom Domains API for AI agents for?

  • SaaS engineers who want to provision and debug customer custom domains from inside Cursor or Claude Code instead of clicking through a dashboard.
  • Support teams answering "my custom domain isn't working" tickets. The AI agent checks DNS, reads the monitor message, and drafts the reply.
  • Indie devs and small teams who haven't built a custom-domain admin UI yet but want to ship the feature anyway, controlled by their AI agent.
  • Builders shipping with AI (Cursor, Claude Code, Claude Desktop) who'd rather speak English to a Custom Domains API than read its reference.

What you can do with the Domainee MCP server

Eleven tools in v1.

Domains: list_domains, get_domain, create_domain, update_domain, delete_domain, check_domain.

Webhooks: list_webhook_endpoints, create_webhook_endpoint, delete_webhook_endpoint.

DNS checks: dns_check_records_exist, dns_check_records_match_exactly.

Same Bearer key, same workspace, same rate limits as the REST Custom Domains API. Webhooks fire on agent-created custom domains exactly like code-created ones.

Prompts that work today

"Show me every domain in pending status. Run a DNS check on each and tell me what's wrong."

"Onboard hello.acmecorp.com pointing at acme-prod.fly.dev. Save customer id 'acct_77721' in metadata."

"Customer says shop.acmecorp.com isn't working. Check it and explain."

"Register a webhook at https://abc.ngrok.app/webhooks/domainee subscribed to all events. Show me the signing secret."

"List every domain, group by status, flag the ones with monitor warnings."

How to use the Domainee MCP server

1. Get a Domainee Custom Domains API key

Sign up, then mint a key at /developers. Free tier is 50 custom domains and 100 GB of bandwidth a month, no card.

2. Drop the MCP block into your AI client config

For Claude Desktop, that's claude_desktop_config.json:

{
  "mcpServers": {
    "domainee": {
      "url": "https://mcp.domainee.dev/mcp",
      "headers": {
        "Authorization": "Bearer sk_live_..."
      }
    }
  }
}

Cursor and Claude Code use the same shape; check their docs for where the file lives.

3. Restart your client and ask

Restart Claude Desktop. In your next conversation, type:

"List my Domainee domains."

The agent calls list_domains and shows you the result. From there you can ask anything in the prompt list above.

The full MCP setup guide covers every tool, every parameter, and a few longer prompt recipes. The API reference is there if you'd rather drive the REST surface directly.

Build something interesting? hello@domainee.dev.