With an API token, Claude Code can work with your Register.Domains account. You can ask it in plain language to:
- list your domains and show the details of one;
- tell you the status of an order;
- check whether a name is available and what it costs;
- quote a registration with your account's prices, discounts and taxes;
- register the domain with your saved payment method, only after you approve the domain, the years and the total.
That approval is asked for by Claude Code, not by the Register.Domains website: once you give it, the purchase is charged with no further confirmation. Don't give it without checking the domain, the years and the total, and don't turn on automatic approval.
The assistant never sees your password or your card numbers. For your domains it can see the owner's name, organization and country, but not their email, phone or address.
Before you start
- Claude Code installed. For now, this guide and our support cover only Claude Code; other assistants have not been tested.
- Access enabled for your account (step 1).
- Two-factor authentication turned on and a password on your account. If you only sign in with Google or another social login, set a password first.
- A saved card or wallet as your primary payment method. PayPal can't be used for purchases with the token.
1. Ask for access
- Open a ticket with Register.Domains support and ask for account API access.
- Wait for our reply: we'll let you know when the API Token page is available in your account.
2. Turn on two-factor authentication
- Sign in to register.domains and open Settings → Password & 2FA.
- Under 2-Factor Authentication, follow the steps with your authenticator app.
- When it's done, the section shows Enabled.
3. Create your token
-
Open Settings → API Token and click Generate.
-
Enter your password and the 6-digit code from your authenticator app.
-
Tick the box that accepts that purchases made with the token are charged to your saved payment method.
-
Click Generate.
-
Copy the token with the copy icon and keep it somewhere safe. It is shown only once.
-
Click Close. The page shows when the token was created, when it expires, when it was last used and your purchase limits.
Treat the token like a password: anyone who has it can see your account and buy domains with your saved payment method.
4. Connect Claude Code
-
Store the token in an environment variable named
RD_TOKEN.macOS / Linux: add this line to
~/.zshrcor~/.bashrcand open a new terminal:export RD_TOKEN='paste-your-token-here'Windows (PowerShell): run this once and open a new terminal:
setx RD_TOKEN "paste-your-token-here" -
Go to the folder where you use Claude Code and run (in PowerShell, type it all on one line and drop the
\):claude mcp add --transport http register-domains-account https://account.mcp.register.domains/claude/account/mcp \ --header 'X-API-Token: ${RD_TOKEN}'Keep the single quotes as shown: this way Claude Code stores
${RD_TOKEN}, not the token itself. -
Check the connection:
claude mcp get register-domains-accountIt should say
Status: ✔ Connectedand show the header as${RD_TOKEN}.
5. Try it
Open Claude Code in that folder and type, for example:
List my domains.When does mydomain.com expire?Show me the status of order 12345.Is lima-bakery.com available? How much is it?
Listing your domains charges nothing and confirms that the token works.
6. Register a domain
-
Ask for the domain:
I want to register lima-bakery.com for 1 year. -
Claude Code first shows you a quote: total with taxes, the card that would be charged, renewal, and until when the quote is valid. A quote charges nothing.
-
Check the domain, the years and the total. If they're right, confirm in writing (for example:
Yes, register it for USD 15.46). -
Claude Code asks your permission to use
confirm_registration. Allow it this one time only: this is the step that charges. This permission is asked for by Claude Code, not by the website; don't give it without checking the domain, the years and the total, and don't turn on automatic approval. -
You get the order number. A paid order goes through our review before it is sent to the registry.
If the quote expires (it lasts about 15 minutes), ask for a new one. If the price goes up before the purchase, nothing is charged: the assistant shows you the new total and you have to approve it again. Domains are registered with auto-renewal on; you can turn it off in your account. Registering with the token does not add Private Registration.
7. Renew, regenerate or revoke your token
-
Expiry: the token lasts 90 days. We email you before it expires.
-
Regenerate: on API Token, click Regenerate, enter your password and code, tick the acceptance box, click Regenerate and copy the new token. The old one stops working right away. Update
RD_TOKENand open a new terminal. -
Revoke: click Revoke and confirm. The token stops working right away.
The token is also revoked automatically if you turn off two-factor authentication, change or reset your password, change the account email, or link or unlink a social login.
Limits and security
- Purchase limits (Standard level): 3 orders and USD 100 every 24 hours, and USD 500 every 30 days. The API Token page shows your level and what you've used.
-
Approvals: don't choose "always allow" for
confirm_registrationand don't use modes that skip approvals. To use Claude Code only to look things up and get quotes, start it withclaude --disallowedTools "mcp__register-domains-account__confirm_registration". -
Where the token goes: only in the
RD_TOKENvariable or a password manager. Never paste it in the chat or commit it to a repository. - Purchases made by mistake: the same refund policy as on the website applies.
- If something looks wrong: revoke the token and contact us with the order number.
Troubleshooting
claude mcp list says Missing environment variables: RD_TOKEN. The variable isn't set in that terminal. Check step 4.1, open a new terminal and start Claude Code again.
The assistant says the token expired or was revoked. Create a new one on API Token (step 3 or Regenerate), update RD_TOKEN and open a new terminal.
The assistant says you reached a limit. It tells you which limit it is. If it tells you from when the purchase fits, wait until then; otherwise, buy on the website.
The card was declined. The order is cancelled and nothing is charged. Update your card in Billing → Payment Methods and ask for a new quote.
Your bank asks for authentication (3-D Secure). Use the link if the assistant shows one; otherwise, use the one in the email. Authenticate before the deadline shown (about two days); otherwise the order is cancelled with no charge.
The assistant says the order was placed but the payment result isn't known yet. The order exists and no second charge is attempted. Ask for the order status later.
The assistant says it doesn't know whether the order was placed. There may be no order. Before you retry, check your orders in your register.domains account. If you retry, ask it to confirm the same quote, not to make a new purchase: repeating the same quote never charges twice.