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 API key (request one from the waiting list during early access) and an agent or script that can make requests.

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.0 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:write, offline_access

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

check_domain_availability

check if one or more domains can be registered, with price

register_domain

register an available domain

get_domain_status

get current status for a domain

list_domains

list domains owned by the account

renew_domain

renew an existing domain

update_nameservers

replace the nameservers for a domain

domain_transfer

transfer a domain in

reconcile_domains

compare local records with the registrar domain list

Early-access TLDs

TLD access is being opened in stages during early access. The examples on this page use .icu as a placeholder. Your API key determines which TLDs are available to your account.

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.

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 and price
• 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,
      "pricing": { "label": "low-priced", "period": "year" }
    }
  ]
}

Examples shown for illustration during early access. Full API reference ships with production access.

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.