Tool reference | WantDot

WantDot’s MCP server has 13 tools. They are grouped by who uses them. Every tool returns readable text and a structured result; a failure has isError: true and a short, plain reason.

Anyone

`check_domain`

Check who has a domain and how hard it would be to get. Returns whether it is available, listed for sale, parked, in use, dormant or unclear; the likely owner type; registration dates; whether it accepts email (so mail meant for you could reach the owner); any _for-sale DNS record with an asking price; its WantDot page, and whether a verified owner there is open to offers or selling (with a public asking price if they set one); and the next step. Read-only, uses public data (registry RDAP, DNS, one homepage request), and does not contact the owner. Use it when someone wants a domain that may be taken.

Read-only. Safe to repeat.

Parameter	Type	Required	What it is
`domain`	string	yes	The domain to check, e.g. flowly.com. URLs are accepted.

`suggest_alternatives`

Find available domains close to one that’s taken. Checks your own name ideas (pass up to 15 in candidates; brainstorm them from what the person is building) plus standard patterns (getX.com, tryX.com, Xhq.com, Xapp.com, and the same name on .co/.io/.ai/.app), and returns only the ones the registry confirms nobody owns. Read-only: it registers nothing. Use it after check_domain says a name is taken or hard to get.

Read-only. Safe to repeat.

Parameter	Type	Required	What it is
`domain`	string	yes	The domain the person wanted, e.g. flowly.com.
`candidates`	list of string	no	Your own domain ideas to check, e.g. [“flowlyhq.com”, “goflowly.com”]. Full domains, not bare words.

`watch_domain`

Email the person when a domain is claimed by its owner, listed for sale, changes price, or nears expiry. Sends a confirmation email to the address you give; nothing is watched until the person clicks it, and every email has a stop link. Use only the person’s own email address, with their permission.

Changes something. Safe to repeat.

Parameter	Type	Required	What it is
`domain`	string	yes	The domain to watch, e.g. flowly.com.
`email`	string	yes	The person’s own email address. They get one confirmation email.
`max_usd`	integer	no	Optional private maximum the person would pay, in whole US dollars. Never shown to the owner. If the owner’s price is at or below it, the owner gets an offer on the person’s behalf (halfway between, or the owner’s public price). Only with the person’s say-so; it takes effect when they confirm by email, and can change once a week.

`make_offer`

Make an offer on a domain whose verified WantDot owner is open to offers or selling (check_domain says so). Sends the person a confirmation email; the owner hears nothing until the person presses the button there, and neither side ever sees the other’s email address. By confirming, the person agrees that: An offer isn’t binding: a deal only happens through Escrow.com. If a deal closes, the owner pays WantDot 5% of the price; you pay Escrow.com’s fee and nothing to WantDot. Paying needs a free Escrow.com account with an ID check. If it closes, the price and timeline may appear in WantDot’s public deal ledger, without names. Use only the person’s own email address and an amount they chose.

Changes something.

Parameter	Type	Required	What it is
`domain`	string	yes	The domain, e.g. flowly.com.
`amount_usd`	integer	yes	The offer in whole US dollars, as the person chose it.
`email`	string	yes	The person’s own email address, where they confirm the offer and get the owner’s answer.
`message`	string	no	Optional note to the owner. Links, emails and phone numbers are removed.
`set_up_escrow_account`	boolean	no	If the person wants it: once they confirm the offer, also create their free Escrow.com account with this email, so they can pay as soon as the owner agrees.

A buyer’s agent, with a mandate

`request_mandate`

For an AI agent buying a domain for a person. Asks that person, by email, to approve limits: the most you may offer per offer, how many new offers, optionally which domains, and for how long. Nothing works until they press Approve in the email. You get a mandate token now; use it with offer_with_mandate, list_my_offers, counter_offer and withdraw_offer once approved. A mandate lets you make offers, counter and withdraw. It can never accept a deal or pay: every agreement is the person’s own tap. Every message you send says it is from an AI agent. Use only the email of the person you act for, with their knowledge.

Changes something.

Parameter	Type	Required	What it is
`email`	string	yes	The email of the person you act for. They get one email to approve.
`max_usd`	integer	yes	The most you may offer or counter, in whole US dollars.
`domains`	list of string	no	Limit the mandate to these domains. Leave out for any domain.
`offers`	integer	no	How many new offers you may start. Default 3.
`days`	integer	no	How long it lasts. Default 7.
`label`	string	no	What to call yourself in the email, e.g. “Acme’s naming assistant”.

`offer_with_mandate`

Make an offer on a domain whose verified owner takes offers, inside your mandate’s limits. Goes straight to the owner, marked as sent by an AI agent. The person you act for is told by email. Counts as one of your allowed new offers. You cannot accept a deal or pay.

Changes something.

