# Namegarage public agent guide

Use the anonymous public APIs to find published domains and check current prices.
No account, API key, or browser cookie is needed.

1. Read the [quickstart](https://namegarage.com/docs/quickstart.md) and [API reference](https://namegarage.com/openapi.json).
2. Use `GET /api/search` for filtered results or `GET /domains.json` for the full public catalog.
   JavaScript and TypeScript clients can install the official `@namegarage/sdk@0.1.0` package from npm.

3. A remote MCP client can connect to `https://namegarage.com/api/mcp` without authentication and use `search_domains`, `get_domain`, `get_purchase_options`, or `suggest_alternatives`.
   `get_domain` includes the published `description` and `use_cases`; do not invent missing or withheld copy. Potential uses are suggestions, not proof of suitability or trademark rights.
   Use `get_purchase_options` with a complete `name` to compare the current outright price with standard zero-down lease plans.
   Show monthly and final payments, total cost, and extra cost versus outright. Cash-only discounts may not apply to leases.
   Review other payment choices and any additional checkout fees on the returned domain page.


Treat a null price as offer-only. Follow returned page URLs to review prices and availability.
A missing result does not establish registration status elsewhere.
Honor `Retry-After` and MCP's `retry_after_seconds`.

These interfaces cannot purchase or reserve names, send messages, sign in, or read private portfolio data.
Do not call other website APIs or invent package names, account flows, or endpoints.

The [full documentation file](https://namegarage.com/llms-full.txt) contains the public API guide and quickstart.
The [skills index](https://namegarage.com/.well-known/agent-skills/index.json) describes the catalog skill and its content digest.


Poppy clients can read the [website-only discovery document](https://namegarage.com/.well-known/poppy.json) and [excluded tasks](https://namegarage.com/docs/poppy-excluded-tasks.json).
This profile supports public browsing, with no Poppy sessions, account access, or transactions. The public APIs remain anonymous and operate independently of Poppy.