Name: tld-info
Price: 0.005 USDC
Availability: InStock

$ man tld-info

agentutility / web-probe / tld-info

PRICE / CALL

$0.005

USDC · base mainnet · scheme: exact

METHOD

POST

CLUSTER

webprobe

CATEGORY

uncategorized

STATUS

● live

NAME

tld-info — returns registry info for any top-level domain: registry operator, type (gtld / cctld / stld), country (for cctlds), introduction year, a…

SYNOPSIS

POST https://x402.agentutility.ai/tld-info
     Content-Type: application/json
     X-PAYMENT:    <signed-transferWithAuthorization>

     { ... }

↳ first call → 402 Payment Required. Sign USDCtransferWithAuthorization, retry with theX-PAYMENT header.

DESCRIPTION

Returns registry info for any top-level domain: registry operator, type (gTLD / ccTLD / sTLD), country (for ccTLDs), introduction year, and notes. In-handler dictionary covers ~80 of the most common TLDs; falls back to a structural guess for unrecognized TLDs. Use it as a TLD registry lookup, ccTLD-vs-gTLD check, TLD introduction year lookup, or new gTLD registry reference.

INPUT — request schema

property	type	description	req?
tld	string	TLD without leading dot (e.g. 'ai', 'com', 'co.uk' uses just 'uk').	required

OUTPUT — response shape

field	type	description
tld	string	Top-level domain looked up, normalized to lowercase with leading dot (e.g. .com, .uk, .xyz).
is_valid	string	Whether the TLD string parsed as a syntactically valid top-level domain label.
type	string	TLD category: gTLD, ccTLD, sTLD, or new-gTLD.
registry	string	Operator running the TLD registry (e.g. Verisign for .com, Nominet for .uk).
country	string	Country or territory the TLD belongs to, for ccTLDs; null or empty for gTLDs.
intro_year	string	Year the TLD was introduced into the root zone.
notes	string	Short free-text notes on the TLD's usage, restrictions, or notable history.
in_dictionary	string	True if the TLD was found in the in-handler dictionary; false if answered via structural fallback.
source	string	Origin of the answer: dictionary lookup or structural guess from the TLD shape.

EXAMPLES — two ways to call

EXAMPLE 1 · curl

curl -X POST https://x402.agentutility.ai/tld-info \
  -H 'Content-Type: application/json' \
  -d '{ }'

first response = 402 Payment Required with payment requirements; sign + retry with X-PAYMENT.

EXAMPLE 2 · mcp

# Install the MCP package for this endpoint's cluster
npx -y @agentutility/mcp-<cluster>

# Required: EVM private key with USDC on Base
export X402_PRIVATE_KEY=0x...

# Then call the tld-info tool from your MCP-aware agent.

MCP server handles payment automatically — your coding agent just calls the tool by name.

METADATA

tags: web-probedomaintldregistry-lookupcctldgtldtld-info
methods: POST
cluster: webprobe
price: $0.005 USDC per call

ADJACENT — other endpoints in webprobe

endpoint	description	price
arxiv-bibtex	Turns an arXiv paper into a BibTeX entry: pulls title, authors, year, abstract, and DOI from the arXiv API and generates a properly-forma…	$0.005
brand-name-score	Scores a candidate brand or startup name on quality and risk.	$0.005
company-name-score	Scores the quality of a company name before you commit to domain, handle, trademark, and launch work.	$0.005
crypto-headlines	Searches recent bitcoin, ethereum, and DeFi headlines via GDELT with a GNews fallback when configured, returning headline URLs, domains,…	$0.005
crypto-news	Fetches recent cryptocurrency news headlines from GDELT with a GNews fallback when configured, filtered by crypto topic or caller query,…	$0.005
disposable-email-check	Detects disposable and throwaway email addresses before they get through your signup form.	$0.005
domain-availability	Checks whether a domain is registered and returns registrar, registration date, expiry date, days_until_expiry, and current EPP status flags.	$0.005
email	Validates an email address end to end: syntax, MX reachability, disposable/temp-mail domains, role accounts, and SPF/DMARC/DKIM posture.	$0.005