Conway Domains

Returns availability status and pricing (registration + renewal) for each TLD.

For exact domain checks, use `domain_check`:

``` domain_check(domains="myproject.com,myproject.io,myproject.ai") ```

Check Pricing

Get pricing for specific TLDs before purchasing:

``` domain_pricing(tlds="com,io,ai,xyz,dev") ```

Returns registration, renewal, and transfer costs per TLD.

Register a Domain

1. Check wallet balance: `wallet_info()` — ensure you have enough USDC on Base.
2. Search availability: `domain_search(query="mydomain")` or `domain_check(domains="mydomain.com")`.
3. Register: `domain_register(domain="mydomain.com", years=1, privacy=true)`.

The `domain_register` tool handles x402 payment automatically. WHOIS privacy is enabled by default.

``` wallet_info() # Check balance first domain_search(query="coolproject") # Find available options domain_register(domain="coolproject.dev", years=1, privacy=true) # Register ```

Renew a Domain

``` domain_renew(domain="mydomain.com", years=1) ```

Payment is handled automatically via x402. Check your wallet balance first if unsure.

Manage DNS Records

List records: ``` domain_dns_list(domain="mydomain.com") ```

Add a record: ``` domain_dns_add(domain="mydomain.com", type="A", host="@", value="1.2.3.4", ttl=3600) domain_dns_add(domain="mydomain.com", type="CNAME", host="www", value="mydomain.com", ttl=3600) domain_dns_add(domain="mydomain.com", type="MX", host="@", value="mail.example.com", ttl=3600, distance=10) domain_dns_add(domain="mydomain.com", type="TXT", host="@", value="v=spf1 include:_spf.google.com ~all") ```

Supported record types: A, AAAA, CNAME, MX, TXT, SRV, CAA, NS.

Update a record (use record_id from `domain_dns_list`): ``` domain_dns_update(domain="mydomain.com", record_id="abc123", value="5.6.7.8") ```

Delete a record: ``` domain_dns_delete(domain="mydomain.com", record_id="abc123") ```

Configure Domain Settings

WHOIS privacy: ``` domain_privacy(domain="mydomain.com", enabled=true) ```

Custom nameservers: ``` domain_nameservers(domain="mydomain.com", nameservers=["ns1.example.com", "ns2.example.com"]) ```

Point a Domain to a Conway Cloud Sandbox

Common pattern — register a domain and point it to a running sandbox:

1. Register: `domain_register(domain="myapp.dev")`
2. Get sandbox URL: use `sandbox_get_url` or `sandbox_expose_port` to get the sandbox's public URL.
3. Add DNS: `domain_dns_add(domain="myapp.dev", type="CNAME", host="@", value="{sandbox-url}")`

List & Inspect Your Domains

``` domain_list() # List all your registered domains domain_info(domain="mydomain.com") # Get details: status, expiry, nameservers, privacy ```

Wallet & Payments

• Check balance: `wallet_info(network="eip155:8453")` — wallet address and USDC balance on Base.
• Supported networks: `wallet_networks()` — list all supported payment networks.
• Discover endpoints: `x402_discover(url="https://conway.domains")\` — find available x402 API endpoints.
• Check payment requirements: `x402_check(url="https://api.conway.domains/domains/register")\` — see cost before paying.
• Manual fetch: `x402_fetch(url, method, headers, body)` — call any x402-protected endpoint with auto-payment.

MCP Tools Reference

Troubleshooting

Registration fails — insufficient funds

1. Check balance: `wallet_info()`.
2. Check domain price: `domain_pricing(tlds="com")` or `domain_check(domains="example.com")`.
3. Deposit USDC to your wallet address on Base network. The wallet address is shown in `wallet_info()` output.

Domain not resolving after DNS change

• DNS propagation takes time (minutes to hours depending on TTL).
• Verify records are set: `domain_dns_list(domain="mydomain.com")`.
• Check the TTL value — lower TTL means faster propagation.
• Ensure nameservers are correct: `domain_info(domain="mydomain.com")`.

x402 payment errors

1. Ensure wallet has USDC on Base (network `eip155:8453`): `wallet_info()`.
2. Check if the endpoint requires payment: `x402_check(url="...")`.
3. Try `x402_fetch` directly for manual control over the request.

Domain shows as unavailable

• The domain is already registered by someone else.
• Try alternative TLDs: `domain_search(query="myname", tlds="com,io,ai,dev,xyz,net,org")`.
• Check if it's a premium domain (higher price) vs truly unavailable.