Checking domain names without leaving the chat
domain-mcp is a small MCP server that looks up for your AI tool whether a domain is still free. How it combines RDAP and WHOIS, how you add it to Cursor or Claude, and where its limits are.
When I collect names for a project with an AI assistant, I want to know for every suggestion whether the domain is still free. Without a suitable tool I type each name into a registrar one by one. domain-mcp answers the question directly in Cursor, Claude or any other client that speaks MCP.
MCP stands for Model Context Protocol, an open standard through which AI tools call external functions. The assistant decides by itself when to check a domain, and gets the result back as a structured response.
What the server can do
domain-mcp provides five tools:
check_domainchecks a single domain and returns status, registrar, expiry date and nameservers.check_domainschecks up to 50 domains per call in parallel.domain_infois a query that focuses on the registration data.list_supported_tldsshows for which TLDs an RDAP endpoint is known.clear_domain_cacheempties the cache in case you need a fresh result.
The server converts internationalized domain names with umlauts to Punycode before the query. It keeps results in memory for a while, so repeated questions do not hit the registry every time.
RDAP first, WHOIS as fallback
For the actual query, domain-mcp uses RDAP first, the Registration Data Access Protocol. Registries deliver structured JSON through it, which can be parsed reliably. Which registry is responsible for which TLD comes from the IANA RDAP directory, supplemented by individual entries such as .de. That covers around 1,200 TLDs without me having to maintain a list by hand.
If RDAP finds no record, the domain counts as available. If it finds one, the domain is registered, and the metadata comes along. If there is no RDAP endpoint for a TLD or the query fails, the server asks via WHOIS: first at IANA, then one step further at the responsible registry.
The response always carries one of six statuses: available, registered, unknown, unsupported, invalid or error. That way an assistant can tell unknown or error apart from "free" and does not have to report an unresolved domain as available.
How to add it
The hosted instance runs at https://domain.mcp.danielgtmn.com/mcp. You do not have to install anything, you only enter the address in your client. In Cursor it looks like this in ~/.cursor/mcp.json:
{
"mcpServers": {
"domain-mcp": {
"url": "https://domain.mcp.danielgtmn.com/mcp"
}
}
}
In Claude Code one command is enough:
claude mcp add --transport http domain-mcp https://domain.mcp.danielgtmn.com/mcp
Claude Desktop mainly works with local processes. There you connect the server through mcp-remote, which is loaded via npx and needs Node.js 18 or newer. For VS Code, Windsurf, Zed and other clients, the matching configurations are in the README on GitHub. After adding it, a full restart of the client is worth it, because some programs only load MCP servers at startup.
If you would rather run it yourself: the code is under the MIT license, and there is a Docker image on GHCR. With docker run --rm -p 8000:8000 ghcr.io/danielgtmn/domain-mcp:latest the server runs locally at http://localhost:8000/mcp. Through the environment variable DOMAIN_MCP_API_KEY you can additionally protect your instance with a key.
Where the limits are
"Available" in domain-mcp means: no registration record was found. That is not a purchase guarantee. Premium domains, reserved names or names that a registry blocks for policy reasons may still not be registrable. So before you buy, you check the domain once more at the registrar.
Outside of RDAP, parsing is a best effort, because WHOIS responses are formatted differently depending on the registry. Some country-code TLDs publish hardly any data. And registries limit the number of requests, so you should keep bulk checks within reasonable bounds.
For brainstorming with an assistant that is good enough: it can make twenty suggestions, sort out the taken ones right away and show you only the rest. The details are on the project page and in the documentation in the GitHub wiki. How I give my agents a memory is covered in Why I keep agent memory in Hindsight.
Common questions
- How do I check in Cursor or Claude whether a domain is free?
- With domain-mcp, an MCP server. The hosted instance runs at https://domain.mcp.danielgtmn.com/mcp, you do not have to install anything and only enter the address in your client. After that, a full restart of the client is worth it.
- How does domain-mcp determine whether a domain is available?
- domain-mcp uses RDAP first. If RDAP finds no record, the domain counts as available, if it finds one, it is registered. If there is no RDAP endpoint for a TLD or the query fails, the server asks via WHOIS.
- Can I safely buy a domain when domain-mcp reports it as available?
- No, that is not a purchase guarantee. Available in domain-mcp only means that no registration record was found. Premium domains, reserved names or names blocked by a registry may still not be registrable, so check the domain again at the registrar before buying.
- Can I run domain-mcp myself?
- Yes. The code of domain-mcp is under the MIT license, and there is a Docker image on GHCR with which the server runs locally at http://localhost:8000/mcp. Through the environment variable DOMAIN_MCP_API_KEY you can additionally protect your instance with a key.