Tool · Domains
list_domains
List the caller's registered domains with expiry dates, optionally filtered by name, 100 per page.
Read-onlyIdempotentscope read:domains
Invoked over the MCP transport with a tools/call request naming this tool.
Authorization #
Requires a valid OAuth 2.1 bearer access_token whose grant includes the read:domains scope — View your registered domains and their details. The broker resolves the caller from the token and returns only records the account owns.
Parameters #
searchstringOptional
Optional case-insensitive substring of the domain name, e.g. "example" or ".bg". Omit to list every domain.
limitintegerOptional
Maximum domains to return. Capped at 100; omit for 100.
offsetintegerOptional
Number of matching domains to skip, for the next page. Use the previous offset + limit when "truncated" is true.
Response #
200 · application/json
domainsarray<object>
idinteger
domain_namestring
statusstring
One of: Active Expired Pending Pending Registration Pending Transfer Transferred Away Cancelled Grace Fraud
expiry_datestring · null
recurring_amountobject
valuestring
currencystring
first_payment_amountobject
valuestring
currencystring
totalinteger
offsetinteger
limitinteger
truncatedboolean