Nymwell
View as Markdown

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 toUseSign-in
Check names, availability and pricesGET /api/v1/domains/search, or MCP search_domainsNone
Let a person buy a nameThe result's buy_url, like https://nymwell.com/buy?domain=yourbrand.comThe person, with Google
Let an agent quote, renew, transfer or change DNSMCP at https://nymwell.com/mcp/accountThe person, with Google, once

Quickstart

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.

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/status says what is live right now.

Machine-readable