Parameter	Type	Required	What it is
`mandate_token`	string	yes	The mandate token from request_mandate. It works only after the person has approved it by email.
`domain`	string	yes	The domain, e.g. flowly.com.
`amount_usd`	integer	yes	The offer in whole US dollars, at most the mandate limit.
`message`	string	no	Optional note to the owner. Links, emails and phone numbers are removed.

`list_my_offers`

Your own offers under this mandate: where each stands, whose turn it is, what is on the table and the history of amounts. Read-only. Never includes the owner’s messages or anyone’s address. When it is your turn you may counter or withdraw; to accept a price, the person uses their own emailed link.

Read-only. Safe to repeat.

Parameter	Type	Required	What it is
`mandate_token`	string	yes	The mandate token from request_mandate. It works only after the person has approved it by email.
`limit`	integer	no	How many offers, newest first. Default 20.

`counter_offer`

Counter on one of your own offers when it is your turn, at most the mandate limit. Marked as sent by an AI agent. You may counter a limited number of times per offer; after that the person decides. You cannot accept a price: that is the person’s own tap.

Changes something.

Parameter	Type	Required	What it is
`mandate_token`	string	yes	The mandate token from request_mandate. It works only after the person has approved it by email.
`offer_id`	string	yes	The offer id from list_my_offers.
`amount_usd`	integer	yes	Your counteroffer in whole US dollars.
`message`	string	no	Optional note. Links, emails and phone numbers are removed.

`withdraw_offer`

Withdraw one of your own offers, on either side’s turn. The owner is told.

Changes something. Can undo or end something. Safe to repeat.

Parameter	Type	Required	What it is
`mandate_token`	string	yes	The mandate token from request_mandate. It works only after the person has approved it by email.
`offer_id`	string	yes	The offer id from list_my_offers.
`message`	string	no	Optional note.

An owner’s agent, with an agent token

`get_selling_rules`

For a domain owner’s own agent. Returns the owner’s asking price, the selling rules in force and what they mean in dollars, the templates available, and how fast offers on the domain get answered. Read-only. Needs the agent token the owner created.

Read-only. Safe to repeat.

Parameter	Type	Required	What it is
`token`	string	yes	The agent token the owner created at https://wantdot.com/claim/settings/ (Your selling agent, Connect your own agent). It works for one domain only.

`set_selling_rules`

For a domain owner’s own agent. Chooses how the owner’s WantDot selling agent answers offers on their domain: a template (starter = one fixed price, firm, default, flexible) or custom bands as fractions of the asking price. Modes: off; suggest (the owner approves each answer with one tap); auto (the agent sends counters and polite declines by itself, saying it is automated, and emails the owner). In every mode a yes always waits for the owner’s tap, and this token can never accept an offer. The domain needs a sale price set first. Rules lapse after expires_in_days (default 90).

Changes something. Safe to repeat.

Parameter	Type	Required	What it is
`token`	string	yes	The agent token the owner created at https://wantdot.com/claim/settings/ (Your selling agent, Connect your own agent). It works for one domain only.
`preset`	`starter` or `firm` or `default` or `flexible` or `custom`	yes	A template, or custom to supply custom_policy.
`mode`	`off` or `suggest` or `auto`	no	Defaults to suggest. Use auto only if the owner asked for the agent to answer for them.
`expires_in_days`	integer	no	How long the rules stay on. Default 90.
`custom_policy`	object	no	Only with preset custom.

`list_offers`

For a domain owner’s own agent. Lists recent offers on the domain with amount, status and whether one is waiting on the owner, with what the selling agent suggests, and what the agent did lately. Never includes a buyer’s address or message. Read-only. This token cannot answer or accept an offer: the owner does that on their own offer page.

Read-only. Safe to repeat.

Parameter	Type	Required	What it is
`token`	string	yes	The agent token the owner created at https://wantdot.com/claim/settings/ (Your selling agent, Connect your own agent). It works for one domain only.
`limit`	integer	no	How many offers, newest first. Default 20.

`set_listing`

For a domain owner’s own agent. Sets the domain’s sale status (not_for_sale, open to offers, or for_sale with a price) and whether the price is public. This changes the domain’s public WantDot page and emails anyone watching it, so use it only when the owner asked. It keeps the owner’s note and trade settings. The selling agent needs for_sale with a price. Needs the agent token the owner created.

Changes something. Safe to repeat.

Parameter	Type	Required	What it is
`token`	string	yes	The agent token the owner created at https://wantdot.com/claim/settings/ (Your selling agent, Connect your own agent). It works for one domain only.
`sale_status`	`not_for_sale` or `open` or `for_sale`	yes	not_for_sale; open (takes offers, no price); for_sale (needs a price).
`price_usd`	integer	no	Whole US dollars. Needed for for_sale unless one is already set.
`price_public`	boolean	no	Show the price on the public page. Default: unchanged, private for a new price.
`note`	string	no	A note for buyers on the page. Leave out to keep the owner’s current note.