Developer docs

Start here

Three ways to connect, same registrar underneath.

• If your agent speaks MCP (Claude tooling and most modern agent frameworks), use the MCP server. It is the most native option.
• If you want plain HTTP from any language, use the REST API.
• If you are in ChatGPT, add the connector and just ask in chat.

What you need: an AIvikings account, an API key for REST, or an MCP-compatible client that can complete OAuth authorization.

MCP server

AIvikings exposes domain operations as native MCP tools, so any MCP-compatible agent can check availability, register, and manage domains as part of a task. No custom integration code, the tools appear in your agent's tool list.

Endpoint

https://mcp.aivikings.ai/mcp

Discovery

AIvikings publishes a small MCP discovery file so clients, directories, and crawlers can find the server endpoint and tool list without scraping this page.

https://aivikings.ai/.well-known/mcp.json

Auth

The MCP server is protected by OAuth 2.1 with Dynamic Client Registration. Capability discovery, including initialize and tools/list, is available without a token. Calling any tool requires a valid bearer access token obtained through the OAuth flow.

Discovery metadata is published at:

https://mcp.aivikings.ai/.well-known/oauth-protected-resource
https://api.aivikings.ai/.well-known/oauth-authorization-server

Authorization server: https://api.aivikings.ai

Scopes: domains:read, domains:register, domains:renew, dns:write, billing:read, billing:write, domains:transfer, audit:read, api_keys:write, contacts:write

MCP-compatible clients such as the ChatGPT connector, Claude, and the MCP Inspector perform this handshake automatically. You point the client at the MCP endpoint and authorize access when prompted.

Available tools

AIvikings exposes 31 MCP tools across account identity, availability and pricing, registration lifecycle, transfers and locks, nameservers and DNS, and contacts and registrant workflows. This page keeps the list compact. For parameters, return values, examples, and risk notes, read the AIvikings MCP tools reference.

Account and identity

get_current_user

Return the account tied to the current token.

get_customer

Fetch the customer record for the current token.

create_customer

Create a new customer, without issuing an API key.

get_prepaid_balance

Return prepaid wallet balances for domain purchases.

reconcile_provider_client

Link or create the registrar client account for this customer.

Availability and pricing

check_single_domain_availability

Check availability and price for one domain.

check_domain_availability

Check availability for up to 200 domains at once.

get_domain_pricing

Get a full price schedule for one domain.

Registration and lifecycle

register_domain

Register a domain for a number of years. Spends credit.

renew_domain

Renew a domain for a number of years. Spends credit.

get_domain_status

Get registration status and nameservers for one domain.

list_domains

List domains in the local registrar datastore.

reconcile_domains

Compare local domain records with the configured registrar provider records.

Transfers and locks

domain_transfer

Transfer a domain in to AIvikings. Spends credit.

get_transfer_auth_code

Return the EPP transfer auth code for a domain you own.

regenerate_transfer_auth_code

Generate a new auth code, invalidating the old one.

lock_domain

Enable the registrar transfer lock.

unlock_domain

Disable the registrar transfer lock.

Nameservers and DNS

update_nameservers

Replace a domain's nameservers.

list_dns_records

List the managed DNS records for a domain.

configure_dns_record

Set the A record for a domain or subdomain.

add_dns_record

Add a managed DNS record (A, AAAA, CNAME, MX, TXT, NS, SRV).

update_dns_record

Replace an existing managed DNS record.

delete_dns_record

Permanently delete a managed DNS record.

Contacts and registrant

create_contact

Create a reusable contact for registrations.

list_contacts

List reusable contacts for the account.

get_contact

Get one reusable contact by its handle.

list_domain_registration_contacts

List contacts usable for registration, with readiness.

assign_domain_registration_contact_roles

Assign default registration roles to one contact.

remove_domain_registration_contact_roles

Remove default registration roles from one contact.

update_registrant_contact

Update the registrant contact for a domain.

For implementation details, see the full MCP tools reference. For setup walkthroughs, see the ChatGPT guide and Claude guide.

Available TLDs

TLD availability depends on your account and the current AIvikings catalog. The examples on this page use .icu for clarity. Check the prices page for supported TLDs and current register, renew, and transfer prices.

Connecting

Point your MCP client at the endpoint above. The client discovers the OAuth metadata, registers dynamically, obtains a token, and then calls tools with that token. The tools then appear automatically and your agent can call them. For the full list of tools, parameters, return values, and examples, use the AIvikings MCP tools reference.

Example MCP request

Most MCP clients handle JSON-RPC for you. For a low-level connectivity check, list the available tools.

curl https://mcp.aivikings.ai/mcp \
  -H "Content-Type: application/json" \
  -d '{
    "jsonrpc": "2.0",
    "id": 1,
    "method": "tools/list",
    "params": {}
  }'

REST API

A standard HTTPS REST API with API-key auth. Use it from any language.

Base URL

https://api.aivikings.ai/v1

Auth

Pass your API key in the Authorization header: Authorization: Bearer YOUR_KEY

Core endpoints

• POST /domains/check - check availability
• POST /domains - register a domain
• GET /domains/{domain} - get current domain status
• GET /domains - list your domains
• POST /domains/{domain}/renew - renew
• PUT /domains/{domain}/nameservers - replace nameservers
• GET /health - service health and current environment

Example request

curl https://api.aivikings.ai/v1/domains/check \
  -H "Authorization: Bearer YOUR_KEY" \
  -H "Content-Type: application/json" \
  -d '{"domains":["my-agent-7f3.icu"]}'

Example response

{
  "domains": [
    {
      "domain": "my-agent-7f3.icu",
      "available": true,
      "long_domain": true
    }
  ]
}

Examples shown for illustration. Use the MCP get_domain_pricing tool or the live prices page for current price quotes.

ChatGPT connector

Add AIvikings as a connector in ChatGPT and run domain registration flows by asking in plain language. No code. Useful for non-developers and for quick one-off registrations.

How to use

1. In ChatGPT, add the AIvikings connector and authorize it with your account.
2. Ask in chat: "Find and register a domain for my project."
3. ChatGPT checks availability through AIvikings and runs the registration flow for you.