When to Use

Use InstaDomain tools when you need to domain registration for ai agents. check availability, get suggestions, buy domains via stripe or usdc crypto, manage dns, renewals, and transfers. 9 mcp tools for the full domain lifecycle.. All tools are available through xpay✦'s single MCP connection.

MCP Connection

{
  "mcpServers": {
    "xpay": {
      "url": "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"
    }
  }
}

For Claude Code:

claude mcp add --transport http xpay "https://mcp.xpay.sh/mcp?key=YOUR_API_KEY"

Available Tools

• Check Domain — Check if a domain is available for purchase and get its price.

Always call this before buy_domain. Show the user the price_display value (e.g. "$18.12") and confirm they want to proceed before buying.

Args: domain: The full domain name to check (e.g. "coolstartup.com").

Returns: Dict with availability status, price in cents, and formatted price. If available, includes price_cents and price_display for the 1-year registration cost. — $0.02/call — SKILL.md

• Buy Domain — Start the purchase flow for an available domain via Stripe checkout.

IMPORTANT: Before calling this tool, you MUST first call check_domain to get the price, then clearly show the user the price and get their explicit confirmation before proceeding. Never call buy_domain without the user seeing and approving the price first.

The registrant contact details are required because the domain will be registered in the buyer's name (they become the legal owner). WHOIS privacy is enabled by default, so these details are not publicly visible.

Creates a Stripe checkout session. Returns a checkout URL that the user should open in their browser to complete payment securely via Stripe, plus the order ID for tracking.

Args: domain: The domain to purchase (e.g. "coolstartup.com"). first_name: Registrant's first name. last_name: Registrant's last name. email: Registrant's email address. address1: Registrant's street address. city: Registrant's city. state: Registrant's state or province. postal_code: Registrant's postal/zip code. country: 2-letter ISO country code (e.g. "US", "GB", "DE"). phone: Phone number in format +1.5551234567. org_name: Organization name (optional, leave empty for individuals).

Returns: Dict with order_id, checkout_url, price_cents, and price_display. — $0.02/call — SKILL.md

• Buy Domain Crypto — Start the purchase flow for a domain using USDC crypto payment (x402 protocol).

This is a 2-step process for autonomous agent payments:

Step 1: Call this tool to get an order_id and pay_url. Step 2: Make an HTTP GET request to the pay_url. Your x402-enabled HTTP client will receive an HTTP 402 response with payment requirements, then automatically pay with USDC on Base. The payment and settlement happen via the x402 protocol (no browser or human needed).

After payment, call get_domain_status(order_id) to poll until complete.

Requires: An x402-compatible HTTP client with a funded USDC wallet on Base.

The registrant contact details are required because the domain will be registered in the buyer's name (they become the legal owner). WHOIS privacy is enabled by default, so these details are not publicly visible.

IMPORTANT: Before calling this tool, you MUST first call check_domain to get the price and confirm it with the user.

Args: domain: The domain to purchase (e.g. "coolstartup.com"). first_name: Registrant's first name. last_name: Registrant's last name. email: Registrant's email address. address1: Registrant's street address. city: Registrant's city. state: Registrant's state or province. postal_code: Registrant's postal/zip code. country: 2-letter ISO country code (e.g. "US", "GB", "DE"). phone: Phone number in format +1.5551234567. org_name: Organization name (optional, leave empty for individuals).

Returns: Dict with order_id, pay_url (full URL to GET with x402 client), price_usdc, price_cents, network, and asset contract address. — $0.02/call — SKILL.md

• Get Domain Status — Get the status of a domain purchase order.

Polls the backend every 3 seconds (up to 120 seconds) until the order reaches a terminal state (complete or failed). Returns the final order status including nameservers and DNS token if available.

Args: order_id: The order ID returned from buy_domain (e.g. "ord_abc123").

Returns: Dict with order status, domain, nameservers, and CF DNS token if complete. — $0.02/call — SKILL.md

• Get Transfer Code — Get the EPP/transfer authorization code for a completed domain purchase.

Use this when the domain owner wants to transfer their domain to another registrar. The order must be in "complete" status. The auth code is required by the receiving registrar to authorize the transfer.

Args: order_id: The order ID of a completed domain purchase.

Returns: Dict with order_id, domain, and auth_code. — $0.02/call — SKILL.md

• Unlock Domain — Remove the registrar transfer lock from a completed domain purchase.

Domains are locked by default to prevent unauthorized transfers. Call this before initiating a transfer to another registrar. The order must be in "complete" status.

Args: order_id: The order ID of a completed domain purchase.

Returns: Dict with order_id, domain, and unlocked status. — $0.02/call — SKILL.md

• Renew Domain — Renew a domain for 1 additional year.

Creates a Stripe checkout session for the renewal payment. The user must open the checkout URL to complete payment, after which the domain will be renewed automatically via the registrar.

The order must be in "complete" status (i.e., the domain was previously registered successfully).

Args: order_id: The order ID of a completed domain purchase (e.g. "ord_abc123").

Returns: Dict with order_id, checkout_url, price_cents, price_display, domain, and renewal_years. — $0.02/call — SKILL.md

• Check Domains Bulk — Check availability of up to 50 domain names in one call.

Uses fast RDAP lookups (no pricing). Returns a summary with total/available/taken counts plus per-domain details and affiliate registration links for available domains.

Args: domains: List of domain names to check (max 50). — $0.02/call — SKILL.md

• Suggest Domains — Generate domain name ideas from a keyword and check their availability.

Uses common prefix/suffix patterns to generate 10-15 domain candidates across .com, .io, .ai, .dev, .co and checks all of them via fast RDAP lookups. Returns available domains with affiliate registration links.

Args: keyword: A keyword or short business name (e.g. "taskflow"). — $0.02/call — SKILL.md

How to Execute

1. xpay_discover — Search for tools: xpay_discover("instadomain")
2. xpay_details — Get input schema: xpay_details("instadomain/TOOL_NAME")
3. xpay_run — Execute: xpay_run("instadomain/TOOL_NAME", { ...inputs })
4. xpay_balance — Check credits

Links

• Provider page: https://xpay.tools/instadomain/
• All providers: https://xpay.tools/explore
• Docs: https://docs.xpay.sh