check_availability
Check whether domain names are registered, asking each TLD's registry directly (RDAP). Returns registered, available, likely available (no registry lookup service, but no DNS records either) or unknown, plus the registrar and dates for taken names and the cheapest prices for open ones. Up to 20 names per call. A lookup is not a reservation: names can be taken at any moment, and premium or reserved names may still be priced higher or blocked at checkout.
Показать схему аргументов
{
"type": "object",
"required": [
"domains"
],
"properties": {
"domains": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 20,
"minItems": 1,
"description": "Domain names, like \"example.com\" or \"münchen.de\""
}
}
}
compare_prices
Every tracked registrar's price for one TLD, in US dollars per year, refreshed daily from 40+ registrars. Sorted by 3-year cost (first year plus two renewals) by default, because a cheap first year often hides an expensive renewal. Each offer links to where to buy.
Показать схему аргументов
{
"type": "object",
"required": [
"tld"
],
"properties": {
"tld": {
"type": "string",
"description": "A TLD (\"ai\", \".co.uk\") or a domain to take it from (\"example.ai\")"
},
"sort": {
"enum": [
"three_year",
"registration",
"renewal",
"transfer"
],
"type": "string",
"default": "three_year"
},
"limit": {
"type": "integer",
"default": 10,
"maximum": 60,
"minimum": 1
}
}
}
suggest_names
Turn a few keywords into domain name candidates (the words joined, with common prefixes and suffixes, across several TLDs), check each with its registry, and return the available ones with prices. For your own name ideas, use check availability.
Показать схему аргументов
{
"type": "object",
"required": [
"keywords"
],
"properties": {
"tlds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 6,
"description": "TLDs to try, first one preferred. Default: com, ai, io, dev, app, co"
},
"limit": {
"type": "integer",
"default": 15,
"maximum": 20,
"minimum": 1,
"description": "How many candidates to check"
},
"keywords": {
"type": "string",
"description": "A few words about the project, like \"coffee map\""
}
}
}
tld_info
Who runs a TLD, its type (generic, country-code, ...), when it was delegated, its registry's website and lookup servers (from IANA), and its cheapest first-year, renewal and 3-year prices.
Показать схему аргументов
{
"type": "object",
"required": [
"tld"
],
"properties": {
"tld": {
"type": "string",
"description": "A TLD (\"ai\", \".co.uk\") or a domain to take it from (\"example.ai\")"
}
}
}
price_history
Every recorded price change for one TLD, oldest first, from GoMain's daily archive. A registrar's first entry is its price when the archive began (or when it started selling the TLD); later entries are changes. Prices are per year, in US dollars unless currency says otherwise.
Показать схему аргументов
{
"type": "object",
"required": [
"tld"
],
"properties": {
"tld": {
"type": "string",
"description": "A TLD (\"ai\", \".co.uk\") or a domain to take it from (\"example.ai\")"
},
"registrar": {
"type": "string",
"description": "Only this registrar's changes, by id (\"porkbun\")"
}
}
}
check_name
Is a project name usable everywhere it'll be needed? Checks the domain across TLDs (with prices), GitHub, npm, PyPI and crates.io, and gives links for trademark and social-handle checks that can't be automated.
Показать схему аргументов
{
"type": "object",
"required": [
"name"
],
"properties": {
"name": {
"type": "string",
"description": "The name, like \"tidepool\""
},
"tlds": {
"type": "array",
"items": {
"type": "string"
},
"maxItems": 6,
"description": "TLDs to check. Default: com, ai, io, dev, app, co"
}
}
}
dns_setup
The exact DNS records to add so a domain serves a website (Vercel, Netlify, GitHub Pages, Cloudflare Pages) and receives email (Google Workspace, Microsoft 365, Fastmail, Zoho, Proton), plus a starting DMARC policy. Checks live DNS to show which records are already in place and warns about clashes such as two SPF records. Values a provider generates per account are marked as such.
Показать схему аргументов
{
"type": "object",
"required": [
"domain"
],
"properties": {
"email": {
"enum": [
"google-workspace",
"microsoft-365",
"fastmail",
"zoho",
"proton"
],
"type": "string"
},
"domain": {
"type": "string"
},
"account": {
"type": "string",
"description": "GitHub user, Netlify site or Cloudflare Pages project name, when the website host needs one"
},
"website": {
"enum": [
"vercel",
"netlify",
"github-pages",
"cloudflare-pages"
],
"type": "string"
}
}
}
appraise_domain
A rough value range for a domain, from its length, how easy it is to say, its TLD, its age and how many popular TLDs have the same name registered. Use it to set a realistic budget before trying to buy a taken name. Not a comparable-sales appraisal.
Показать схему аргументов
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
}
}
acquisition_report
For a domain someone already owns: whether it's listed for sale and where (with the asking price when the sale page shows one), when it could drop, its estimated value, the realistic chance of buying it, the options in order (buy now, make an offer, backorder, have GoMain broker it, watch it) and available alternatives with prices.
Показать схему аргументов
{
"type": "object",
"required": [
"domain"
],
"properties": {
"domain": {
"type": "string"
}
}
}
request_acquisition
Ask GoMain's brokerage to acquire a domain someone else owns. GoMain researches it, approaches the owner without naming the buyer, negotiates within the budget (which the owner never sees), and closes through Escrow.com. Confirm the buyer's email and budget with the user before calling. Returns a deal id and status key for broker status.
Показать схему аргументов
{
"type": "object",
"required": [
"domain",
"max_budget",
"email"
],
"properties": {
"email": {
"type": "string",
"description": "The buyer's email, for progress reports and the escrow invitation"
},
"notes": {
"type": "string",
"description": "Anything the broker should know, like a deadline"
},
"domain": {
"type": "string"
},
"max_budget": {
"type": "integer",
"minimum": 1,
"description": "The most the buyer will pay, in US dollars"
}
}
}
search_domains_for_sale
Search domains their owners have listed for sale with GoMain (each owner proved control of the name). Returns asking prices where set; make offer buys or negotiates.
Показать схему аргументов
{
"type": "object",
"properties": {
"keywords": {
"type": "string",
"description": "Words the name should contain; empty lists everything"
},
"max_price": {
"type": "integer",
"minimum": 1
}
}
}
make_offer
Offer to buy a domain listed with GoMain. Offers at or above the asking price buy it outright; lower offers are negotiated automatically with a counter-offer, for up to three rounds, then the seller decides. An accepted offer opens an Escrow.com transaction, so the money is only released once the domain arrives. Confirm the amount and email with the user before calling; to answer a counter-offer, pass the deal id and status key from the last answer.
Показать схему аргументов
{
"type": "object",
"required": [
"domain",
"amount",
"email"
],
"properties": {
"email": {
"type": "string",
"description": "The buyer's email"
},
"amount": {
"type": "integer",
"minimum": 1,
"description": "US dollars"
},
"domain": {
"type": "string"
},
"deal_id": {
"type": "string"
},
"status_key": {
"type": "string"
}
}
}
list_domain_for_sale
List a domain the user owns for sale. The first call returns a DNS TXT record that proves ownership; once it's added, calling again with the same domain and email activates the listing. asking price is shown to buyers; floor price, the lowest offer accepted automatically, never is. Sales close through Escrow.com.
Показать схему аргументов
{
"type": "object",
"required": [
"domain",
"email"
],
"properties": {
"email": {
"type": "string",
"description": "The owner's email"
},
"domain": {
"type": "string"
},
"withdraw": {
"type": "boolean"
},
"floor_price": {
"type": "integer",
"minimum": 1
},
"listing_key": {
"type": "string",
"description": "Needed to change an active listing"
},
"asking_price": {
"type": "integer",
"minimum": 1
}
}
}
watch_domain
GoMain checks a domain daily and emails when it drops (or is about to), changes hands, or is listed for sale. Returns a watch id and status key for broker status.
Показать схему аргументов
{
"type": "object",
"required": [
"domain",
"email"
],
"properties": {
"email": {
"type": "string"
},
"domain": {
"type": "string"
}
}
}
broker_status
The status and history of a brokerage deal (id d …) or a watch (id w …), given the id and status key returned when it was created.
Показать схему аргументов
{
"type": "object",
"required": [
"id",
"status_key"
],
"properties": {
"id": {
"type": "string"
},
"status_key": {
"type": "string"
}
}
}