Documentation / Guides / Quick start

Domain availability API quick start

Three minutes from nothing to a working domain search: one call in a terminal, one look at the answer, and the same thing inside your assistant.

1. Make a call

Paste this into a terminal. It asks whether brightfield is free on 12 popular endings.

curl "https://api.domainmcp.net/v1/search?name=brightfield"

No key, no header, no sign-up. The same address works from a server, a script or a web page, since the API allows calls from any site.

2. Read the answer

You get a list in data, free names first and cheapest first. A free one looks like this:

{
    "domain": "brightfield.io",
    "available": true,
    "status": "available",
    "confirmed": true,
    "by": "registry",
    "checked_at": "2026-11-10T09:14:02Z",
    "premium": false,
    "price": {
        "first_year": 34.98,
        "renews": 52.98,
        "min_years": 1,
        "on_offer": false,
        "currency": "USD"
    },
    "buy_url": "https://buy.domainmcp.net/k7m2xqa?f=api"
}

status is available, taken or unknown. price is the public price in US dollars, and buy_url opens a registrar with the name ready to register. Reading a result explains every field.

3. Add it to your assistant

Add this address as a custom connector in Claude, ChatGPT, Gemini, Cursor or any MCP client, then ask about domains in plain words.

Each assistant has its own one-minute walkthrough: Claude, ChatGPT, Gemini, Claude Code, Cursor, VS Code, Windsurf.

From code

import requests

r = requests.get("https://api.domainmcp.net/v1/search", params={"name": "brightfield"})
for d in r.json()["data"]:
    print(d["domain"], d["status"], (d.get("price") or {}).get("first_year"))

const r = await fetch("https://api.domainmcp.net/v1/search?name=brightfield");
const { data } = await r.json();
for (const d of data) console.log(d.domain, d.status, d.price?.first_year);