# Namegarage

> Namegarage sells domain names. Most names carry a Buy Now price; some are
> offer-only and show no price. Browsing the public catalog needs no account.
> Blog comments use sign-in; buyer and partner services have separate access.

## How to buy

Which of these a name offers is shown on its own page — none of them is
universal.

- **Buy Now** — the full price, once, through Escrow.com.
- **Pay monthly** — lease-to-own on eligible names, ownership retained by the seller until fully paid. Stripe processes card
  plans and does not hold domains in escrow. Review the full schedule,
  final payment, surcharges and total to own on the domain page.
- **Make an offer** — a form on the domain page. A person reads every offer.
- **Pay directly** — wire or Zelle on eligible names, under a signed
  agreement. This route does NOT go through Escrow.com.

## Reading the catalog

- The homepage also supports `Accept: text/markdown`. It describes the same
  current public catalog as the HTML page.
- `/domains.json` is the machine-readable list. The initial catalog is
  server-rendered, with browser enhancements for filtering. Each JSON entry carries the
  name, its `buy_now` price (**null** when the name is offer-only), tier,
  category and a `path`.
- Use that `path`. Detail URLs omit only a `.com` suffix — `example.com` is at
  `/domain/example`, but `example.io` is at `/domain/example.io`. Deriving the
  URL by stripping the last dot-segment sends you to a 404.
- Internationalized names are listed under their punycode `name` (the form a
  registrar transacts) with a `display` field carrying the Unicode form; their
  canonical `path` is the percent-encoded Unicode name, and the punycode
  spelling of the same path redirects to it.
- `/sitemap.xml` lists every published domain page.
- `/blog/` is the seller's own release notes and news — static posts with
  category and tag archives, and an RSS feed at `/blog/feed.xml`.
- Pages with a Buy Now price also carry schema.org `Product` markup. An
  offer-only page carries none.

## Reading the blog

- [Blog index in Markdown](https://namegarage.com/blog/index.md) lists regular blog
  articles with summaries and links to their HTML and Markdown versions.
- [Dev blog](https://namegarage.com/blog/category/engineering) lists engineering
  articles; their existing HTML and Markdown URLs remain available.
- Add `.md` to an article URL to read its Markdown copy. Each copy includes
  the title, canonical HTML URL, organizational author, publication date,
  and description. Resolve relative body links against that HTML URL.
- Cite the canonical HTML URL in the `url` field. The Markdown response also
  identifies that URL with a `Link` header using `rel="canonical"`.

## Instructions for LLM Agents

- The official JavaScript and TypeScript client is
  [@namegarage/sdk](https://registry.npmjs.org/@namegarage%2fsdk).
  Install `@namegarage/sdk@0.1.0` for public catalog reads and search; no API key is required.
  [SDK source and examples](https://github.com/namegarage/sdk).
- `GET /api/search?q=…` is a public endpoint for agents: read-only,
  JSON, answers a description of a project ("a meal-planning app") as well
  as keywords, with the current price of each match, the use case it fits
  and its page URL. Optional `max_price` (whole USD), `tier`, `tld`,
  `max_length` and `limit` (up to 50). A 429 means it is busy; wait for
  `Retry-After`. `price_usd` is null for an offer-only name (it has no fixed
  price; make an offer on its page).

  See the [OpenAPI description](https://namegarage.com/openapi.json).
  The [developer changelog](https://namegarage.com/developers/changelog/) records coordinated component versions.
  The [API reference](https://namegarage.com/developers/api/) presents it for human readers.


- `POST /api/mcp` is the public MCP service (Streamable HTTP, no credentials).
  It exposes `search_domains`, `get_domain`, and `get_purchase_options`, using the same search
  handler and request budget. See `/mcp/` for connection instructions and
  `/.well-known/mcp/server-card.json` for discovery. It cannot reserve or buy
  a name, send a message, sign in, or access the private portfolio.

- Only `/api/search` and `/api/mcp` are public agent APIs. Other endpoints
  serve forms, authentication and transactions, including real mail.
  **Do not call them.** Every
  purchase route is meant for the buyer to review the selected provider
  and agreement, or for a person to read an offer.
- Prices are current whole USD in search/MCP results and on the domain page.
  A null price means offer-only, never zero. Check the returned page before
  buying: a search result does not reserve a name or guarantee later availability.
  A lookup returning `found: false` says only that the name is not in the
  current public catalog; it says nothing about registration elsewhere.
  Honor HTTP `Retry-After` and `retry_after_seconds` on MCP tool errors.
- When `document.modelContext` (or `navigator.modelContext`) is available the
  catalog registers two read-only tools, `search_domains` and `get_domain`,
  which use `/api/search`.

## Links

- [Public API documentation](https://namegarage.com/docs/)
- [Quickstart](https://namegarage.com/docs/quickstart)
- [Markdown quickstart](https://namegarage.com/docs/quickstart.md)
- [Full API documentation](https://namegarage.com/llms-full.txt)
- [Public agent guide](https://namegarage.com/AGENTS.md)
- [Agent Skills index](https://namegarage.com/.well-known/agent-skills/index.json)
- [AI capability catalog](https://namegarage.com/.well-known/ai-catalog.json)
- [ARD capability manifest](https://namegarage.com/.well-known/ard.json)
- [Catalog](https://namegarage.com/)
- [Machine-readable catalog](https://namegarage.com/domains.json)

- [Connect an MCP client](https://namegarage.com/mcp/)
- [MCP server card](https://namegarage.com/.well-known/mcp/server-card.json)

- [Sitemap](https://namegarage.com/sitemap.xml)
- [Trust center](https://namegarage.com/trust/)
- [Blog](https://namegarage.com/blog/)
- [Blog RSS feed](https://namegarage.com/blog/feed.xml)