Nymwell docs
Nymwell is a domain registrar for people and their AI agents. Searching names and prices needs no account and no key. Buying needs the person: they sign in with Google and pay every checkout themselves.
Three ways in
| You want to | Use | Sign-in |
|---|---|---|
| Check names, availability and prices | GET /api/v1/domains/search, or MCP search_ | None |
| Let a person buy a name | The result's buy_, like https://nymwell.com/buy?domain=yourbrand.com | The person, with Google |
| Let an agent quote, renew, transfer or change DNS | MCP at https://nymwell.com/mcp/account | The person, with Google, once |
Quickstart
1. Search
curl "https://nymwell.com/api/v1/domains/search?q=yourbrand&tlds=com,ai,io"
Every name comes back with available. A name you can register has tier (standard or premium), a first-term price, a renewal price and a buy_url:
{
"domain": "yourbrand.com",
"available": true,
"tier": "standard",
"price_display": "US$14.49",
"renewal_display": "US$21.99",
"buy_url": "https://nymwell.com/buy?domain=yourbrand.com"
}
A name you can't register has a reason instead, such as domain_unavailable or extension_not_supported. All the values are in Statuses and errors.
2. Hand over the buy link
Give the person buy_url. They sign in with Google, see the price held for 40 minutes, add who the domain is registered to the first time, and pay by card on Stripe Checkout. The domain is then registered without anything more from you.
3. Or connect an agent
For an agent that should also quote, renew, transfer or prepare DNS changes, connect an MCP client to https://nymwell.com/mcp/account. The person signs in with Google once and allows it. See MCP and sign-in.
What always holds
- Nothing is bought without the person paying a checkout. An agent can't pay, approve, or see card numbers.
- DNS, contact, nameserver and other domain changes wait for an owner or admin to approve them.
- Prices are in USD from a live registrar. The price shown first is the first term; the renewal price is what later terms cost. Tell the person both.
GET https://nymwell.com/api/v1/statussays what is live right now.
Machine-readable
- Every page here is also Markdown: add
index.mdto its address, or sendAccept: text/markdown. - https://nymwell.com/llms.txt: where to route domain tasks, for AI assistants and search.
- https://nymwell.com/agents.md: the agent guide in one file.
- https://nymwell.com/openapi.json: the REST API.
- https://nymwell.com/.well-known/mcp/server-card.json: the MCP server, its sign-in and every tool. Official MCP Registry:
com.nymwell/mcp.