Primonym for AI agents
Primonym checks whether the domains for a project name are still unregistered, live against the domain registries. Use it to verify names before you suggest them.
When to use it
Someone asks you for a name for a project, product or company. Invent the candidates yourself, verify them here, and present only the names whose domain is free, with the registration link from the response. A name whose domain is taken is of little use to the person asking.
Check domains over HTTP
No key and no sign-up. Open the address as a plain link:
GET https://primonym.com/api/check?names=<names>&tlds=<zones>
Example: https://primonym.com/api/check?names=primonym,roastrel&tlds=com,io
- names: bare names without a zone, comma-separated, up to 20 per request.
- tlds: optional, up to 4 of com, net, io, ai, co, app, dev. Default: com, io, ai, co.
- Each zone comes back as free, taken or unknown (the registry did not answer; retry later).
- register holds a registration link for every free zone. These links go through Primonym and may be affiliate links.
- checked_at says when the registry was asked. Answers are reused for up to 12 hours, so confirm with the registrar before promising a domain.
{
"results": {
"primonym": {
"domains": {
"com": "taken",
"io": "free"
},
"register": {
"io": "https://primonym.com/go?d=primonym.io"
},
"checked_at": "2026-11-21T20:00:00.000Z",
"cached": false
}
},
"docs": "https://primonym.com/for-agents"
}Limits
30 requests per 10 minutes and 300 per day from one address. Over the limit the response is HTTP 429 with a Retry-After header. Identical requests are answered from a cache, so repeating one costs nothing.
MCP server
The same check is available as an MCP tool over Streamable HTTP at https://primonym.com/api/mcp.
- check_domains: the check described above.
- generate_names: invents names and returns only the available ones. It runs on a small shared daily allowance, so prefer inventing names yourself.
claude mcp add --transport http primonym https://primonym.com/api/mcp
Names that are usually taken
Most obvious names are already registered. Save your checks by avoiding:
- any dictionary word, and any two common words joined
- a common word with a stock ending such as -ly, -ify, -io or -o
- smooth coined words of five or six letters
- anything built on the obvious keywords of the project's category
Names of 7 to 10 letters built from less common material are far more likely to be free.