Checkout and renewal

Checkout tools let an agent prepare a request. An MCP call never charges a payment method, sends crypto, registers a domain, or renews a domain.

Register domains

create_domain_checkout accepts one or more proposed registrations and returns a short-lived approval URL.

Scope: checkout.create

{
  "items": [
    {
      "domain": "example.com",
      "years": 2,
      "autoRenew": true,
      "whoisPrivacy": true
    }
  ]
}

The tool stores requested options, not trusted prices. The approval URL expires after 30 minutes and is bound to the signed-in DID and requesting client.

Renew a domain

create_domain_renewal_checkout prepares renewal for one domain owned by the signed-in user.

Scopes: domains.renew and checkout.create

{
  "domain": "example.com",
  "years": 1
}

Renewals are owner-only. Marque validates the TLD’s supported renewal period before creating the request and validates it again during checkout.

User approval

The agent should present the returned approvalUrl to the user. Opening it requires Marque sign-in, then imports the request into the normal cart.

Before confirmation, the user can:

• review, edit, or remove requested items;
• select registrant information;
• choose card or supported crypto payment;
• decline the request without paying.

Marque recalculates availability, current prices, premium status, period limits, tax, contact requirements, and payment details immediately before payment.

Track status

get_domain_checkout reports the approval, payment, and provisioning state.

Scope: checkout.create

{
  "checkoutId": "checkout-request-id"
}

Possible states are:

• pending_approval
• declined
• expired
• payment_pending
• provisioning
• completed
• failed

Do not claim a registration or renewal succeeded until the status is completed.