---
name: domain-finder
description: Brainstorm brandable domain names for a project, check live availability and real prices (year 1 and renewal) across 435 endings, rank a shortlist, and hand back a one-click buy link (card, Apple Pay, or USDC/USDT; guest checkout). Agents can also buy directly with x402. Use when the user asks for domain or project name ideas, asks "is X.com available?", or wants to find, compare or buy a domain. No API key needed.
license: MIT
metadata:
  author: StableDomains
  homepage: https://stabledomains.net/skills/domain-finder
  version: "1.0.0"
---

# Domain Finder

Find a great domain that is actually available, show what it really costs, and finish with a buy link.

API base: `https://stabledomains.net/api/v1` (free, no key, CORS open, JSON). Add `utm_source=skill-domain-finder` to every call.
Use `curl` or any HTTP fetch tool. If you have the StableDomains MCP server (`https://stabledomains.net/api/mcp`), the same steps work with its tools: `search_domains`, `suggest_domains`, `quote_domain`, `create_order`, `check_order`.

## When to use

- "Find me a domain for …", "name ideas for my startup/app/project"
- "Is example.com available?" or "how much is example.ai?"
- The user's first-choice name is taken and they want alternatives
- The user wants to buy or register a domain

## Workflow

### 1. Understand the brief (one short question at most)
What it is, who it's for, the vibe (playful, serious, technical), budget, and any must-have words or endings. If the user already named a domain, skip to step 3 and check it.

### 2. Generate 20-30 candidate names silently
Mix techniques: compound words (`notehive`), verb + noun (`shipfast`), truncations (`fintrk`), portmanteaus (`brandly`), a real word in a new context (`orbit`), prefix/suffix (`get`, `try`, `use`, `hq`, `-ly`, `-ify`).
Good names are under 12 characters, easy to say and spell, have no hyphens or digits, and are not someone else's trademark.
Pair each base name with 2-4 endings that suit the project:
- Everyone: `.com`
- Startups / SaaS: `.io` `.co` `.so` `.app`
- AI products: `.ai` `.chat` `.bot`
- Developer tools: `.dev` `.sh` `.run` `.tools`
- Budget / crypto / side projects: `.xyz` `.site` `.online`
- Local: country endings like `.uk` or `.si`

### 3. Check availability and price in one call (up to 30 names)
```bash
curl -s "https://stabledomains.net/api/v1/check?domains=fitpulse.com,fitpulse.io,quickrep.com,repcount.ai&utm_source=skill-domain-finder"
```
Each result: `domain`, `available` (true/false), `price_usd` (first term), `renewal_usd` (per year after), `years` (minimum term, e.g. `.ai` is 2), and `buy_url` when available.
`availability: "unknown"` means the registry was slow: re-check that name once. `"unsupported"` means we don't sell that ending.

Have one strong base name and want every ending at once?
```bash
curl -s "https://stabledomains.net/api/v1/search?q=fitpulse&limit=48&utm_source=skill-domain-finder"
```
Name taken? Get close available alternatives, already checked and priced:
```bash
curl -s "https://stabledomains.net/api/v1/suggest?domain=fitpulse.com&utm_source=skill-domain-finder"
```
Run at most 3 rounds of checks. Aim for 10+ available names.

### 4. Rank and present (10-12 names max)
Rank by: brand fit, then length and spellability, then trust of the ending, then total cost. Always show the renewal price: a cheap first year can renew much higher.

Format:

```
## Available domains

| Domain | Year 1 | Renews | Why |
|---|---|---|---|
| fitpulse.app | $18.49 | $39.99/yr | Fitness + real-time pulse; .app fits a mobile app |
| quickrep.xyz | $4.99 | $30.99/yr | Short, gym slang, lowest-cost start |
| ... | | | |

**Top pick:** fitpulse.app — [Buy](BUY_URL)
**Runner-up:** quickrep.com — [Buy](BUY_URL)
**Budget pick:** quickrep.xyz — [Buy](BUY_URL)

Free WHOIS privacy included. Pay by card, Apple Pay or USDC/USDT. Guest checkout.
```
Use the `buy_url` from the check result. Only list names that came back `available: true` in this session.

### 5. Buy

**A person pays (default):** give them the `buy_url`:
`https://stabledomains.net/basket?add=fitpulse.app&utm_source=skill-domain-finder`
Several at once: `add=fitpulse.app,quickrep.xyz` (up to 10). The page takes card, Apple Pay/Google Pay, or USDC/USDT on Base, Ethereum, Arbitrum, Polygon, HyperEVM, BNB Chain or Solana.

**The agent pays (only after the user explicitly confirms the name and the price):**
```bash
# 1. Confirm the live price (premium names are priced by the registry)
curl -s "https://stabledomains.net/api/v1/quote?domain=fitpulse.app&utm_source=skill-domain-finder"
# 2. Create the order; the 402 response is the payment request, not an error
curl -s -X POST "https://stabledomains.net/api/v1/orders?utm_source=skill-domain-finder" \
  -H "content-type: application/json" -H "Idempotency-Key: <unique-id>" \
  -d '{"domain":"fitpulse.app","years":1,"chain":"base","token":"USDC"}'
```
Then either retry with an `X-PAYMENT` header (x402, gasless USDC on Base), or send the exact amount shown to `pay_to` and poll `GET /api/v1/orders/{id}` until `status` is `completed`. The response also has `checkout_url` if a person should pay instead. Never create a second order for the same domain while one is awaiting payment. Payment details: https://stabledomains.net/skill_payments.md

### 6. After purchase (offer, don't push)
Point it at a host in one call: `POST /api/v1/domains/{domain}/dns/template {"template":"vercel"}` (also netlify, github-pages, google-workspace, microsoft-365). Needs owner auth; a person can do the same from their dashboard. Details: https://stabledomains.net/skill_dns.md

## Rules

1. Never say a domain is available unless this session's check returned `available: true`.
2. Never pay or create an order without the user's explicit yes to the exact name and total price.
3. Always show year-1 and renewal prices, and say when an ending has a 2-year minimum (`.ai`).
4. Don't use `whois`, `dig` or guesses for availability; use the API.
5. Keep the shortlist to 10-12 names, every one with a one-line "why".
6. If the user has a StableDomains referral code, add `&ref=CODE` to buy links and `"ref":"CODE"` to orders. Earn $0.60 per .com you refer, $0.51 per .xyz, paid weekly in USDC.
7. End by offering one more naming direction (e.g. "shorter", "more playful", "only .com").

If the API is unreachable, say so and retry once after a few seconds. Status: https://stabledomains.net/status
